视频模型进阶用户更新于
POST/v1/videos/generations
Doubao Seedance 2.5
请求 ID doubao-seedance-2.5
协议
POST /v1/videos/generations· 生成视频示例GET /v1/videos/tasks/{id}· 查询视频任务示例GET /v1/videos/tasks/{id}/content· 下载视频示例DELETE /v1/videos/tasks/{id}· 删除已结束的视频任务示例
认证
请求需要 API Key。在控制台的 API Key 管理 获取密钥。发送 JSON 请求时，设置 Content-Type: application/json。
Authorization: Bearer YOUR_API_KEY
请求参数
POST /v1/videos/generations
| 参数 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
model | string | 必填 | doubao-seedance-2.5. 使用本页列出的模型 ID。 |
prompt | string | 视条件 | 描述画面、动作和镜头。 需要文字提示时，推荐填此字段。也可用 content[].type: "text" 提供。 视频引用按列表顺序使用 @Video1、@Video2 等。使用参考视频时，首尾帧图片按普通参考图处理。 |
content | array<object> | 视条件 | 参考素材和可选文本项。仅传 prompt 做文生视频时可省略。 参考视频模式最多 10 个 MP4/MOV，每段 2–30 秒、合计最多 30 秒、每个最多 100 MiB。可另加最多 2 张普通参考图。视频须为 H.264/H.265、24–60 fps。 视频宽高各 300–6000 像素，总像素数 409,600–8,295,044，宽高比 0.4–2.5。 |
content[].type | string | 必填 | 可用值为 text, image_url, input_image, video_url, input_video。 |
content[].text | string | 视条件 | 当素材项的 type 为 text 时填写提示词。 |
content[].role | string | 视条件 | 首帧用 first_frame，尾帧用 last_frame。尾帧要求同时提供首帧。 普通参考图用 reference_image。 参考视频使用 reference_video。 |
content[].asset_id | string | 视条件 | 先用 POST /v1/videos/assets 上传素材，再填返回的 id。在 multipart 表单中先填 kind（image, video），再填 file。 素材需属于同一账户。素材 ID 与对应的公网 HTTPS URL 二选一。 |
content[].image_url | string | 视条件 | 图片的公网 HTTPS 地址，直接传字符串。 |
content[].video_url | string | 视条件 | 视频的公网 HTTPS 地址，直接传字符串。 |
resolution | string | 选填 | 可用值为 480p, 720p。 默认 480p。 |
ratio | string | 选填 | 输出宽高比，兼容字段名 aspect_ratio。 可用值为 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive。 仅首帧或首尾帧时，省略该字段或传 adaptive，输出跟随首帧；其他模式默认 9:16。 |
duration | integer | 选填 | 输出时长，单位为秒。 接受 4–30 秒的整数。 默认 4。 |
generate_audio | boolean | 选填 | 是否生成音轨。 默认 true。 |
请求示例
先将 API Key 设置为本机环境变量 ICODEEASY_API_KEY，并选择支持直接 HTTP 调用的接入点。接入点要求特定客户端时，按对应客户端指南配置。
示例中的素材 URL 和素材 ID 需要替换成自己的有效素材。
Video Generations · 文生视频
bash
curl -sS 'https://api.icodeeasy.cc/v1/videos/generations' \
-H "Authorization: Bearer $ICODEEASY_API_KEY" \
-H 'Content-Type: application/json' \
--data '{
"model": "doubao-seedance-2.5",
"prompt": "Slow camera push toward a paper lantern swaying gently by a lake.",
"resolution": "480p",
"ratio": "9:16",
"duration": 4,
"generate_audio": true
}'
Video Generations · 首尾帧
bash
curl -sS 'https://api.icodeeasy.cc/v1/videos/generations' \
-H "Authorization: Bearer $ICODEEASY_API_KEY" \
-H 'Content-Type: application/json' \
--data '{
"model": "doubao-seedance-2.5",
"prompt": "Orbit the glass sculpture as the morning light changes.",
"resolution": "720p",
"ratio": "adaptive",
"duration": 6,
"generate_audio": true,
"content": [
{
"type": "image_url",
"image_url": "https://example.com/first.png",
"role": "first_frame"
},
{
"type": "image_url",
"image_url": "https://example.com/last.png",
"role": "last_frame"
}
]
}'
Video Generations · 参考视频
bash
curl -sS 'https://api.icodeeasy.cc/v1/videos/generations' \
-H "Authorization: Bearer $ICODEEASY_API_KEY" \
-H 'Content-Type: application/json' \
--data '{
"model": "doubao-seedance-2.5",
"prompt": "Follow the motion in @Video1 while keeping the camera steady.",
"resolution": "480p",
"ratio": "9:16",
"duration": 4,
"generate_audio": true,
"content": [
{
"type": "video_url",
"video_url": "https://example.com/reference.mp4",
"role": "reference_video"
}
]
}'
查询视频任务
bash
curl -sS 'https://api.icodeeasy.cc/v1/videos/tasks/YOUR_TASK_ID' \
-H "Authorization: Bearer $ICODEEASY_API_KEY"
下载视频
bash
curl -sS 'https://api.icodeeasy.cc/v1/videos/tasks/YOUR_TASK_ID/content' \
-H "Authorization: Bearer $ICODEEASY_API_KEY" \
-L \
-o result.mp4
删除已结束的视频任务
bash
curl -sS 'https://api.icodeeasy.cc/v1/videos/tasks/YOUR_TASK_ID' \
-H "Authorization: Bearer $ICODEEASY_API_KEY" \
-i \
-X DELETE
响应与任务
HTTP 202 · 任务已受理
json
{
"id": "vid_1785398400000000000",
"object": "video.generation.job",
"model": "doubao-seedance-2.5",
"created_at": "2026-07-30T08:00:00Z",
"status_url": "/v1/videos/tasks/vid_1785398400000000000",
"content_url": "/v1/videos/tasks/vid_1785398400000000000/content",
"status": "queued",
"updated_at": "2026-07-30T08:00:00Z",
"task_id": "vid_1785398400000000000"
}
HTTP 200 · 查询到已完成任务
json
{
"id": "vid_1785398400000000000",
"object": "video.generation.job",
"model": "doubao-seedance-2.5",
"created_at": "2026-07-30T08:00:00Z",
"status_url": "/v1/videos/tasks/vid_1785398400000000000",
"content_url": "/v1/videos/tasks/vid_1785398400000000000/content",
"status": "succeeded",
"updated_at": "2026-07-30T08:01:00Z",
"url": "/v1/videos/tasks/vid_1785398400000000000/content"
}
保存 id。用同一 API Key 对 status_url 发起 GET 请求，直到 status 变为 succeeded 或 failed。成功后请求 content_url 下载，并允许 HTTP 重定向。两个地址都相对于 API Base URL。
| 字段 | 类型 | 说明 |
|---|---|---|
id / task_id | string | 任务 ID。创建响应中的 task_id 与 id 相同。 |
status | string | 任务状态，可为 queued、running、succeeded 或 failed。 |
progress | integer | 生成进度。服务没有进度值时会省略。 |
error.code | string | 生成失败时返回错误分类。 |
常见错误
| HTTP | 错误类型 | 说明 |
|---|---|---|
| 400 | invalid_request | 检查模型、字段组合和参考素材是否有效。 |
| 401 | unauthorized | 检查 API Key 是否缺失、无效或已停用。 |
| 402 | insufficient_balance | 账户余额不足以提交任务。 |
| 404 | not_found | 查询遇到 404 时保留任务 ID，核对任务所属账户的 API Key 和查询地址。任务可能已完成，请勿因此重新提交。 |
| 409 | video_not_ready | 视频尚未生成完成。继续查询任务状态。 |
| 503 | submission_unknown | 无法确认提交结果。请先联系支持确认任务是否已创建，再提交新请求。 |
完整接入指南 · 查看完整接口指南，了解请求字段、任务状态和响应格式。
能力与限制
text_to_video· 支持image_to_video· 支持first_frame· 支持last_frame· 支持reference_images· 支持audio· 支持- 限制 分辨率: 480p, 720p · 画面比例: 16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive · 时长: 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30 · 参考图：最多 2 张 · 帧比例：自适应