Seedance 2.5 Flash API

视频生成,仅支持 480p 和 720p。按是否含输入视频计价,两种分辨率单价相同。

POST /v1/videos/generations

提交视频任务。

首帧图生视频

必填参数: model, prompt, first_frame_url

可用参数: model, prompt, first_frame_url, duration, resolution, generate_audio, wait

文生视频

必填参数: model, prompt

可用参数: model, prompt, duration, resolution, generate_audio, wait

请求参数

参数类型必填说明
modelstring是精确型号;仅使用本页名称,不用显示别名替代。 可选: dreamina-seedance-2.5-flash
promptstring是使用简化请求时填写画面或运动描述。原生 content 自带文本时可省略。
durationinteger否指定固定生成时长,单位为秒。首帧图生可从 4 秒起。
resolutionstring否输出分辨率。 可选: 480p / 720p
first_frame_urlstring否首帧图片的公网 HTTPS 地址。文生视频可省略。
generate_audioboolean否false 生成静音视频。
waitboolean否false 异步返回任务。使用任务查询端点读取结果。
reference_videosarray否可读取的公网参考视频地址。仅在参考视频场景传入。
## 使用说明 - 提交获接受后保存响应的 `id`,之后用同一账号查询。收到 HTTP 202 时继续查询任务。 - `pending`、`submitted`、`processing` 表示进行中。每隔几秒查询一次。 - `succeeded`、`failed`、`timeout`、`canceled` 是终态。`unknown` 时保留 ID 并复核响应。失败时读取 `error.code` 与 `error.message`。 - 原生 `content` 非空时优先使用其中的文本和素材。首帧素材以 `type: "image_url"`、`role: "first_frame"`、`image_url.url` 表达。 - 成功后保存结果文件,下载地址可能过期。480p、720p 是本型号在平台开放的两种输出分辨率。 [BytePlus 官方参数参考](https://console.byteplus.com/ark/region:ap-southeast-1/docs/create-video-generation-task-api) · 核对于 2026-11-19。 ## 完整嵌套字段说明 数组元素用[]表示;必填标记以所在对象或相应内容块成立为前提。响应字段可能按场景缺失或为null,不应补成虚构的0。 ### 请求头 | 字段路径 | 类型 | 所属对象内必填 | 含义 | |---|---|---|---| | `Content-Type` | string | 是 | 请求体格式为application/json。 | ### 请求体 | 字段路径 | 类型 | 所属对象内必填 | 含义 | |---|---|---|---| | `model` | string | 是 | 精确型号;仅使用本页名称,不用显示别名替代。 可选值:dreamina-seedance-2.5-flash | | `prompt` | string | 是 | 使用简化请求时填写画面或运动描述。原生 content 自带文本时可省略。 | | `duration` | integer | 否 | 指定固定生成时长,单位为秒。首帧图生可从 4 秒起。 默认:5; 最小值:4; 最大值:30 | | `resolution` | string | 否 | 输出分辨率。 可选值:480p, 720p; 默认:"720p" | | `first_frame_url` | string | 否 | 首帧图片的公网 HTTPS 地址。文生视频可省略。 | | `generate_audio` | boolean | 否 | false 生成静音视频。 | | `wait` | boolean | 否 | false 异步返回任务。使用任务查询端点读取结果。 默认:false | | `reference_videos` | array[string] | 否 | 可读取的公网参考视频地址。仅在参考视频场景传入。 | ### 响应 202 | 字段路径 | 类型 | 所属对象内必填 | 含义 | |---|---|---|---| | `id` | string | 是 | 任务标识。按不透明字符串原样保存。 | | `model` | string | 是 | 本次请求的精确型号。 | | `status` | string | 是 | 任务状态,只有 succeeded 表示已生成。 可选值:pending, submitted, processing, succeeded, failed, timeout, canceled, unknown | | `created_at` | integer | 是 | 创建时间,Unix 秒。 | ### 错误响应结构 | 字段路径 | 类型 | 所属对象内必填 | 含义 | |---|---|---|---| | `error` | object | 否 | 请求错误对象。 | | `error.code` | string | 否 | 错误代码。 | | `error.message` | 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-flash",
  "prompt": "Generate a short clip of a paper boat moving across a still pond.",
  "first_frame_url": "https://example.invalid/materials/paper-boat.jpg",
  "duration": 4,
  "resolution": "480p",
  "generate_audio": false,
  "wait": false
}'

接口通用说明: Aliyun Wan 视频生成

GET /v1/videos/generations/{id}

查询视频任务。

## 使用说明 - 提交获接受后保存响应的 `id`,之后用同一账号查询。收到 HTTP 202 时继续查询任务。 - `pending`、`submitted`、`processing` 表示进行中。每隔几秒查询一次。 - `succeeded`、`failed`、`timeout`、`canceled` 是终态。`unknown` 时保留 ID 并复核响应。失败时读取 `error.code` 与 `error.message`。 - 原生 `content` 非空时优先使用其中的文本和素材。首帧素材以 `type: "image_url"`、`role: "first_frame"`、`image_url.url` 表达。 - 成功后保存结果文件,下载地址可能过期。480p、720p 是本型号在平台开放的两种输出分辨率。 [BytePlus 官方参数参考](https://console.byteplus.com/ark/region:ap-southeast-1/docs/create-video-generation-task-api) · 核对于 2026-11-19。 ## 完整嵌套字段说明 数组元素用[]表示;必填标记以所在对象或相应内容块成立为前提。响应字段可能按场景缺失或为null,不应补成虚构的0。 ### 路径参数 | 字段路径 | 类型 | 所属对象内必填 | 含义 | |---|---|---|---| | `id` | string | 是 | 同一账号已提交任务的完整标识。 | ### 响应 200 | 字段路径 | 类型 | 所属对象内必填 | 含义 | |---|---|---|---| | `id` | string | 是 | 任务标识。按不透明字符串原样保存。 | | `model` | string | 是 | 本次请求的精确型号。 | | `status` | string | 是 | 任务状态,只有 succeeded 表示已生成。 可选值:pending, submitted, processing, succeeded, failed, timeout, canceled, unknown | | `created_at` | integer | 是 | 创建时间,Unix 秒。 | | `updated_at` | integer | 否 | 最后更新时间,Unix 秒,可能缺失。 | | `resolution` | string | 否 | 返回的输出分辨率。 | | `duration` | integer | 否 | 输出时长,单位为秒。 | | `generate_audio` | boolean | 否 | 是否生成音频。 | | `output_format` | string | 否 | 返回的视频容器格式。 | | `ratio` | string | 否 | 输出宽高比。 | | `framespersecond` | integer | 否 | 输出帧率。 | | `seed` | integer | 否 | 返回的随机种子。 | | `content` | object | 否 | 成功时的视频结果对象。 | | `content.video_url` | string | 是 | 生成视频的 HTTPS 下载地址。请及时保存。 | | `usage` | object | 否 | 本次生成报告的用量。非终态或失败时可能缺失。 | | `usage.completion_tokens` | integer | 否 | 生成用量。 | | `usage.total_tokens` | integer | 否 | 整笔任务报告的总量。直接读取此值,无需与 completion_tokens 相加。 | | `error` | object | 否 | 失败、超时或取消时可能有错误对象。成功时可为 null。 | | `error.code` | string | 否 | 错误代码。 | | `error.message` | string | 否 | 可读错误信息。 | ### 错误响应结构 | 字段路径 | 类型 | 所属对象内必填 | 含义 | |---|---|---|---| | `error` | object | 否 | 请求错误对象。 | | `error.code` | string | 否 | 错误代码。 | | `error.message` | string | 否 | 可读错误信息。 |

请求示例

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

接口通用说明: 查询视频任务