Seedance 2.0 API 中文教程：5 分钟跑通

TL;DR

Seedance 2.0 是字节跳动的视频生成模型，在 HiAPI 上分 Mini、Fast、标准版三档，打开模型页就能在线生成，新用户注册送 200 积分。
按秒计费：Mini 720p 每秒 $0.0586，标准版 720p 每秒 $0.293，1080p 走 ext 线路每秒 $0.342；声音不加价。
API 只有两步：POST /v1/tasks 提交，拿 taskId 查结果。下面的 curl 和 Python 复制就能跑。

Seedance 2.0 能做什么？

文生视频：4–15 秒，480p 到 4K，16:9、9:16、1:1、4:3、3:4、21:9 六种画幅，图生视频还能用 adaptive 跟随原图。
图生视频：传首帧（first_frame_url），可再加尾帧（last_frame_url）控制结束画面。
多模态参考：最多 9 张参考图、3 段参考视频、3 段参考音频，用来锁定人物、运镜或节奏。
原生声音：generate_audio 默认开启，环境音和音效跟画面同步生成。

下面这条 5 秒 720p 的产品镜头，就是一句提示词直接出的：

A slow cinematic dolly-in on a sleek matte-black smartwatch resting on a
brushed-concrete pedestal, soft diffused studio light, the screen wakes to
show a glowing minimalist watch face, faint reflections move across the metal
bezel, premium tech commercial look, calm and clean.

用这个提示词生成 →

两条上手路线

在线试用（不写代码）

打开 Seedance 2.0 模型页，注册或登录。
粘贴提示词，选时长、分辨率和画幅。
点生成，出片后直接下载（价格页的三条 5 秒 720p 拿铁样片，从提交到完成用了 168–230 秒）。

API 调用

在控制台创建 API Key。
POST https://api.hiapi.ai/v1/tasks 提交任务，返回 taskId。
GET /v1/tasks/{taskId} 查状态，status 为 success 时从 output[0].url 下载视频。

curl：第一条视频

curl -X POST https://api.hiapi.ai/v1/tasks \
  -H "Authorization: Bearer $HIAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.0",
    "input": {
      "prompt": "A slow cinematic dolly-in on a sleek matte-black smartwatch resting on a brushed-concrete pedestal, soft diffused studio light.",
      "duration": 5,
      "resolution": "720p",
      "aspect_ratio": "16:9",
      "generate_audio": true
    }
  }'

{"code": 200, "data": {"taskId": "tk-hiapi-..."}, "message": "success"}

查结果：

curl https://api.hiapi.ai/v1/tasks/tk-hiapi-... \
  -H "Authorization: Bearer $HIAPI_KEY"

Python：提交、轮询、下载

# pip install requests；先 export HIAPI_KEY=你的 Key
import os, time, uuid, requests

KEY = os.environ["HIAPI_KEY"]
H = {"Authorization": f"Bearer {KEY}"}

def generate(prompt, model="seedance-2.0", timeout_s=900, **params):
    body = {"model": model, "input": {"prompt": prompt, **params}}
    # 同一个任务重试提交时带同一个 Idempotency-Key，避免重复扣费
    headers = {**H, "Idempotency-Key": str(uuid.uuid4())}
    r = requests.post("https://api.hiapi.ai/v1/tasks", json=body, headers=headers, timeout=30)
    r.raise_for_status()
    res = r.json()
    if res.get("code") != 200:
        raise RuntimeError(res)
    task_id = res["data"]["taskId"]
    deadline = time.time() + timeout_s
    while time.time() < deadline:
        d = requests.get(f"https://api.hiapi.ai/v1/tasks/{task_id}", headers=H, timeout=30).json()["data"]
        if d["status"] == "success":
            return d["output"][0]["url"]
        if d["status"] == "fail":
            raise RuntimeError(d)
        time.sleep(10)
    raise TimeoutError(task_id)

url = generate(
    "A barista pours steamed milk into a latte, camera slowly pulls back",
    model="seedance-2.0-mini", duration=5, resolution="480p", aspect_ratio="9:16",
)
with open("clip.mp4", "wb") as f:
    f.write(requests.get(url).content)

调提示词时把 model 换成 seedance-2.0-mini、分辨率用 480p，5 秒只要 $0.136；定稿后再换标准版或 ext 线路出高清。

图生视频和多模态参考

首帧图生视频：在 input 里加 first_frame_url，画幅写 adaptive 就会跟随图片比例：

{
  "model": "seedance-2.0",
  "input": {
    "prompt": "Slow cinematic push-in on the product with a soft light sweep, keep the product still and centered",
    "first_frame_url": "https://your-cdn.example.com/product.jpg",
    "aspect_ratio": "adaptive",
    "duration": 5,
    "resolution": "720p"
  }
}

参考图、参考视频、参考音频：分别用 reference_image_urls（参考图加首尾帧合计最多 9 张）、reference_video_urls（最多 3 段，合计不超过 15 秒）、reference_audio_urls（最多 3 段，合计不超过 15 秒）。

Mini 的输入组合：Mini 的首帧、参考图、参考视频三选一，duration 和 resolution 必填；标准版的 aspect_ratio 必填。

ext 线路：顶层加 "route": "ext"，模型名不变。ext 只有 720p、1080p、4K，每秒更便宜，但不收参考视频。

上线前注意

用回调代替轮询：请求顶层加 "callback": {"url": "https://你的域名/hiapi/callback"}，任务结束（成功或失败）时 HiAPI 主动通知；按 taskId 去重。
视频默认保存约 7 天：拿到 output[0].url 后转存到自己的存储；要长期保留，可以用 HiAPI 的持久存储（按存储量另计费）。
参数写全：duration、resolution、aspect_ratio 都显式写上，费用才能和预算表对上。
失败自动退款：失败任务不扣费，只按成功生成的秒数计费。