Sora 2 API

Sora 2 提供标准版与 Pro 变体，适合叙事视频、音乐场景和参考图驱动的视频生成。

模型 key

openai/sora-2 — Sora 2
openai/sora-2-pro — Sora 2 Pro

支持的 mode 与输入

模型	Mode	名称	输入要求
`openai/sora-2`	`text_to_video`	文生视频	Prompt max 2000 chars
`openai/sora-2`	`reference_to_video`	参考图生成视频	Prompt max 2000 chars Images `reference`: 1-1 files, 10 MB, formats jpg, png, webp, jpeg
`openai/sora-2-pro`	`text_to_video`	文生视频	Prompt max 2000 chars
`openai/sora-2-pro`	`reference_to_video`	参考图生成视频	Prompt max 2000 chars Images `reference`: 1-1 files, 10 MB, formats jpg, png, webp, jpeg

参数

模型	参数	默认值	可选值	适用 mode
`openai/sora-2`	`duration`	`4s`	`4s`, `8s`, `12s`	全部 mode
`openai/sora-2`	`aspect_ratio`	`landscape`	`landscape`, `portrait`	全部 mode
`openai/sora-2-pro`	`duration`	`4s`	`4s`, `8s`, `12s`	全部 mode
`openai/sora-2-pro`	`aspect_ratio`	`landscape`	`landscape`, `portrait`	全部 mode
`openai/sora-2-pro`	`resolution`	`standard`	`standard`, `high`	全部 mode

价格

模型	价格
`openai/sora-2`	每秒 6 credits
`openai/sora-2-pro`	每秒 14 credits；参数倍率：`resolution`=`{"high":2,"standard":1}`

生产建议

显式传入 mode。
只使用上表列出的参数值。
媒体输入类 mode 请先用 POST /api/v1/files 上传素材。
如果页面包含多个变体，请使用你真正需要的模型 key。

示例：文生视频

curl https://buble.ai/api/v1/generations \
  -H "Authorization: Bearer $BUBLE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/sora-2",
    "mode": "text_to_video",
    "prompt": "A cinematic product launch shot with slow camera movement, premium lighting, and realistic motion",
    "duration": "4s",
    "aspect_ratio": "landscape"
  }'

示例：素材驱动视频

curl https://buble.ai/api/v1/generations \
  -H "Authorization: Bearer $BUBLE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/sora-2",
    "mode": "reference_to_video",
    "prompt": "Animate the source into a polished cinematic motion shot with natural camera movement",
    "image_urls": ["https://example.com/reference.png"],
    "duration": "4s",
    "aspect_ratio": "landscape"
  }'

Sora 2 API

On this page