创建 Seedance 2.5 任务

火山官方格式

POST /api/v3/contents/generations/tasks
Authorization: Bearer <API_KEY>
Content-Type: application/json

最小请求：

{
  "model": "doubao-seedance-2-5",
  "content": [
    {"type": "text", "text": "清晨的森林，镜头平稳向前推进，电影质感"}
  ],
  "resolution": "480p",
  "ratio": "16:9",
  "duration": 4,
  "generate_audio": true
}

generate_audio 默认 true；需要无声视频时必须显式传 false。seed 支持 -1～4294967295，其中 -1 表示随机。

当前 2.5 渠道对外开放的 duration 为 4～30 秒整数，暂不开放 duration=-1 和 return_last_frame。不要将 seed=-1（随机种子）误解为自动时长。

参考图

{
  "model": "doubao-seedance-2-5",
  "content": [
    {"type": "text", "text": "保持人物与服装一致，缓慢回头"},
    {"type": "image_url", "image_url": {"url": "asset://asset_xxx"}, "role": "reference_image"}
  ],
  "resolution": "480p",
  "ratio": "adaptive",
  "duration": 4,
  "generate_audio": false
}

首尾帧

{
  "model": "doubao-seedance-2-5",
  "content": [
    {"type": "text", "text": "从第一帧自然过渡到第二帧，主体保持一致"},
    {"type": "image_url", "image_url": {"url": "asset://asset_first"}, "role": "first_frame"},
    {"type": "image_url", "image_url": {"url": "asset://asset_last"}, "role": "last_frame"}
  ],
  "resolution": "480p",
  "ratio": "16:9",
  "duration": 4
}

参考视频使用 type: "video_url" 与 role: "reference_video"；参考音频使用 type: "audio_url" 与 role: "reference_audio"。地址既可为可公网下载的 HTTPS URL，也可为2.5 素材库返回的 asset://...。

官方素材限制

素材	Seedance 2.5 限制
参考图片	最多 30 张；JPEG、PNG、WebP、BMP、TIFF、GIF、HEIC、HEIF；单张 <30 MB；宽高各 300～6000 px；宽高比 0.4～2.5
参考视频	最多 10 个；非编辑场景单个 2～30 秒，视频编辑场景单个 4～30 秒；所有参考视频总时长不超过 30 秒；MP4、MOV；单个 <=200 MB；24～60 FPS；宽高各 300～6000 px；宽高比 0.4～2.5
参考音频	最多 10 段；单段 2～30 秒，所有参考音频总时长不超过 30 秒；WAV、MP3；单段 <=15 MB

Seedance 2.5 官方模型支持仅使用参考音频的场景。图片或音频使用 Base64 时，整个请求体不得超过 64 MB；大文件建议使用公网 URL 或 2.5 素材库。

普通参考图或参考视频不能直接携带未授权真人人脸。真人场景请使用平台支持的已授权真人素材、预置虚拟人像，或官方允许二次创作的受信模型原始产物。

场景组合规则

场景	content 组合	规则
文生视频	文本	不传图片、视频或音频素材
首帧生成	文本 + 1 张 first_frame	严格首帧模式
首尾帧生成	文本 + 1 张 first_frame + 1 张 last_frame	两张图比例不同时，尾帧按首帧比例居中裁剪
全模态参考	文本 + reference_image / reference_video / reference_audio	可单用或组合参考素材，但需遵守上表数量和总时长限制

首帧、首尾帧、全模态参考是三类互斥场景，不要在同一请求中混用 first_frame / last_frame 与 reference_image / reference_video / reference_audio。全模态场景可在提示词中指定某张参考图用作起始或结束画面，但不保证达到严格首尾帧模式的一致性。

限制来源：火山方舟—创建视频生成任务。本平台 2.5 渠道当前开放的参数仍以本文为准。

创建成功：

{"id":"task_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"}

OpenAI Video 兼容格式

POST /v1/videos
Authorization: Bearer <API_KEY>
Content-Type: application/json

{
  "model": "doubao-seedance-2-5",
  "prompt": "从产品静物自然过渡到使用场景",
  "images": ["asset://asset_reference"],
  "first_frame": "asset://asset_first",
  "last_frame": "asset://asset_last",
  "video_url": ["asset://asset_video"],
  "audio_url": ["asset://asset_audio"],
  "size": "480p",
  "seconds": "4",
  "ratio": "16:9",
  "metadata": {"seed": -1, "generate_audio": false}
}

兼容格式的 seconds 可传整数或整数字符串。查询使用 GET /v1/videos/{task_id}。