使用指南
Seedance 2.5 Flash 文生视频接入指南:参数、按秒计费与工程实践
从一次请求到稳定上线:参数怎么设、账怎么算
- 模型
- seedance-2.5-flash
本页内容
这个模型做什么
seedance-2.5-flash/text-to-video 是 ByteDance 的文生视频模型:输入一段文本提示词,输出一段带同步音频的视频。它只有这一条输入路径——不接受图片、视频作为条件输入,也不做视频理解。
适合的场景是「一句话出一段能用的小视频」:营销素材批量生产、产品短片的空镜与氛围镜头、内容池的片段填充、创意方向的快速预演。如果你的起点是一张图,用图生视频线路更直接;如果你需要按参考素材保持主体一致,用参考素材驱动线路。
请求里有哪些参数
- prompt(必填):场景、主体、镜头运动与动作。最长 5000 字符。
- resolution:
480p或720p,默认480p。 - duration:4 到 30 的整数,默认 5,单位为秒。
- aspect_ratio:
16:9、4:3、1:1、3:4、9:16、21:9、adaptive,默认adaptive(由模型按提示词选比例)。 - output_format:
mp4(默认)或mov。 - generate_audio:默认
true,生成与画面同步的对白、音效与背景声。
除 prompt 外都有默认值,最小请求只需要 prompt。请求体会做严格校验:多传未声明的字段会被拒绝,而不是被静默丢弃——这让联调阶段的错误暴露在提交时,而不是在计费之后。
按秒怎么计费
计费口径是「每秒单价 × 输出秒数」,与分辨率档位挂钩:
- 480p:$0.0679/秒
- 720p:$0.1525/秒
输出秒数取请求里的 duration,不做四舍五入的意外处理。举例:480p 5 秒是 $0.3395,720p 5 秒是 $0.7625;480p 30 秒是 $2.037,720p 30 秒是 $4.575。时长翻倍,费用就翻倍,没有「越长越便宜」的折扣。
这意味着三件事:第一,预算估算就是乘法,先定单条时长再乘条数;第二,重试就是重复付费,失败重试必须设上限;第三,长片不要一次生成,拆成多段短片分别生成再拼接,既省钱也让失败只影响坏掉的那一段。
接入形态:异步任务
视频生成是耗时任务,接口是异步的:提交后拿到任务标识,再轮询或等回调取结果,最后下载产物落库。不要把它包成同步 RPC 阻塞用户请求。
- 状态机落库:任务标识、状态、请求参数存数据库,不要只放进程内存——重启丢任务等于钱花了没结果。
- 轮询退避:起步间隔短、逐步拉长并加抖动,同时给每个任务设总超时,超时进失败分支而不是无限轮询。
- 错误分类:参数错误、内容违规属于确定性失败,重试没有意义;网络抖动、限流这类瞬时错误才值得退避重试。
- 幂等:提交侧带业务唯一键,避免用户重复点击产生多条任务和重复计费。
提示词怎么写才稳定
按「主体 → 动作顺序 → 环境与光线 → 镜头」四段来写,比堆一串形容词稳定得多。
主体:一只白色的猫坐在窗台上,逆光
动作:从静止到抬头望向窗外,尾巴缓慢摆动
环境与光线:午后暖光,浅景深,室内安静的氛围
镜头:中景,固定机位,轻微手持感
三条纪律:一条提示词只讲一个连续镜头,别把多场景切换塞进一次生成;提示词版本化,每次只改一个变量,才能判断是哪处改动起了作用;先小样后批量,别用批量去验证一个还没定的提示词。
画幅和镜头语言用自然语言描述即可——模型没有单独的「运镜」参数,把它写进提示词里,比期待一个不存在的字段更可靠。
上线路径
- 跑通链路:三条覆盖典型场景的提示词,确认提交、轮询、下载全通,先不看效果好不好。
- 定提示词与时长:固定少量提示词,对比不同写法与不同时长下的产出,记录每条的费用,形成可复用的模板库。
- 灰度放量:按比例放量,观察成功率、平均耗时、重试率与费用曲线,三项达标再加量。
- 常态运营:定期复盘模板库、清理低效写法、盯住费用趋势与重试阈值。
模型页上有最新的参数说明与价格,接入前对一遍即可。