- 模型 ID:
doubao-seedance-2-5-flash-261115(火山方舟官方模型 ID,与直接调用火山方舟时相同) - 接口:
POST https://token.poryf.com/v1/videos(异步任务) - 查看价格
请求参数
外层只有model、prompt、seconds;分辨率、比例、声音、参考素材等其余参数都写在 metadata 里,写法与火山方舟官方接口相同。
Bearer YOUR_API_KEY,在 控制台的 API 密钥页 创建。画面、运动与声音描述,支持中英文等多种语言。文生视频必填;有参考素材时可选。建议写在这里;按方舟写法放在
metadata.content 的 {"type": "text", "text": "..."} 里也可以,会合并为一段提示词。下表列出的参数使用火山方舟的创建任务格式。模型和时长请用外层的
model、seconds。画面比例:
16:9、4:3、1:1、3:4、9:16、21:9、adaptive(按内容自动决定)。首帧、首尾帧图生视频时必须为 adaptive,比例跟随首帧图片。参考素材列表,每项形如
{"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 秒。多模态参考的任务类型:
auto(模型自动判断)、reference(参考生成)、extend(视频延长)。显式指定时提交前就会校验参数,例如 extend 需要至少一个参考视频,并且 ratio 为 adaptive。edit(视频编辑)需要至少一个 4–30 秒的参考视频,比例为 adaptive,时长为 -1。示例:文生视频
示例:首尾帧图生视频
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 内容凭证。平台下载接口原样转发文件、不做转码,你可以自己校验:- 网页:打开 Content Credentials Verify,上传下载的 MP4。
- 命令行:安装 c2patool 后执行
c2patool video.mp4。
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,不代表证书链已获该列表信任。