Pika Videos Generation API 对接说明
内容提要
本文介绍Pika视频生成API的对接方法。用户需在Ace Data Cloud获取API Token，通过输入提示词、模型、参考图片或视频等参数生成视频。支持文生视频（模型1.5）和视频生视频（模型2.0），可设置特效、宽高比、回调URL等。提供异步回调功能，任务完成后通过Webhook通知结果。文中包含请求示例、返回字段说明及常见错误处理。
延伸解读
模型与任务类型匹配
使用该API时需注意模型与任务类型的对应关系：文生视频仅支持模型1.5，视频生视频仅支持模型2.0。若混用可能导致请求失败或结果不符合预期。此外，视频生视频模式下，特效仅限指定的五种，而图片模式则提供更多特效选项。开发者应根据实际需求选择合适的模型和特效，避免无效调用。
异步回调机制
由于视频生成耗时较长（约1-2分钟），API提供了异步回调功能。通过设置callback_url，任务完成后结果会以POST JSON形式发送至该URL，并包含task_id用于关联。若未设置callback_url，可设置async为true，接口立即返回task_id，再通过查询接口轮询结果。开发者需根据自身架构选择同步或异步方式，以优化资源利用。
错误码与排查
API返回的错误码可帮助快速定位问题：401表示token无效或缺失，429表示请求频率超限，400可能参数错误，500为服务器内部错误。例如，错误码token_mismatched提示参数缺失或无效。开发者应检查请求参数和token配置，并注意限流策略，避免频繁调用导致429错误。
Q&A
如何获取Pika视频生成API的Token？
需要到Ace Data Cloud控制台获取API Token。如果未登录或注册，会自动跳转到登录页面，注册登录后返回当前页面即可获取。一个API Token可以调用平台所有服务，首次申请会赠送免费额度。
Pika视频生成API支持哪些模型和功能？
目前支持文生视频（模型1.5）和视频生视频（模型2.0）。文生视频只支持1.5，视频生视频只支持2.0。功能包括生成视频、设置特效、宽高比、回调URL等。
如何调用Pika视频生成API生成视频？
通过POST请求到https://api.acedata.cloud/pika/videos，设置请求头（accept: application/json, authorization: Bearer {token}, content-type: application/json），请求体包含action（generate）、model、prompt等参数。例如文生视频：model为1.5，prompt为描述文本。
Pika视频生成API支持哪些特效？
文生视频支持多种图片特效，如Ta-da、Bald Me、Cake-ify等；视频生视频支持Pink Hair、Its Computer、Its Alive、Duplicate it、Wizard Cat等特效。
Pika视频生成API的异步回调是如何工作的？
在请求中设置callback_url，API会立即返回task_id。任务完成后，结果会通过POST JSON发送到callback_url，其中包含task_id，用于关联任务。
Pika视频生成API返回结果中的字段有哪些？
返回结果包含success、task_id、trace_id、data等字段。data中包括id、state、prompt、model、quality、video_url、image_url、duration等。
Pika视频生成API常见的错误代码有哪些？
常见错误包括：400 token_mismatched（参数缺失或无效）、400 api_not_implemented（参数问题）、401 invalid_token（无效token）、429 too_many_requests（请求过多）、500 api_error（服务器内部错误）。
