跳转到主要内容

概述

Sora 2 异步 API 采用标准的异步处理机制,适合需要更精细控制视频生成流程的场景。与同步流式 API 不同,异步 API 将视频生成分为三个独立步骤,让您可以更灵活地管理任务状态和下载时机。
异步 API 特别适合批量处理、后台任务、以及需要长时间等待的场景。如果您需要实时进度反馈,建议使用同步流式 API

核心特性

独立的任务管理

提交后获得任务 ID,可随时查询状态

灵活的轮询策略

自定义轮询间隔,避免不必要的请求

可靠的视频下载

生成完成后独立下载,支持断点续传

批量处理支持

同时提交多个任务,并发处理更高效

完整流程

异步 API 采用三步流程:
典型生成时间:3-5 分钟。建议轮询间隔设置为 30 秒,最长等待时间设置为 10 分钟。

模型定价

  • 推荐异步调用,各种错误而不计费;
  • 若同步调用,则支持流式输出查看进度;
  • 视频存储时效为 1 天,请及时转存或下载;
  • sora 2 普通版本的分辨率输出其实为 704 px(而非 720 px),是官方的实际表现;

端点地址

第一步:提交视频生成请求

请求参数

文生视频示例

图生视频示例

支持上传参考图片,生成基于图片的视频。

响应格式

第二步:轮询查询视频状态

提交请求后,需要定期轮询查询视频生成状态。

请求方式

查询示例

状态说明

生成中的响应示例

完成后的响应示例

第三步:下载生成的视频

视频生成完成后(statuscompleted),可以下载视频文件。

请求方式

下载示例

视频文件可能在一段时间后过期,建议生成完成后立即下载并保存到本地。

完整流程示例

以下是完整的三步流程集成示例:

最佳实践

Prompt 编写建议

好的 Prompt 应该包含:场景描述、主体动作、镜头风格、艺术风格。
优秀示例
不佳示例

参考图片建议

  • 分辨率:建议 1280x720 或更高
  • 格式:PNG 或 JPG
  • 文件大小:< 10MB
  • 内容:清晰、主体明确、光线良好
  • 匹配度:图片内容应与 prompt 描述相关

轮询策略建议

推荐设置

  • 轮询间隔:30 秒
  • 最长等待:10 分钟(600 秒)
  • 典型耗时:3-5 分钟

避免设置

  • 轮询间隔:< 30 秒(可能触发限流)
  • 最长等待:< 5 分钟(可能提前放弃)

错误重试策略

配额和限制

错误处理

常见错误码

常见问题

通常需要 3-5 分钟,具体时间取决于服务器负载和视频复杂度。建议设置轮询间隔为 30 秒,最长等待时间为 10 分钟。
  • 异步 API:三步流程(提交→轮询→下载),适合批量处理和后台任务,需要自己管理轮询逻辑
  • 同步 API:流式输出,实时返回进度,适合需要即时反馈的场景
详见:同步流式 API 文档
可以,支持最多 50 个并发任务(不够用可以联系技术客服加)。您可以同时提交多个请求,分别轮询它们的状态。注意不要超过请求速率限制(10 次/分钟)。
建议视频生成完成后立即下载,避免文件过期。具体保存时长请咨询技术支持。
检查响应中的错误信息,常见原因:
  • 内容违规(修改 prompt 或更换图片)
  • 配额不足(充值或升级套餐)
  • 参数错误(检查参数格式和值)
  • 服务器负载过高(稍后重试)
通过 size 参数控制:
  • 1280x720:横屏
  • 720x1280:竖屏

相关资源

同步流式 API

实时进度反馈,适合交互式应用

API 基础手册

了解 API 认证、请求格式等基础知识

常见问题 FAQ

查看更多常见问题解答