Seedance 2.5 API 实战:商品图生成竖屏视频
准备一张商品图,用 Seedance 2.5 生成一条 9:16、720p、5 秒的商品短片。下面用「参考生视频」,方便直接指定竖屏比例。
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_KEYWindows 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。
若创建请求超时,先去控制台任务日志确认是否已生成任务,再决定是否重新提交。链接可能过期,成功后及时下载。遇到 failed 时看错误详情,优先检查图片 URL、令牌和分组权限。
4. 检查成片和这一次的费用
打开 MP4,检查画面是否竖屏、商品外观是否保持一致。到控制台使用日志或任务日志,用本次提交时间、令牌、模型和任务 ID 对照。记下实际扣费以及分辨率、时长和分组;价格以自己的账单为准。
本文的请求结构按 Seedance 2.5 官方规则与 QuickRouter 工作台现有配置整理,插图用于解释操作。QuickRouter 2.5 型号和入口 · 通用视频任务排错
想在 ComfyUI 里先改写提示词?查看ComfyUI 提示词教程。