Sora视频生成接口文档（时长扩展版）

接口地址

POST /v1/videos

功能说明

支持 Sora 2 时长扩展模型的文生视频和图生视频，时长直接体现在模型名中（12 秒 / 16 秒 / 20 秒），方向由 aspect_ratio 决定。

请求头

参数名	类型	必填	说明
Authorization	string	是	Bearer YOUR_API_KEY
Content-Type	string	推荐	application/json或 multipart/form-data

请求参数

文生视频

参数名	类型	必填	说明
model	string	是	模型名称，详见下方模型列表（如 `sora-2-12s`）
prompt	string	是	文本提示词
aspect_ratio	string	是	画面方向：`16:9`（横屏）或 `9:16`（竖屏）

图生视频

图生视频支持两种方式提交参考图片：

方式一：使用图片 URL（推荐）

Content-Type: application/json

使用 image_url 参数传递可访问的图片 URL

参数名	类型	必填	说明
model	string	是	模型名称（如 `sora-2-12s`）
prompt	string	是	文本提示词
image_url	string	是	参考图片 URL（需要可以访问的图片地址）
aspect_ratio	string	是	画面方向：`16:9`（横屏）或 `9:16`（竖屏）

方式二：使用图片文件

Content-Type: multipart/form-data（必填）

使用 input_reference 字段上传图片文件

参数名	类型	必填	说明
model	string	是	模型名称（如 `sora-2-12s`）
prompt	string	是	文本提示词
input_reference	File	是	参考图片文件
aspect_ratio	string	是	画面方向：`16:9`（横屏）或 `9:16`（竖屏）

注意：image_url 和 input_reference 二选一，不能同时使用。

支持的模型

模型名称	时长	说明
sora-2-12s	12 秒	Sora 2 （横竖屏由 aspect_ratio 决定）

与原 Sora 2 系列（sora-2-landscape-10s 等）的差异：
模型名不再包含方向后缀，方向必须通过 aspect_ratio 显式传入

请求示例

文生视频

图生视频

方式一：使用图片 URL（推荐）

方式二：使用图片文件

响应参数

参数名	类型	说明
id	string	任务 ID
object	string	对象类型，固定值：`video`
model	string	使用的模型名称（可能为上游内部物理模型名，例如 `sora-2-2`，仅供参考；客户端应以提交时的 model 为准）
status	string	任务状态：queued（排队中）、in_progress / processing（处理中）、completed（已完成）、failed（失败）
progress	number	任务进度，0-100
created_at	number	创建时间戳（秒）
completed_at	number	完成时间戳（秒，仅 completed 状态返回）
video_url	string	完成后的视频地址（仅 completed 状态返回）

响应示例

提交成功（排队中）

{
  "id": "task_xxxxxxxxxxxxx",
  "object": "video",
  "model": "sora-2-12s",
  "status": "queued",
  "progress": 0,
  "created_at": 1709876543
}

任务完成

{
  "id": "task_xxxxxxxxxxxxx",
  "object": "video",
  "model": "sora-2-12s",
  "status": "completed",
  "progress": 100,
  "created_at": 1709876543,
  "completed_at": 1709876600,
  "video_url": "https://videos-us3.ss2.life/files/b/xxxxxx.mp4"
}

查询任务状态

接口地址

GET /v1/videos/{task_id}

请求示例

响应参数

与提交接口响应参数相同，完成后会包含 video_url。

注意事项

方向必须显式传入 aspect_ratio：模型名不带方向后缀，缺省 aspect_ratio 时上游可能拒绝请求或采用未明确的默认值。

图片二选一：image_url 与 input_reference 互斥；二者同时存在时行为未定义。

图片 URL 要求：image_url 必须是可公开访问的图片地址，支持常见图片格式（jpg、png、webp 等）。

异步处理：接口返回任务 ID 后，需要通过轮询 GET /v1/videos/{task_id} 查询任务进度和结果。

application/json

Bodyapplication/json

示例

{
  "id": "task_xxxxxxxxxxxxx",
  "object": "video",
  "model": "sora-2-landscape-10s",
  "status": "completed",
  "progress": 100,
  "created_at": 1709876543,
  "completed_at": 1709876600
}

sora创建

Sora视频生成接口文档（时长扩展版）

接口地址

功能说明

请求头

请求参数

文生视频

图生视频

支持的模型

请求示例

文生视频

图生视频

响应参数

响应示例

提交成功（排队中）

任务完成

查询任务状态

接口地址

请求示例

响应参数

注意事项

请求参数

请求示例代码

返回响应

sora创建

Sora视频生成接口文档（时长扩展版）#

接口地址#

功能说明#

请求头#

请求参数#

文生视频#

图生视频#

支持的模型#

请求示例#

文生视频#

图生视频#

响应参数#

响应示例#

提交成功（排队中）#

任务完成#

查询任务状态#

接口地址#

请求示例#

响应参数#

注意事项#

请求参数

请求示例代码

返回响应

Sora视频生成接口文档（时长扩展版）

接口地址

功能说明

请求头

请求参数

文生视频

图生视频

支持的模型

请求示例

文生视频

图生视频

响应参数

响应示例

提交成功（排队中）

任务完成

查询任务状态

接口地址

请求示例

响应参数

注意事项