Sora 视频生成

提交 Sora 视频生成任务（文生、首帧）。

请求地址仍为 POST /v1/video/generations，完成后用 GET /v1/video/generations/{task_id} 查询。

首帧必须写在 metadata.content 里，并且 role=first_frame。不支持尾帧、参考图、参考视频。

时长只接受 4、8、12，默认 8。分辨率只接受大写 720P，宽高比只支持 16:9、9:16。

各版本能力与字段说明见下方接口文档。

Authorization

BearerAuth

AuthorizationBearer <token>

使用 Bearer Token 认证。格式: Authorization: Bearer sk-xxxxxx

In: header

Request Body

application/json

model*string

模型 ID。

model	说明
`sora-video-2.0`	文生、首帧；时长 4 / 8 / 12 秒；分辨率仅 `720P`；支持音频

prompt?string

文本描述提示词。t2v 模式必填；i2v / 参考图模式建议填写以精确描述运动效果。

duration?number

视频时长（秒）。只接受 4、8、12，默认 8。其他值取最近的合法值。

resolution?string

分辨率。只接受大写 720P。传入其他档位会报错。

ratio?string

宽高比。只支持 16:9、9:16。

seed?integer

随机种子，控制生成结果可复现性。全部模型支持。

metadata?

扩展参数。不支持尾帧、参考图、参考视频。

字段	类型	说明
`content`	array	只用于首帧。见下方元素字段
`negative_prompt`	string	反向提示词
`audio_generation`	string	是否生成 AI 音频，`Enabled` / `Disabled`。有值即转发

`content` 元素结构

字段	类型	说明
`type`	string	`image_url`
`role`	string	见下表
`image_url.url`	string	图片地址

role 取值：

role	适用 type	说明
`first_frame`	image_url	首帧。必须写 `first_frame`

Response Body

application/json

curl -X POST "https://loading/v1/video/generations" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "sora-video-2.0",
    "prompt": "宇航员站起身，缓缓走向舱门",
    "resolution": "720P",
    "duration": 8,
    "metadata": {
      "audio_generation": "Enabled"
    }
  }'

curl -X POST "https://loading/v1/video/generations" \  -H "Content-Type: application/json" \  -d '{    "model": "sora-video-2.0",    "prompt": "宇航员站起身，缓缓走向舱门",    "resolution": "720P",    "duration": 8,    "metadata": {      "audio_generation": "Enabled"    }  }'

{
  "task_id": "task_aehCmxJ5YUNOIQGgkhvxaco4T9P2h3Dw",
  "status": "queued"
}

{
  "error": {
    "message": "string",
    "type": "string",
    "param": "string",
    "code": "string"
  }
}

Authorization

Request Body

content 元素结构

Response Body

200application/json

400application/json

`content` 元素结构

application/json

application/json