Seedance 2.5 API 实战:商品图生成竖屏视频

更新于

准备一张商品图,用 Seedance 2.5 生成一条 9:16、720p、5 秒的商品短片。下面用「参考生视频」,方便直接指定竖屏比例。

准备商品图、提交保存任务 ID、查询并下载 MP4
流程示意。生成要等待;保存任务 ID 后可以回来继续查询。

1. 准备一张商品图和令牌

先创建 QuickRouter API Key,确认令牌可调用 doubao-seedance-2-5-260628。在模型价格页搜索完整模型 ID,核对所选分组的计价。图片用可以公开读取的 HTTPS 直链,不能填本机路径、localhost 或需要登录的网盘页面。

一只暖黄色保温杯置于干净背景上的商品参考图
自制示例素材,可下载作为输入;这是静态商品图。

下载示例商品图。将它上传到你自己的可访问 HTTPS 地址,也可以用自己的清晰商品图。

已有测试记录(2026-09-19):在 QuickRouter 创作工作台,同一张参考图以 Base64 提交失败,换成公开 HTTPS 直链后,480p、4 秒、关闭声音的任务生成成功。本文的 9:16、720p、5 秒是供读者操作的另一组参数。

2. 提交任务,保存返回的 ID

把下面内容保存为 request.json,换掉图片 URL。reference_image 是参考图;如果改成 first_frame,Seedance 2.5 的比例须用 adaptive,跟随首帧图。

{
  "model": "doubao-seedance-2-5-260628",
  "content": [
    {
      "type": "text",
      "text": "参考图片中的保温杯,保持形状、颜色和杯盖一致。柔和自然光,镜头缓慢推近,不加字幕。"
    },
    {
      "type": "image_url",
      "image_url": {
        "url": "https://YOUR-PUBLIC-IMAGE-URL/product.png"
      },
      "role": "reference_image"
    }
  ],
  "omni_reference_task_type": "reference",
  "ratio": "9:16",
  "resolution": "720p",
  "duration": 5,
  "generate_audio": false,
  "watermark": false
}

将脚本和 request.json 放到同一个文件夹,并在终端进入该目录。Windows 若没有 python3,用 py -3。按你的系统设置 API Key,然后下载 Python 示例脚本。脚本只需 Python 3 标准库。

macOS / Linux:

printf 'QuickRouter API Key: '; read -rs QUICKROUTER_API_KEY; printf '\n'
export QUICKROUTER_API_KEY

Windows PowerShell 7.2+:

$env:QUICKROUTER_API_KEY = Read-Host -MaskInput "QuickRouter API Key"

在同一终端启动客户端。打开新终端后需要重新设置变量。

python3 seedance-25-product-video.py create request.json

创建成功时脚本会显示任务 ID,并保存到 seedance-task-id.txt。创建请求发到 POST /api/v3/contents/generations/tasks。

3. 查询任务并下载 MP4

python3 seedance-25-product-video.py download

脚本从刚保存的任务 ID 查询 GET /api/v3/contents/generations/tasks/{id}。queued 或 running 会继续等;succeeded 时读取 content.video_url 并保存为 product-video.mp4。

查询状态 queued 或 running 时继续等,succeeded 下载,failed 查看错误
任务状态示意。超时后重复执行 download,继续查同一个 ID。

若创建请求超时,先去控制台任务日志确认是否已生成任务,再决定是否重新提交。链接可能过期,成功后及时下载。遇到 failed 时看错误详情,优先检查图片 URL、令牌和分组权限。

4. 检查成片和这一次的费用

打开 MP4,检查画面是否竖屏、商品外观是否保持一致。到控制台使用日志或任务日志,用本次提交时间、令牌、模型和任务 ID 对照。记下实际扣费以及分辨率、时长和分组;价格以自己的账单为准。

本文的请求结构按 Seedance 2.5 官方规则与 QuickRouter 工作台现有配置整理,插图用于解释操作。QuickRouter 2.5 型号和入口 · 通用视频任务排错

想在 ComfyUI 里先改写提示词?查看ComfyUI 提示词教程。

在线客服