Appearance
VEO 视频生成 API 参考 - 异步调用 VEO 3.1 异步调用接口的详细文档
异步调用说明： 适合批量处理场景，提交任务后通过轮询获取结果。如需实时交互，请使用同步调用方式。
创建视频任务
/v1/videos 创建异步视频生成任务
请求头
Copy Content-Type: application/json Authorization: sk-APIKEY
请求参数
prompt stringrequired 视频生成的文本描述
model stringrequired 模型名称。可选值： veo-3.1 - 竖屏标准版 veo-3.1-fl - 竖屏+帧转视频 veo-3.1-fast - 竖屏快速版 veo-3.1-fast-fl - 竖屏快速+帧转视频 veo-3.1-landscape - 横屏标准版 veo-3.1-landscape-fl - 横屏+帧转视频 veo-3.1-landscape-fast - 横屏快速版 veo-3.1-landscape-fast-fl - 横屏快速+帧转视频
请求示例
cURL
Python
JavaScript
Copy curl --location --request POST 'https://api.apiyi.com/v1/videos'
--header 'Authorization: sk-your-api-key'
--header 'Content-Type: application/json'
--data-raw '{ "prompt": "画小猫", "model": "veo-3.1" }'
响应示例 响应中的 id 字段即为视频任务 ID，后续用于查询任务状态和获取视频内容。
- 查询视频任务状态
/v1/videos/{video_id} 查询视频生成任务的当前状态
路径参数
video_id stringrequired 视频任务 ID（从创建接口返回）
请求头
Copy Authorization: sk-APIKEY
请求示例
cURL
Python
JavaScript
Copy curl --location --request GET 'https://api.apiyi.com/v1/videos/video_abc123'
--header 'Authorization: sk-your-api-key'
响应示例
状态说明 状态 说明 下一步操作 queued 任务排队中 继续轮询状态 processing 任务处理中 继续轮询状态 completed 生成完成 调用获取内容接口 failed 生成失败 检查错误信息 轮询建议： 建议每 5-10 秒轮询一次任务状态，直到状态变为 completed 或 failed。
- 获取视频内容
/v1/videos/{video_id}/content 获取已生成视频的实际内容
路径参数
video_id stringrequired 视频任务 ID
请求头
Copy Authorization: sk-APIKEY
请求示例
cURL
Python
JavaScript
Copy curl --location --request GET 'https://api.apiyi.com/v1/videos/video_abc123/content'
--header 'Authorization: sk-your-api-key'
响应示例 视频 URL 有效期通常为 24 小时，建议及时下载保存。
完整调用流程 1 创建任务
调用 POST /v1/videos 接口创建视频生成任务，获取 video_id 2 轮询状态
使用 GET /v1/videos/ 接口轮询任务状态，直到状态为 completed 3 获取视频
调用 GET /v1/videos//content 接口获取视频 URL 4 下载视频
从返回的 URL 下载视频文件并保存
错误处理
常见错误码 错误码 说明 解决方案 invalid_api_key API 密钥无效 检查 API 密钥是否正确 invalid_model 模型不存在 使用支持的模型名称 invalid_prompt 提示词无效 检查提示词长度和内容 video_not_found 视频任务不存在 检查 video_id 是否正确 video_not_ready 视频尚未生成完成 继续轮询任务状态 quota_exceeded 配额超限 联系客服增加配额
错误响应格式
Copy { "error": { "code": "invalid_api_key", "message": "Invalid API key provided", "type": "authentication_error" } }