说明:本文在 AI 辅助下生成。参数、限制和价格来自作者所在平台的接口文档与服务端代码,核对日期为 2026-10-25。
做电商或广告投放的团队,经常要一次出几十条 8–15 秒的商品短视频。在网页上逐条点生成不现实,改成调接口后又会碰到三个问题:输入方式有好几种,该选哪一种;按秒计费的模型,怎么在提交前算出这一批要花多少钱;一条视频要等几分钟,结果怎么稳妥地拿回来。
Seedance 2.5 是字节跳动的视频生成模型,单次可以生成 4–30 秒的视频,支持 480p 和 720p,一个任务最多带 50 份参考素材,并新增了视频编辑和视频延长两种任务。它适合需要较长单条时长、或需要用商品图和参考视频控制画面的批量出片场景。下面用一个兼容 OpenAI 风格的 HTTP 接口,按"选输入方式、提交、拿结果、算成本、处理失败"的顺序走一遍。
先说利益关系:文中用的接口是我们自己做的 apimodels.app。
requests。YOUR_API_KEY 占位。所有请求都发到同一个端点:创建任务用 POST /v1/video/generations,查询任务用 GET /v1/video/generations?task_id=...,鉴权放在 Authorization: Bearer 头里。
Seedance 2.5 的输入方式决定了哪些参数能用,选错了会在创建任务时直接返回 400,而不是排队几分钟后才失败。
prompt,可以自由指定 aspect_ratio(21:9、16:9、4:3、1:1、3:4、9:16)和 duration(4–30 秒)。first_frame_url,需要时再加 last_frame_url。用了首帧,画面比例会强制为 adaptive,跟随首帧图片。reference_image_urls 最多 30 张,reference_video_urls 和 reference_audio_urls 各最多 10 段,每段 2–30 秒、合计不超过 30 秒。提示词里按顺序用"图片1""视频1"或 @image1、@video1 指代它们。reference_video_urls 里,再用 task_type 声明 edit 或 extend。编辑会强制比例为 adaptive、时长为 -1(输出与源片等长),传了这两个参数就会被拒;延长只强制比例,时长可以自己定。另外两条容易踩的规则:首尾帧和参考素材互斥,同一个请求里只能用其中一种;参考视频的帧率不能太高,手机慢动作或录屏常见的 120fps 素材会被拒,先转成 30fps 再传。
商品视频最常用的是"参考素材"模式:把商品图作为图片1,让模型保持商品外观,再用提示词描述镜头和场景。
先用最简单的文生视频确认链路通了。下面的请求来自接口文档,只换了提示词:
curl -X POST https://api.apimodels.app/v1/video/generations \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "seedance-2.5",
"prompt": "a glass perfume bottle on a marble table, morning light sweeps across, slow push-in",
"resolution": "720p",
"aspect_ratio": "9:16",
"duration": 8
}'返回体里的 data.taskId 就是任务 ID,后面查询结果、核对扣费都靠它。resolution 不传时默认 720p;duration 传 -1 表示让模型自己决定时长,但这样每条的成本就没法事先确定,批量任务建议写死时长。
下面是一个批量脚本(示例),每个商品一条 10 秒竖屏视频,商品图作为参考图,提交时带上回调地址:
import requests
API_KEY = "YOUR_API_KEY"
B = "https://api.apimodels.app/v1/video/generations"
H = {"Authorization": f"Bearer {API_KEY}", "Content-Type": "application/json"}
products = [
{"sku": "A001", "image": "https://example.com/a001.png", "scene": "on a wooden desk by the window"},
{"sku": "A002", "image": "https://example.com/a002.png", "scene": "in a bright bathroom, water drops on the glass"},
]
tasks = {}
for p in products:
r = requests.post(B, headers=H, json={
"model": "seedance-2.5",
"prompt": f"The product in @image1 stands {p['scene']}. Slow orbit shot, soft daylight, keep the label readable.",
"reference_image_urls": [p["image"]],
"resolution": "480p",
"aspect_ratio": "9:16",
"duration": 10,
"generate_audio": False,
"callback_url": "https://your-domain.example/hooks/video",
})
r.raise_for_status()
tasks[p["sku"]] = r.json()["data"]["taskId"]
print(tasks)generate_audio 默认开启,会生成与画面同步的原生音频;商品视频如果后期统一配乐,可以关掉。callback_url 必须是公网可访问的地址,填 localhost 或内网地址会在创建任务时直接被拒,因为服务端根本连不过去。
视频生成以分钟计,结果有两种拿法,建议两种都实现:回调负责及时,轮询负责兜住回调没送达的情况。
轮询时,任务状态 state 有四个值:pending、processing、completed、failed。完成后视频地址在 data.resultUrls 里,文件保留 30 天,需要长期保存的话要自己转存。文档建议每 10–15 秒查一次:
import time
def wait(task_id, interval=15):
while True:
d = requests.get(B, headers=H, params={"task_id": task_id}).json()["data"]
if d["state"] == "completed":
return d["resultUrls"][0], d["credits"]
if d["state"] == "failed":
# retryable 为 True 表示是临时性故障,原样重提是合理的
raise RuntimeError(f"{d.get('failCode')}: {d.get('failMsg')} retryable={d.get('retryable')}")
time.sleep(interval)回调是一次 POST,JSON 结构是 {"code": 200, "msg": "success", "data": {...}}。data 里有 taskId、state、failCode、failMsg 和 credits(本单实扣金额,失败为 0)。要注意的是,回调里视频地址不在顶层,而是在 resultJson 这个字符串字段里,需要再解析一次。下面是一个接收端的写法(示例,Flask):
import json
from flask import Flask, request
app = Flask(__name__)
@app.post("/hooks/video")
def video_hook():
d = request.get_json()["data"]
if d["state"] == "completed":
urls = json.loads(d["resultJson"]).get("resultUrls", [])
save_result(d["taskId"], urls, d["credits"]) # 自己的入库逻辑
elif d["state"] == "failed":
mark_failed(d["taskId"], d["failCode"], d["failMsg"])
return "ok" # 返回 2xx,否则服务端会重试投递接收端要做到幂等:同一个 taskId 可能因为重试投递收到不止一次。
Seedance 2.5 按生成内容的实际 token 用量结算,折算下来 480p 约每秒 $0.120,720p 约每秒 $0.270,只在成功出片时扣费。估算公式就是"条数 × 每条秒数 × 每秒单价":
因为是按实际 token 结算,最终金额会和估算有小幅出入。每一单的准确扣费可以用 GET /v1/records/{task_id} 查,返回里的 settled 表示是否已结算,credits 是实扣美元金额,这个查询本身不收费,适合做逐单对账。
编辑和延长的计费口径不一样:按"源片秒数 + 输出秒数"计费,480p 每秒 $0.072、720p 每秒 $0.162。比如编辑一段 4.0 秒的 480p 视频、输出 3.7 秒,费用是 (4.0 + 3.7) × $0.072 ≈ $0.55。单价看起来更低,但源片的每一秒也要算钱,所以把一段和成片一样长的视频拿去编辑,会比直接重新生成同样长度贵 20% 左右。如果只是想要一条新视频,直接生成更划算。
失败的任务不扣费,冻结的金额会退回,所以失败本身不花钱,要花心思的是判断该不该重试。
retryable:为 true 说明是临时性问题,原样重新提交是合理的;为 false 通常是输入或内容本身的问题,重试多少次结果都一样,要改提示词或素材。asset:// 引用,每次注册 $0.01,只有成功才收费。apimodels.app 是一个多模型 API 网关:用一个 API key、一个 OpenAI 兼容端点调用图像、视频、语音和语言模型。对上面这套 Seedance 2.5 批量流程,它做了几件具体的事。
稳定性方面:
asset:// 注册素材的请求只能走其中一条,不在这个范围内。价格方面:480p 每秒 $0.120、720p 每秒 $0.270,按实际用量结算,不需要另外开通官方云平台账号,也没有开通时的预存门槛。
如果只需要文生或参考图生成,时长固定 15 秒或 30 秒也能接受,可以看 seedance-2.5-lite:720p,15 秒和 30 秒都是每条 $2.50,最多 9 张参考图,音频始终开启。它没有首尾帧和参考视频、参考音频,而且这一档的部分任务会失败(失败自动退款),我们 10 月 22 日自测一条 30 秒视频用了 401 秒。必须按时交付的任务,用 seedance-2.5 更稳妥。
以下几种情况不适合用 Seedance 2.5:
你在批量生成商品视频时,更常用参考图还是首帧?欢迎在评论区聊聊各自的提示词写法。
接口文档:apimodels.app 的 Seedance 2.5 接口文档;逐单计费查询:apimodels.app 的请求记录与实扣查询文档。
原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。
如有侵权,请联系 cloudcommunity@tencent.com 删除。