MaiToken
登录/注册

Sora 2 视频生成

OpenAI Videos 原生协议:提交任务、轮询状态、下载视频

POST/v1/videos

Sora 系列走 OpenAI Videos API 原生协议,平台透明转发。可用模型名以 列出模型 返回为准(如 sora-2)。

Authorizations

Authorizationstring必填

Bearer Token 认证。 获取 API Key:访问 API Key 管理页面

Authorization: Bearer YOUR_API_KEY

提交生成任务

POST /v1/videos

请求体为 OpenAI Videos 原生格式(字段以 OpenAI 官方文档为准):

  • model(必填):如 sora-2
  • prompt(必填):视频描述
  • seconds(可选,字符串):时长,如 "4" / "8" / "12"
  • size(可选):分辨率,如 "720x1280" / "1280x720"

查询任务状态

GET /v1/videos/{video_id}

状态枚举(OpenAI 原生):queued / in_progress / completed / failed。建议 5–10 秒轮询一次直到终态。

下载视频

GET /v1/videos/{video_id}/content

任务 completed 后,通过内容端点下载视频文件(二进制 MP4,直接落盘)。

注意事项

  • 任务查询 / 下载必须使用提交时所用的同一个 API Key;任务 Id 可查询窗口 7 天,过期返回 404 task_not_found
  • 基于已完成视频再创作见 Remix
  • 请求与响应字段完整定义以 OpenAI Videos 官方文档为准,平台不做字段改写