Sora 2 视频生成 异步调用 API 文档
输入“/”快速插入内容
🛎️Sora 2 视频生成 异步调用 API 文档
Sora 2 视频生成 异步调用 API 文档
用户4997用户49972月11日修改
2025年10月20日创建
4395
💌
说在前面：
26/1/28 新增：Sora 2 视频可用性说明 - APIYI
12/03 新增：视频风格、Storyboard 参数 Sora 2：StoryBoard 参数、视频风格 style 参数 更新上线
本站支持 sora-2 的异步调用，更稳定使用，且生成失败不会扣费（失败的任务会退款）：
•
可传模型 sora-2 或 sora-2-pro，而视频的分辨率（横竖屏）、时长放入到请求参数里
•
已验证新的示例代码，可靠使用，支持文生视频、图片生成视频。
两种调用模式对比
对比项 | 同步调用 | 异步调用 |
请求端点 | ||
请求体格式 | application/json | multipart/form-data |
图生视频 上传图片要求 | 配图公网图片地址 图片Url 或 Base64 | 本地图片文件（仅支持本地上传） @image.png 不需要转 base64 |
稳定性 | 可能因网络问题中断 • 流式输出，响应速度较快 首字超时建议 30s。完整视频 timeout 建议 600s • 非流式输出，timeout 建议 600s | 正常可用 |
超时处理 | 容易超时失败 | 不会超时，生成结果而查询 |
失败扣费 | 因内容安全问题失败但请求成功，于是会扣费 | 优势：因各种问题生成失败不扣费 |
进度查询 | 流式输出 可查看进度百分比，更适合对话场景 非流式输出 不可查询 | 可通过接口随时查询视频是否生成完成，百分比进度较弱（30%直接跳到了 100%） |
推荐指数 | ⭐⭐⭐⭐⭐ 图片上传 更灵活 | ⭐⭐⭐⭐⭐ 接入上复杂性高于同步调用 但收益好 |
一、文档说明
两个说明文件里的代码文件都在第二部分，可下载代码包
API 技术说明
请求体参数
参数 | 类型 | 必填 | 说明 | 示例 |
model | string | 是 | 模型名：当前支持 sora-2，也支持 sora-2-pro，不要填同步调用的 sora_video2 价格方面：sora-2 统一为 $0.12 sora-2-pro 统一为 $0.8 | sora-2 sora-2-pro |
prompt | string | 是 | 视频描述提示词 | 一只小猫在玩耍 |
input_reference | file | 图生视频时必填 ✨ | 仅支持 1 张图片。（sora官方限制） 本地图片文件（仅支持本地上传，不支持在线 url） 图片尺寸没有限制，建议和视频尺寸 size 相近 图片大小： < 5MB 图片格式： JPG, PNG, WebP | @image.png |
size | string | 否 | 视频尺寸，sora-2 支持 竖屏：720x1280 横屏：1280x720 sora-2-pro 还可以支持↓ 竖屏：1024x1792 横屏: 1792x1024 | 1280x720 或 720x1280 sora-2-pro 也支持↓ 1024x1792 或 1792x1024 |