比如: 以 0.2 倍率模型为例，充值 10.00 → 可用 $50.00，余额可用于所有模型。具体价格以网站实际展示为准。
Sora Turbo API 文档#
Sora Turbo 适合文本生成视频、图生视频、广告短片、分镜预览和创意视频制作。视频生成通常采用异步任务模式：先创建任务，再查询任务状态或通过回调接收结果。Base URL#
鉴权方式#
模型名称#
| 字段 | 值 |
|---|
| 模型名称 | sora-turbo |
| 接口类型 | 视频生成任务 API |
创建视频任务 API#
请求地址#
POST https://yesapi.online/v1/videos/generations请求参数#
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|
model | string | 是 | - | 固定值：sora-turbo |
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-turbo","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 和回调结果。
相关链接#
比如: 以 0.2 倍率模型为例，充值 10.00 → 可用 $50.00，余额可用于所有模型。具体价格以网站实际展示为准。
