如何使用 seedance-2-0 reference-to-video API：视频转视频接入指南（2026）

seedance-2-0 reference-to-video 是一款视频转视频模型（由 Doubao 提供）：Seedance 2.0 的“参考生视频”功能是视觉统一的终极方案。它能精准提取参考素材的艺术风格、光影基调或构图意向，并将其完美融入新生成的视频中，确保您的系列创作拥有高度一致的视觉语言。在 NamiFusion 上可以在 Playground 直接试玩（提交前显示准确报价），再通过统一 REST API 一行代码接入，典型一次调用约 $0.150。

TL;DR

· 任务类型：视频转视频，由 Doubao 提供

· 价格：典型一次约 $0.150（$1 = 100 积分），按量计费无订阅

· 上手路径：Playground 试玩（提交前显示报价）→ API Keys 建密钥 → 一个 POST 接入

· 可调参数：10 个（见下方参数表）

· 无平台水印，商用可用（遵守服务条款）

用 seedance-2-0 reference-to-video 能做什么？

短视频与广告片段：从一句话或一张图直接产出可发布的动态素材。

产品演示与概念预览：低成本验证分镜和视觉方向，再决定是否实拍。

社媒内容工厂：批量生成竖屏短片，配合热点话题快速上线。

已有素材的二次创作：图生视频让静态作品动起来，延长内容生命周期。

怎么调用这个 API？

1. 在 NamiFusion 注册并在 API Keys 页面创建密钥（注册送免费积分）。

2. 用下面的 cURL 示例提交任务，Header 带上 Bearer 密钥。

3. 用返回的 task_uuid 轮询任务状态，完成后取输出 URL。

# 1) Submit — returns { "task_uuid": "..." }
curl -X POST "https://www.namifusion.com/api/v1/marketplace/run/doubao/seedance-2-0/reference-to-video" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "input": {
    "images": [
      "https://assets-public.namifusion.com/uploads/images/2026-04-10/a9489888297a.png",
      "https://assets-public.namifusion.com/marketplace/images/2026-04-10/6abd3e6e8a4e.jpeg"
    ],
    "prompt": "The puppy in @Image2 is running on the beach in @Image1.",
    "generate_audio": true,
    "resolution": "720p",
    "ratio": "16:9",
    "duration": 7,
    "watermark": false,
    "seed": -1
  }
}'

# 2) Poll until status is "completed", then read the output URLs
curl "https://www.namifusion.com/api/v1/marketplace/run/tasks/TASK_UUID" \
  -H "Authorization: Bearer YOUR_API_KEY"

有哪些参数？

images（图片组）：可选

audios（音频组）：可选

prompt（提示词）：可选

generate_audio（生成音频）：可选，默认 true

resolution（分辨率）：可选，默认 "720p"

ratio（画面比例）：可选，默认 "adaptive"

duration（视频时长 (秒)）：必填，默认 5

return_last_frame（返回生成视频的尾帧图像）：可选

watermark（添加水印）：可选，默认 false

seed（随机种子）：可选，默认 -1

seedance-2-0 reference-to-video 的提示词怎么写？

1. 主体在前：先写画面主角与动作，再补环境、光线、风格（"一名宇航员在雨中的霓虹街头奔跑，电影感，浅景深"）。

2. 用具体名词代替形容词堆砌："85mm 人像镜头、黄昏逆光" 比 "非常好看、超高质量" 有效得多。

3. 迭代时只改一个变量：固定 seed 复现结果，每次只调整一个描述词，才能知道是什么在起作用。

4. 负面信息放正面写：与其说"不要模糊"，不如直接要"锐利对焦、清晰细节"。

价格是多少？

按次积分计价，典型一次调用约 $0.150（$1 = 100 积分），实际价格随参数（分辨率/时长等）变化，Playground 里提交前会显示准确报价。