首页
学习
活动
专区
圈层
工具
发布
社区首页 >专栏 >Seedance 2.5 API 实战:批量生成 4–30 秒商品短视频,480p 每秒 $0.12 起

Seedance 2.5 API 实战:批量生成 4–30 秒商品短视频,480p 每秒 $0.12 起

原创
作者头像
用户7679731
发布于 2026-10-25 19:46:52
发布于 2026-10-25 19:46:52
9250
举报

说明:本文在 AI 辅助下生成。参数、限制和价格来自作者所在平台的接口文档与服务端代码,核对日期为 2026-10-25。

做电商或广告投放的团队,经常要一次出几十条 8–15 秒的商品短视频。在网页上逐条点生成不现实,改成调接口后又会碰到三个问题:输入方式有好几种,该选哪一种;按秒计费的模型,怎么在提交前算出这一批要花多少钱;一条视频要等几分钟,结果怎么稳妥地拿回来。

Seedance 2.5 是字节跳动的视频生成模型,单次可以生成 4–30 秒的视频,支持 480p 和 720p,一个任务最多带 50 份参考素材,并新增了视频编辑和视频延长两种任务。它适合需要较长单条时长、或需要用商品图和参考视频控制画面的批量出片场景。下面用一个兼容 OpenAI 风格的 HTTP 接口,按"选输入方式、提交、拿结果、算成本、处理失败"的顺序走一遍。

先说利益关系:文中用的接口是我们自己做的 apimodels.app。

准备工作

  • Python 3.9 及以上,安装 requests。
  • 一个 API key,下文用 YOUR_API_KEY 占位。
  • 素材用公网可访问的 https 链接。请求体里直接塞 Base64 的话,整个请求体上限是 64 MB,大文件建议传链接。

所有请求都发到同一个端点:创建任务用 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,让模型保持商品外观,再用提示词描述镜头和场景。

第一步:提交一个文生视频任务

先用最简单的文生视频确认链路通了。下面的请求来自接口文档,只换了提示词:

代码语言:bash
复制
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 秒竖屏视频,商品图作为参考图,提交时带上回调地址:

代码语言:python
复制
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 秒查一次:

代码语言:python
复制
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):

代码语言:python
复制
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,只在成功出片时扣费。估算公式就是"条数 × 每条秒数 × 每秒单价":

  • 20 条 × 10 秒 × 480p:200 秒 × $0.120 ≈ $24.00
  • 20 条 × 10 秒 × 720p:200 秒 × $0.270 ≈ $54.00

因为是按实际 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 通常是输入或内容本身的问题,重试多少次结果都一样,要改提示词或素材。
  • 创建时的 400 不算失败:比例、时长、互斥输入不合规时,接口会在创建阶段直接返回 400 和原因,不会生成任务,也不会冻结费用。
  • 真人素材:含真人的参考图可以直接传链接,被上游审核拦下时,服务端会自动把素材注册进素材库再重试一次,只是多几秒延迟。需要跨任务反复使用同一个人物时,可以先注册成 asset:// 引用,每次注册 $0.01,只有成功才收费。

apimodels.app 在这套流程里的位置

apimodels.app 是一个多模型 API 网关:用一个 API key、一个 OpenAI 兼容端点调用图像、视频、语音和语言模型。对上面这套 Seedance 2.5 批量流程,它做了几件具体的事。

稳定性方面:

  • Seedance 2.5 有两条上游线路互为备份,主线路报错时,任务会自动转到另一条,调用方不需要改代码。用 asset:// 注册素材的请求只能走其中一条,不在这个范围内。
  • 失败不扣费。
  • 参数冲突在创建时就返回 400,不会排队几分钟后才失败。
  • 支持回调和逐单实扣查询,方便对账。

价格方面: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:

  • 需要 1080p 或 4K 输出。2.5 只有 480p 和 720p。
  • 一共只做几条视频。在网页上手动生成就够了,没必要接接口。
  • 已经直接接好官方接口、也不需要备用线路的团队,换过来收益不大。

限制

  • 分辨率只有 480p 和 720p;单条最长 30 秒,更长的视频需要用延长任务分段接续。
  • 每秒单价是按 token 折算的展示值,实际扣费以完成时的 token 为准。
  • 结果文件保留 30 天。
  • 本文的参数和价格以 2026-10-25 的接口文档为准,之后如有调整以文档为准。

你在批量生成商品视频时,更常用参考图还是首帧?欢迎在评论区聊聊各自的提示词写法。


接口文档:apimodels.app 的 Seedance 2.5 接口文档;逐单计费查询:apimodels.app 的请求记录与实扣查询文档。

原创声明:本文系作者授权腾讯云开发者社区发表,未经许可,不得转载。

如有侵权,请联系 cloudcommunity@tencent.com 删除。

目录
  • 准备工作
  • 先选输入方式:四种模式互相有约束
  • 第一步:提交一个文生视频任务
  • 第二步:批量提交带商品图的任务
  • 第三步:拿结果,轮询和回调都要有
  • 第四步:提交前先算出这一批的成本
  • 失败了怎么处理
  • apimodels.app 在这套流程里的位置
  • 限制
问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档