Seedance 2.5 API

dreamina-seedance-2.5 影片生成, 480p / 720p, 最長支援 30 秒

POST /v1/videos/generations

dreamina-seedance-2.5:提交影片任務,含必填項、巢狀響應和虛構示例。

基础调用

必填参数: model, content

可用参数: model, content, duration, resolution, ratio, wait

请求参数

参数类型必填说明
modelstring是精确型号;仅使用本页名称,不用显示别名替代。 可选: dreamina-seedance-2.5
contentarray是输入内容;文字生成至少含text块,图生场景另含参考图。
durationinteger否输出秒数,可用范围按本型号。
resolutionstring否输出分辨率,示例使用720p。
ratiostring否画面比例。
waitboolean否false表示提交后立即返回任务;推荐使用后续查询。
## 使用与响应约定 - 必填项与嵌套结构见参数表。未给出数值默认值的可选项,使用该型号当前默认配置。 - 不同型号的上下文、输出预算、素材数量与规格有差异;本页不把未核实的上限写成统一限制。 - 缺失字段与明确的0不同;读取实际返回的状态、内容与用量。 - 示例中的 `example.invalid` 地址必须换成自己有权使用、可被服务读取的素材。 - 生成文件请及时保存;不要假设结果链接永久有效。 ### 提交后查询同一任务 提交响应的 `id` 是后续查询依据,不要使用示例标识发起真实查询,也不要为了查询进度重新提交生成。使用 `GET /v1/videos/generations/{id}`。pending、submitted、processing表示尚未完成;succeeded、failed、timeout、canceled为终态。成功后读取该型号返回的 `content.video_url`、`output.video_url` 或 `video.url`,只使用实际存在的结果字段。 ## 参考 参数术语参考[Seedance官方说明](https://docs.byteplus.com/en/docs/ModelArk/2291680);调用时使用本页平台域名和精确型号。文档核对日期:2026-11-07。 ## 完整嵌套字段说明 数组元素用[]表示;必填标记以所在对象或相应内容块成立为前提。响应字段可能按场景缺失或为null,不应补成虚构的0。 ### 请求头 | 字段路径 | 类型 | 所属对象内必填 | 含义 | |---|---|---|---| | `Content-Type` | string | 是 | 请求体格式为application/json。 | ### 请求体 | 字段路径 | 类型 | 所属对象内必填 | 含义 | |---|---|---|---| | `model` | string | 是 | 精确型号;仅使用本页名称,不用显示别名替代。 可选值:dreamina-seedance-2.5 | | `content` | array[object] | 是 | 输入内容;文字生成至少含text块,图生场景另含参考图。 | | `content[].type` | string | 是 | 内容类型。 可选值:text, image_url | | `content[].text` | string | 否 | 文字描述,text块必填。 | | `content[].image_url` | object | 否 | 参考图对象。 | | `content[].image_url.url` | string | 是 | 可读取的参考图URL。 | | `content[].role` | string | 否 | 参考图角色,放在内容块外层。 可选值:first_frame, last_frame, reference_image | | `duration` | integer | 否 | 输出秒数,可用范围按本型号。 最小值:1 | | `resolution` | string | 否 | 输出分辨率,示例使用720p。 | | `ratio` | string | 否 | 画面比例。 | | `wait` | boolean | 否 | false表示提交后立即返回任务;推荐使用后续查询。 默认:false | ### 响应 200 | 字段路径 | 类型 | 所属对象内必填 | 含义 | |---|---|---|---| | `id` | string | 否 | 提交后返回的任务标识;作为不透明字符串原样保存。 | | `model` | string | 否 | 任务型号。 | | `status` | string | 否 | 任务状态;只有终态才结束查询。 可选值:pending, submitted, processing, succeeded, failed, timeout, canceled, unknown | | `created_at` | integer | 否 | 创建时间,Unix秒。 | | `content` | object | 否 | 部分视频型号的结果。 | | `content.video_url` | string | 否 | 成功后的视频URL。 | | `content.last_frame_url` | string | 否 | 提供时的末帧URL。 | | `output` | object | 否 | 部分视频型号的输出对象。 | | `output.video_url` | string | 否 | 成功后的视频URL。 | | `output.task_status` | string | 否 | 提供时的原始任务状态。 | | `video` | object | 否 | 部分视频型号的视频结果。 | | `video.url` | string | 否 | 成功后的视频URL。 | | `error` | object | 否 | 失败、取消或超时时的错误对象,成功时可能为null。 | | `error.code` | string | 否 | 错误码。 | | `error.message` | string | 否 | 错误说明。 | ### 响应 202 | 字段路径 | 类型 | 所属对象内必填 | 含义 | |---|---|---|---| | `id` | string | 否 | 提交后返回的任务标识;作为不透明字符串原样保存。 | | `model` | string | 否 | 任务型号。 | | `status` | string | 否 | 任务状态;只有终态才结束查询。 可选值:pending, submitted, processing, succeeded, failed, timeout, canceled, unknown | | `created_at` | integer | 否 | 创建时间,Unix秒。 | | `content` | object | 否 | 部分视频型号的结果。 | | `content.video_url` | string | 否 | 成功后的视频URL。 | | `content.last_frame_url` | string | 否 | 提供时的末帧URL。 | | `output` | object | 否 | 部分视频型号的输出对象。 | | `output.video_url` | string | 否 | 成功后的视频URL。 | | `output.task_status` | string | 否 | 提供时的原始任务状态。 | | `video` | object | 否 | 部分视频型号的视频结果。 | | `video.url` | string | 否 | 成功后的视频URL。 | | `error` | object | 否 | 失败、取消或超时时的错误对象,成功时可能为null。 | | `error.code` | string | 否 | 错误码。 | | `error.message` | string | 否 | 错误说明。 | ### 错误响应结构 | 字段路径 | 类型 | 所属对象内必填 | 含义 | |---|---|---|---| | `error` | object | 否 | 错误详情;以本次返回为准。 | | `error.message` | string | 否 | 消息内容或可读错误说明,依所在对象区分。 | | `error.type` | string | 否 | 类型标识;依所在对象及枚举取值区分。 | | `error.code` | string | 否 | 错误码,可能为空。 |

请求示例

curl --request POST https://api.router.ai/v1/videos/generations \
  --header "Authorization: Bearer $API_KEY" \
  --header "Content-Type: application/json" \
  --data-raw '{
  "model": "dreamina-seedance-2.5",
  "content": [
    {
      "type": "text",
      "text": "A fictional blue paper boat on a plain white background."
    }
  ],
  "duration": 5,
  "resolution": "720p",
  "wait": false
}'

接口通用说明: Aliyun Wan 影片生成

GET /v1/videos/generations/{id}

查詢本型號已提交任務的狀態和結果,不建立新任務。

## 使用与响应约定 - 必填项与嵌套结构见参数表。未给出数值默认值的可选项,使用该型号当前默认配置。 - 不同型号的上下文、输出预算、素材数量与规格有差异;本页不把未核实的上限写成统一限制。 - 缺失字段与明确的0不同;读取实际返回的状态、内容与用量。 - 示例中的 `example.invalid` 地址必须换成自己有权使用、可被服务读取的素材。 - 生成文件请及时保存;不要假设结果链接永久有效。 ### 提交后查询同一任务 提交响应的 `id` 是后续查询依据,不要使用示例标识发起真实查询,也不要为了查询进度重新提交生成。使用 `GET /v1/videos/generations/{id}`。pending、submitted、processing表示尚未完成;succeeded、failed、timeout、canceled为终态。成功后读取该型号返回的 `content.video_url`、`output.video_url` 或 `video.url`,只使用实际存在的结果字段。 ## 参考 参数术语参考[Seedance官方说明](https://docs.byteplus.com/en/docs/ModelArk/2291680);调用时使用本页平台域名和精确型号。文档核对日期:2026-11-07。 ## 完整嵌套字段说明 数组元素用[]表示;必填标记以所在对象或相应内容块成立为前提。响应字段可能按场景缺失或为null,不应补成虚构的0。 ### 路径参数 | 字段路径 | 类型 | 所属对象内必填 | 含义 | |---|---|---|---| | `id` | string | 是 | 同一账号提交后返回的任务标识。 | ### 响应 200 | 字段路径 | 类型 | 所属对象内必填 | 含义 | |---|---|---|---| | `id` | string | 否 | 提交后返回的任务标识;作为不透明字符串原样保存。 | | `model` | string | 否 | 任务型号。 | | `status` | string | 否 | 任务状态;只有终态才结束查询。 可选值:pending, submitted, processing, succeeded, failed, timeout, canceled, unknown | | `created_at` | integer | 否 | 创建时间,Unix秒。 | | `content` | object | 否 | 部分视频型号的结果。 | | `content.video_url` | string | 否 | 成功后的视频URL。 | | `content.last_frame_url` | string | 否 | 提供时的末帧URL。 | | `output` | object | 否 | 部分视频型号的输出对象。 | | `output.video_url` | string | 否 | 成功后的视频URL。 | | `output.task_status` | string | 否 | 提供时的原始任务状态。 | | `video` | object | 否 | 部分视频型号的视频结果。 | | `video.url` | string | 否 | 成功后的视频URL。 | | `error` | object | 否 | 失败、取消或超时时的错误对象,成功时可能为null。 | | `error.code` | string | 否 | 错误码。 | | `error.message` | string | 否 | 错误说明。 | ### 错误响应结构 | 字段路径 | 类型 | 所属对象内必填 | 含义 | |---|---|---|---| | `error` | object | 否 | 错误详情;以本次返回为准。 | | `error.message` | string | 否 | 消息内容或可读错误说明,依所在对象区分。 | | `error.type` | string | 否 | 类型标识;依所在对象及枚举取值区分。 | | `error.code` | string | 否 | 错误码,可能为空。 |

请求示例

curl --request GET "https://api.router.ai/v1/videos/generations/$TASK_ID" \
  --header "Authorization: Bearer $API_KEY"

接口通用说明: 查詢影片任務