HiAPI
博客

使用指南

Seedance 2.5 Flash 图生视频接入指南:首帧、尾帧与按秒计费

让一张图动起来:参数、价格与常见失败原因

2026年11月17日 7 分钟阅读
黑底上薄荷绿的离散点阵,圆点密度从左向右渐增。
模型
seedance-2.5-flash
本页内容

这个模型做什么

seedance-2.5-flash/image-to-video 是 ByteDance 的图生视频模型:上传一张图作为首帧,模型以它为起点生成一段连续视频,并同步生成音频。画面比例跟随首帧,不做二次裁切。

它适合以确定性素材为起点的场景:产品图的动态展示、角色立绘的微表情与肢体动作、分镜草图的动态预演、需要批量填充内容池的短片。它不适合「只给一句话就生成完整叙事」的需求,那是文生视频线路的活。

请求参数

  • prompt(必填):描述期望的动作、运镜、场景与声音,最长 5000 字符。
  • first_frame_url(必填):首帧图片。支持 jpeg、png、webp、bmp、tiff、gif、heic、heif,单张不超过 30 MB,每边 300 到 6000 像素,宽高比 0.4 到 2.5。
  • last_frame_url(可选):尾帧图片,约束与首帧相同;比例不一致时会居中裁剪对齐。传了尾帧就必须同时传首帧。
  • resolution:480p 或 720p,默认 480p。
  • duration:4 到 30 的整数,默认 5,单位为秒。
  • aspect_ratio:只接受 adaptive,输出比例跟随首帧图片。
  • output_format:mp4(默认)或 mov。
  • generate_audio:默认 true。

按秒计费

  • 480p:$0.0679/秒
  • 720p:$0.1525/秒

计费秒数等于请求的 duration。常见的几档:480p 4 秒 $0.2716、720p 4 秒 $0.61、480p 10 秒 $0.679、720p 10 秒 $1.525。首帧和尾帧图片本身不额外计费。

因为按秒计费,重试就是重复付费。把「首帧是否合适」放在提交前判断,比生成完再重来便宜得多。

首帧决定成片上限

模型只能依据首帧里已有的信息来延展,所以首帧的质量几乎决定了结果的上限:

  • 主体清晰、在画面里占比合理——主体太小,模型难以判断该让什么动起来。
  • 避免强模糊与噪点,低质量输入会在每一帧被放大。
  • 注意画面边缘:被切断的主体在运动时容易形变。
  • 画面内文字在运动中难以保持稳定,除非它本来就不是重点。
  • 同一主体多准备几张候选首帧,比反复调提示词更有效。

时长既是费用也是质量变量

片段越长,模型需要维持一致性的帧数越多,漂移和失真的累积概率越高。建议先用 4 到 5 秒验证首帧与运动方向是否成立,确认后再按需要拉长;长内容用「多段短片 + 后期拼接」组织,而不是依赖单次长生成。

常见失败与排查顺序

  1. 提交就报参数错误:先核对图片是否超限(体积、边长、宽高比、格式),以及是否只传了 last_frame_url 没传首帧。
  2. 画面主体变形:多半是首帧主体过小、边缘被切、或动幅要求过大。换首帧或把动作写小。
  3. 比例和预期不一致:这条线路固定 adaptive,输出跟随首帧;想要 16:9 或 9:16 就在首帧上定好。
  4. 内容被拦:首帧本身也要过合规审核,图里有什么直接决定调用能否成立。
  5. 客户端超时但任务其实成功了:视频生成耗时较长,客户端超时设太短会把成功当失败,重复提交又会重复计费。按异步任务处理并给足超时。

上线建议

先用三到五张不同类型首帧跑通链路,确认提交、轮询、下载全通;再固定首帧、只改提示词,摸清哪些动作描述模型响应得好;最后按比例放量,盯住成功率、平均耗时与重试率。参数与价格以模型页当前说明为准。

立即开始构建持久 AI 产物

获取 API 密钥,通过一个基于任务(task)的 API 调用图像、视频和音频模型。

阅读 API 文档