跳转到主要内容
字节跳动 Seedance 2.5 系列的快速视频模型,支持文生视频、首帧 / 首尾帧图生视频、全模态参考生成、视频编辑和延长,可同步生成声音。
  • 模型 ID:doubao-seedance-2-5-flash-261115(火山方舟官方模型 ID,与直接调用火山方舟时相同)
  • 接口:POST https://token.poryf.com/v1/videos(异步任务)
  • 查看价格
生成的视频是火山方舟官方原片,平台原样转发、不做转码,可以自己校验 C2PA 内容凭证,见 确认是官方原片。

请求参数

外层只有 model、prompt、seconds;分辨率、比例、声音、参考素材等其余参数都写在 metadata 里,写法与火山方舟官方接口相同。
string
必填
Bearer YOUR_API_KEY,在 控制台的 API 密钥页 创建。
string
必填
doubao-seedance-2-5-flash-261115
string
画面、运动与声音描述,支持中英文等多种语言。文生视频必填;有参考素材时可选。建议写在这里;按方舟写法放在 metadata.content 的 {"type": "text", "text": "..."} 里也可以,会合并为一段提示词。
integer
视频时长,对应官方字段 duration:4–30 秒的整数。传 -1 或省略时由模型选择时长;视频编辑使用 -1。
object
下表列出的参数使用火山方舟的创建任务格式。模型和时长请用外层的 model、seconds。
string
默认值:"720p"
分辨率:480p、720p(默认)。
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。首尾帧可以用同一张图。最多 10 张图片、5 个视频、5 个音频。视频和音频各自累计最多 30 秒。
string
默认值:"auto"
多模态参考的任务类型:auto(模型自动判断)、reference(参考生成)、extend(视频延长)。显式指定时提交前就会校验参数,例如 extend 需要至少一个参考视频,并且 ratio 为 adaptive。edit(视频编辑)需要至少一个 4–30 秒的参考视频,比例为 adaptive,时长为 -1。
string
默认值:"mp4"
输出文件格式,可选 mp4、mov。
boolean
默认值:"false"
返回视频尾帧。成功后通过 GET /v1/tasks/{id}/artifacts/last_frame/content 下载尾帧。
integer
默认值:"172800"
任务超时阈值,范围 3600–259200 秒。
integer
默认值:"0"
同一推理接入点内的任务执行优先级,范围 0–9。
string
可选终端用户标识,最长 64 个字符。可使用对用户 ID 的哈希值。
object[]
传入 [{"type":"web_search"}] 允许模型按提示词自行检索。参数已通过提交测试,但两次实测的搜索调用计数均为 0,实际搜索执行尚未验收。
  • 参考素材使用公网 HTTP(S) URL 或已配置的 asset:// 素材,不支持 Base64。
  • 任务状态请通过查询接口轮询。Flash 仅支持在线推理,样片模式、frames、seed、camera_fixed 和 callback_url 不可用。

示例:文生视频

示例:首尾帧图生视频

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

示例:多模态参考

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

响应

提交成功后返回任务对象(示例结构):
任务成功后查询,可能附带 seedance 字段,给出火山方舟返回的官方结果信息(示例结构):
seedance 只在任务成功后出现,且不保证每次都有,请不要依赖它判断任务结果;以 status 为准。查询进度、下载视频的方法见 视频通用说明。

计费

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

确认是官方原片

火山方舟生成的视频文件内嵌 C2PA 内容凭证。平台下载接口原样转发文件、不做转码,你可以自己校验: 凭证中会标明生成模型(例如 doubao-seedance-2-5)。视频经过剪辑、转码后凭证会失效。

下载与保存

完成后用 GET /v1/videos/{id}/content 下载所选格式的原始视频。平台会自动保存一份,约 30 天内可通过下载接口取回。

常见错误

其他错误见 排错指南。

实际出片示例

以下为通过本平台生成的 4 秒原片,未转码,保留生成时的 AIGC / C2PA 元数据。 提示词:一艘白色折纸船沿浅水缓慢漂过,近景镜头横移,水面反射暖色光线,配有柔和的雨声。 参数:seconds: 4,resolution: 480p,ratio: 16:9,generate_audio: true,output_format: mp4,return_last_frame: true。实际用量为 38,830 Token。 本例的 C2PA 签名和文件哈希校验通过;公共信任列表验证结果为 signingCredential.untrusted,不代表证书链已获该列表信任。