跳到主要内容
AI
MarkdownLLMs.txt

Sora 2 视频生成

Sora 2 支持基于提示词的视频生成，并可选择参考图输入。来源范围同时包含 UniAll 视频生成接口和 OpenAI 原生兼容格式页面。

支持模型​

模型说明
sora2-landscape-4s横版输出，4 秒。
sora2-landscape-8s横版输出，8 秒。
sora2-landscape-12s横版输出，12 秒。
sora2-portrait-4s竖版输出，4 秒。
sora2-portrait-8s竖版输出，8 秒。
sora2-portrait-12s竖版输出，12 秒。
sora2-pro-720pPro 公共模型，720p。
sora2-pro-1080pPro 公共模型，1080p。
sora2-pro-true-1080p账号启用时可用的 Pro true-1080p 模型。

Endpoint​

POST /v1/video/generations
GET  /v1/videos/{task_id}

来源还包含原生 OpenAI 格式页面，供需要 OpenAI 兼容请求格式的客户端使用。

Authentication​

Authorization: Bearer sk-***
Content-Type: application/json

请求参数​

参数类型必填说明
modelstring是Sora 2 模型 ID。
promptstring是视频提示词。
image_urlstring否公开可访问的参考图 URL。
aspect_ratiostring否16:9 或 9:16。
durationinteger/string否来源描述列出 4、8、12、16、20；模型名本身可能已编码时长。

请求示例​

curl -X POST "{BASE_URL}/v1/video/generations" \
  -H "Authorization: Bearer sk-***" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "sora2-portrait-12s",
    "prompt": "A cat running through grass",
    "image_url": "https://example.com/image.jpg"
  }'

提交响应​

{
  "id": "gen_xxxxxxxxxxxx",
  "object": "video.generation.job",
  "model": "sora2",
  "status": "queued",
  "progress": 0,
  "created_at": 1770405483,
  "seconds": "12"
}

查询任务状态​

curl "{BASE_URL}/v1/videos/gen_xxxxxxxxxxxx" \
  -H "Authorization: Bearer sk-***"
{
  "id": "gen_xxxxxxxxxxxx",
  "object": "video.generation.job",
  "model": "sora2-portrait-12s",
  "status": "completed",
  "progress": 100,
  "video_url": "https://example.com/output.mp4",
  "seconds": "12"
}

计费说明​

Sora 2 计费与模型、时长、横竖版、分辨率以及是否使用 Pro 模型有关。当前模型价格和任务结算记录是最终依据。

常见错误​

  • 传入不支持的 Sora 2 模型 ID。
  • image_url 私有或已过期。
  • aspect_ratio 与 landscape 或 portrait 模型名冲突。
  • 任务仍在队列中就当作完成处理。
  • 在同一请求里混用 UniAll 任务格式和原生 OpenAI 格式。

相关页面​