🎬 Sora 视频生成接口说明文档

接口路由、参数说明与 prompt 高级能力 使用指南

一、接口路由

POST /v1/videos
创建视频生成任务（异步），返回 task_id

GET /v1/videos/{task_id}
查询任务状态、进度或错误信息

GET /v1/videos/{task_id}/content
获取已完成的视频内容（URL 或视频流）

model（必填）
视频生成模型，如 doubao-seedance-1-5-pro-251215

prompt（必填 · 核心参数）
视频生成提示词（支持高级控制参数，见下文重点说明）

seconds（可选）
视频时长（字符串）
doubao-seedance-1-5-pro-251215：4–12s ｜其他：2–12s
示例：seconds: "5"

input_reference（可选）
参考图片（URL / Base64），建议使用 URL 解析更快。
参数类型：必须是字符串（包括单张 / 多张）。

支持数量：

doubao-seedance-1-5-pro-251215、doubao-seedance-1-0-pro-250528：最多 2 张（首帧 / 尾帧）

doubao-seedance-1-0-pro-fast-251015：仅 1 张底图

示例（单张）

{
  "input_reference": "https://example.com/a.png"
}

示例（两张，数组字符串）

{
  "input_reference": "[\"https://example.com/first.png\",\"https://example.com/last.png\"]"
}

通过在 prompt 中追加参数控制视频行为，例如：-ratio=16:9

-ratio：比例
支持：["21:9","16:9","4:3","1:1","3:4","9:16"]

-resolution：分辨率
1-5：["480p","720p"]
其他：["480p","720p","1080p"]

-watermark：水印（默认 false）

-generate_audio：音频
仅 doubao-seedance-1-5-pro-251215 支持

-camera_fixed：固定镜头（默认 false）

GET /v1/videos/{task_id}

状态值：queued / processing / completed / failed

GET /v1/videos/{task_id}/content

仅当状态为 completed 时可调用。
返回的视频 URL 通常为临时链接（约 7 天有效），请及时保存。