Seedance 2.5 Flash API
影片生成,僅支援 480p 和 720p。按是否含輸入影片計價,兩種解析度單價相同。
- 模型名:
dreamina-seedance-2.5-flash - 厂商: bytedance
- 类型: video
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
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|
model | string | 是 | 精确型号;仅使用本页名称,不用显示别名替代。 可选: dreamina-seedance-2.5-flash |
prompt | string | 是 | 使用简化请求时填写画面或运动描述。原生 content 自带文本时可省略。 |
duration | integer | 否 | 指定固定生成时长,单位为秒。首帧图生可从 4 秒起。 |
resolution | string | 否 | 输出分辨率。 可选: 480p / 720p |
first_frame_url | string | 否 | 首帧图片的公网 HTTPS 地址。文生视频可省略。 |
generate_audio | boolean | 否 | false 生成静音视频。 |
wait | boolean | 否 | false 异步返回任务。使用任务查询端点读取结果。 |
reference_videos | array | 否 | 可读取的公网参考视频地址。仅在参考视频场景传入。 |
## 使用说明
- 提交获接受后保存响应的 `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"
接口通用说明: 查詢影片任務