Seedance 2.5

字节跳动 Seedance 2.5，火山方舟官方视频模型。支持文生视频、首帧 / 首尾帧图生视频，以及用图片、视频、音频做多模态参考生成，可同步生成音频。

模型 ID：doubao-seedance-2-5-260628（火山方舟官方模型 ID，与直接调用火山方舟时相同）
接口：POST https://token.poryf.com/v1/videos（异步任务）
查看价格

生成的视频是火山方舟官方原片，平台原样转发、不做转码，可以自己校验 C2PA 内容凭证，见确认是官方原片。

请求参数

外层只有 model、prompt、seconds；分辨率、比例、声音、参考素材等其余参数都写在 metadata 里，写法与火山方舟官方接口相同。

string

必填

Bearer YOUR_API_KEY，在控制台的 API 密钥页创建。

string

必填

doubao-seedance-2-5-260628

string

画面、运动与声音描述，支持中英文等多种语言。文生视频必填；有参考素材时可选。建议写在这里；按方舟写法放在 metadata.content 的 {"type": "text", "text": "..."} 里也可以，会合并为一段提示词。

integer

视频时长，对应官方字段 duration：4–30 秒的整数。不传时由模型在 4–30 秒内自动决定。

object

火山方舟官方「创建视频生成任务」的请求字段，字段名、取值和默认值都与官方一致，平台原样转发。常用字段见下方。模型和时长请用外层的 model、seconds。

string

默认值:"720p"

分辨率：480p、720p（默认）、1080p。

string

默认值:"adaptive"

画面比例：16:9、4:3、1:1、3:4、9:16、21:9、adaptive（按内容自动决定）。首帧、首尾帧图生视频时必须为 adaptive，比例跟随首帧图片。

boolean

默认值:"true"

是否同步生成与画面匹配的声音（对白、音效、背景音）。生成声音不额外收费。

boolean

默认值:"false"

是否在右下角加「AI 生成」水印。

object[]

参考素材列表，每项形如 {"type": "image_url", "image_url": {"url": "https://..."}, "role": "first_frame"}，视频、音频把 image_url 换成 video_url、audio_url。role 取值：图片 first_frame（首帧）、last_frame（尾帧）、reference_image（参考图）；视频 reference_video；音频 reference_audio。首尾帧可以用同一张图。最多 30 张图片、10 个视频、10 个音频（合计不超过 50 个）；参考视频、参考音频累计时长不超过 30 秒。

string

默认值:"auto"

多模态参考的任务类型：auto（模型自动判断）、reference（参考生成）、extend（视频延长）。显式指定时提交前就会校验参数，例如 extend 需要至少一个参考视频，并且 ratio 为 adaptive。视频编辑（edit）要求时长为 -1，平台暂不支持。

图片、视频、音频请使用公网可访问的 http(s) URL，不要上传文件或使用 Base64。
请不要使用 Draft 样片模式（draft、draft_task）、callback_url 回调和时长 -1：它们不保证可用。请轮询查询任务状态。

示例：文生视频

curl https://token.poryf.com/v1/videos \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-2-5-260628",
    "prompt": "清晨的海边，一只柯基在沙滩上奔跑，镜头缓慢跟随，能听到海浪声",
    "seconds": 5,
    "metadata": {
      "resolution": "720p",
      "ratio": "16:9"
    }
  }'

示例：首尾帧图生视频

curl https://token.poryf.com/v1/videos \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-2-5-260628",
    "prompt": "花朵从含苞到完全绽放",
    "seconds": 5,
    "metadata": {
      "content": [
        {"type": "image_url", "image_url": {"url": "https://example.com/first.jpg"}, "role": "first_frame"},
        {"type": "image_url", "image_url": {"url": "https://example.com/last.jpg"}, "role": "last_frame"}
      ]
    }
  }'

只传 first_frame 一张图即为首帧图生视频。

示例：多模态参考

用参考图确定人物形象，用参考视频确定动作和运镜：

curl https://token.poryf.com/v1/videos \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-2-5-260628",
    "prompt": "参考图片中的人物，按照参考视频的动作在城市街头跳舞",
    "seconds": 8,
    "metadata": {
      "resolution": "720p",
      "ratio": "9:16",
      "content": [
        {"type": "image_url", "image_url": {"url": "https://example.com/person.png"}, "role": "reference_image"},
        {"type": "video_url", "video_url": {"url": "https://example.com/dance.mp4"}, "role": "reference_video"}
      ]
    }
  }'

响应

提交成功后返回任务对象（示例结构）：

{
  "id": "task_xxxxxxxx",
  "object": "video",
  "model": "doubao-seedance-2-5-260628",
  "status": "queued",
  "progress": 0
}

任务成功后查询，可能附带 seedance 字段，给出火山方舟返回的官方结果信息（示例结构）：

{
  "id": "task_xxxxxxxx",
  "object": "video",
  "model": "doubao-seedance-2-5-260628",
  "status": "completed",
  "progress": 100,
  "seedance": {
    "model": "doubao-seedance-2-5-260628",
    "resolution": "720p",
    "ratio": "16:9",
    "duration": 5,
    "framespersecond": 24,
    "generate_audio": true,
    "usage": { "completion_tokens": 108900, "total_tokens": 108900 }
  }
}

seedance 只在任务成功后出现，且不保证每次都有，请不要依赖它判断任务结果；以 status 为准。查询进度、下载视频的方法见视频通用说明。

计费

按任务实际使用的视频 token 计费，口径与火山方舟官方一致。1080p 与 480p / 720p 单价不同；带参考视频的任务单价更低。实时单价见模型广场。 token 数约等于 视频时长（秒）× 宽 × 高 × 24 ÷ 1024；带参考视频时，参考视频的时长也计入。例如 5 秒 720p（16:9）约 10.8 万 token。提交时先预扣：时长按请求的 seconds，没传时按最长 30 秒；分辨率按 metadata.resolution，没传时按 1080p。任务完成后按实际 token 多退少补（极少数情况下拿不到实际用量时，按预扣结算）；任务失败自动全额退回。

确认是官方原片

火山方舟生成的视频文件内嵌 C2PA 内容凭证。平台下载接口原样转发文件、不做转码，你可以自己校验：

网页：打开 Content Credentials Verify，上传下载的 MP4。
命令行：安装 c2patool 后执行 c2patool video.mp4。

凭证中会标明生成模型（例如 doubao-seedance-2-5）。视频经过剪辑、转码后凭证会失效。

下载与保存

完成后用 GET /v1/videos/{id}/content 下载 MP4。任务成功后平台会自动保存一份视频，约 30 天内都可以下载，文件和生成时完全一致。保存还没完成或保存失败时，下载改用火山方舟的源文件链接，这个链接约 24 小时后失效。30 天后无法再取回，请在这之前下载，转存到自己的存储。

常见错误

出现时机	错误	原因
提交时返回 400	`seconds must be between 1 and 3600`	`seconds` 不是 1–3600 之间的数
提交时返回 400	`doubao-seedance-2-5-260628 resolution must be one of …`	`metadata.resolution` 是其他模型才有的档位（例如给 2.5 传 `4k`）
提交时返回 400 / 503	`分组 … 下模型 … 无可用渠道` 或其他说明	参考素材用了 Base64 / 文件，或用了 Draft 样片模式；改为公网 URL、去掉 Draft 字段后重试
提交时返回错误，或任务随后变为 `failed`	`InvalidParameter` 等火山方舟错误	参数不被模型接受，例如时长超出范围、分辨率写错、参考素材数量或时长超限、首尾帧时 `ratio` 不是 `adaptive`；错误信息给出具体字段。任务失败时费用自动退回

其他错误见排错指南。

概览

接入指南

文本系列

图像系列

视频系列

素材库

使用与计费

常见问题

请求参数

示例：文生视频

示例：首尾帧图生视频

示例：多模态参考

响应

计费

确认是官方原片

下载与保存

常见错误

​请求参数

​示例：文生视频

​示例：首尾帧图生视频

​示例：多模态参考

​响应

​计费

​确认是官方原片

​下载与保存

​常见错误

请求参数

示例：文生视频

示例：首尾帧图生视频

示例：多模态参考

响应

计费

确认是官方原片

下载与保存

常见错误