模型名称#
| 字段 | 值 |
|---|
| 模型名称 | sora-2 |
| 接口类型 | 视频生成任务 API |
创建视频任务 API#
请求地址#
POST https://yesapi.online/v1/videos/generations请求参数#
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|
model | string | 是 | - | 固定值：sora-2 |
prompt | string | 是 | - | 视频提示词，建议描述主体、镜头、动作、风格和光线 |
image_url | string | 否 | - | 图生视频输入图 URL |
duration | integer | 否 | 5 | 视频时长，单位秒 |
aspect_ratio | string | 否 | 16:9 | 画面比例，如 16:9、9:16、1:1 |
resolution | string | 否 | 720p | 输出分辨率 |
seed | integer | 否 | - | 随机种子 |
callback_url | string | 否 | - | 任务完成后的回调地址 |
请求示例#
查询任务 API#
请求地址#
GET https://yesapi.online/v1/videos/{task_id}任务状态#
| 状态 | 说明 |
|---|
queued | 任务已进入队列 |
processing | 正在生成视频 |
succeeded | 生成成功 |
failed | 生成失败，可查看错误原因 |
响应示例#
{"id":"video_task_example","object":"video.generation","model":"sora-2","status":"succeeded","video_url":"https://yesapi.online/v1/videos/cache/example.mp4","created":1784534400}
响应字段#
| 字段 | 类型 | 说明 |
|---|
id | string | 视频任务 ID |
status | string | 当前任务状态 |
video_url | string | 生成完成后的视频地址 |
error | object | 失败时的错误信息 |
回调通知格式#
{"task_id":"video_task_example","status":"succeeded","video_url":"https://yesapi.online/v1/videos/cache/example.mp4"}
Python SDK 示例#
Node.js SDK 示例#
错误码#
| 状态码 | 类型 | 排查建议 |
|---|
400 | 参数错误 | 检查提示词、比例、时长和图片 URL |
401 | 鉴权失败 | 检 查 API Key |
402 | 余额不足 | 检查账户余额 |
413 | 输入过大 | 压缩图片或改用 URL |
429 | 请求过快 | 降低并发 |
500 | 服务异常 | 重试并保留任务 ID |
最佳实践#
提示词建议包含镜头语言、主体动作、场景、光线和风格。
批量任务建议保存 task_id、业务 ID 和回调结果。
相关链接#
Modified at 2026-07-21 14:39:49
