Sora 2 视频生成

OpenAI Sora 2 异步视频生成接口。文生视频 / 图生视频共用同一端点，由 input_reference 是否携带区分。

接入地址

线路	Base URL
国内加速（推荐）	`https://cdn.wusag.com`
海外直连	`https://api.xinliu.one`

Header

字段	值	必填
`Authorization`	`Bearer 你的令牌`	是
`Content-Type`	`application/json`	是

请求体（JSON）

字段	类型	必填	说明
`model`	string	是	模型名称，参见下方"可用模型"段
`prompt`	string	是	视频内容描述，漏填返回 400 `prompt is required`
`size`	string	是	分辨率，例 `1280x720` / `720x1280`。漏填返回 400 `missing size`
`input_reference`	string	否	图生视频参考图，URL 或 base64。文生视频不传
`seconds`	string	否	视频时长。模型名带秒数（如 `-12s`）时该字段忽略
`watermark`	boolean	否	是否在生成视频中保留水印，默认 `false`
`private`	boolean	否	隐私模式，`true` 时视频不公开发布也不可被 remix，默认 `false`
`storyboard`	boolean	否	是否启用故事板（分镜）控制以获得更精细的生成细节
`style`	string	否	视频风格（仅特定模型支持）：`thanksgiving` / `comic` / `news` / `selfie` / `nostalgic` / `anime`

可用模型

模型 ID	时长	说明
`sora-2-openai-12s`	12 秒	OpenAI Sora 2 标准
`sora-2-openai-16s`	16 秒	OpenAI Sora 2 加长
`sora-2-openai-20s`	20 秒	OpenAI Sora 2 长视频
`sora2`	按默认时长	裸名版本，部分分组可用，`default` 分组无渠道时返回 503

实际可用模型以 GET /v1/models 返回的 id 为准。

curl 示例

文生视频：

图生视频：

提交后立即返回

{
  "id": "task_k6MV2y4F7DZ5hSUmRVmhUApeoWm3v4z3",
  "task_id": "task_k6MV2y4F7DZ5hSUmRVmhUApeoWm3v4z3",
  "object": "video",
  "model": "sora2",
  "status": "in_progress",
  "progress": 5,
  "created_at": 1778228893,
  "size": "1280x720"
}

字段说明：

task_id：异步任务 ID，用于后续查询进度和下载结果

model：提交时统一返回别名 sora2，进度查询时返回真实模型名（如 sora-2-openai-12s）

status：in_progress / completed / failed

progress：进度百分比（0~100）

size：本次任务的视频分辨率

任务进度查询与结果获取

任务异步执行，调用本接口提交后请走以下两个共用接口：

进度查询：GET /v1/videos/{task_id} —— 见「视频任务查询（共用）」节点。返回 status 为 completed 时，响应中携带 url 字段（无水印视频地址）和 quality 字段（standard 表示通过审查，其他值为违规说明）

内容下载：GET /v1/videos/{task_id}/content —— 见「视频内容下载（共用）」节点，返回 video/mp4 二进制流

内容审查

Sora 2 对生成内容有严格审查，请确保提示词与参考图符合以下要求，否则任务可能在生成 90% 以上仍被拒：

真人或拟真人内容：不得包含真人或拟真人图像

提示词合规：禁止暴力、色情、版权侵权或涉及名人信息

生成结果审查：违规内容（如暴力、极端图像）即使生成完成也无法通过审查

任务被审查拒绝时，进度查询返回 status: "failed"，quality 字段会带说明，或返回如下错误体：

{
  "error": {
    "message": "Your prompt was flagged by our moderation system.",
    "type": "moderation_blocked"
  }
}

错误码

HTTP	触发条件	错误体
400	漏 `prompt` 字段	`{"code":"invalid_request","message":"prompt is required","data":null}`
400	漏 `size` 字段	`{"code":"do_response_failed","message":"upstream error: code=fail_to_fetch_task, message={\"error\":\"missing size\"}","data":null}`
401	`Authorization` 缺失或令牌无效	`{"error":{"message":"无效的令牌","type":"new_api_error"}}`
503	模型名不存在或当前分组未开通该模型	`{"error":{"message":"分组 X 下模型 Y 无可用渠道（distributor）","type":"new_api_error"}}`

Sora 2 视频生成