Seedance 2.0 Mini API 中文教程：每秒 $0.0272 的视频接口

TL;DR

• seedance-2.0-mini 是字节跳动 Seedance 2.0 的轻量版。一个模型名就能做文生视频、图生视频（首帧或首尾帧）和参考生视频，自带同步声音。打开模型页 就能在线生成，新用户注册送 200 积分。
• 它是 HiAPI 上最便宜的视频模型之一：480p 每秒 $0.0272，720p 每秒 $0.0586。5 秒 480p 只要 $0.136。
• resolution 是必填项，不传会直接报错。下面给出 curl 和 Python 示例、全部参数，以及三种模式各自怎么算钱。

先看效果

三条文生视频，都是 5 秒 480p，每条 $0.136。

VIDEO

A slow dolly-in toward a steaming bowl of ramen on a worn wooden counter in a dim izakaya. Warm amber lantern light, soft volumetric haze, gentle steam curling upward, shallow depth of field, the broth surface rippling slightly. Cinematic, photoreal.

用这个提示词生成 →（5 秒、480p）

seedance-2.0-mini，文生视频，480p，5 秒，$0.136。

VIDEO

A cozy fireplace crackling in a log cabin at night, orange embers popping and drifting, a cast-iron kettle gently steaming on the hearth, rain streaking the dark window behind. Static locked-off shot. Native audio: crackling fire, soft rain on glass, a low wind.

用这个提示词生成 →（5 秒、480p）

seedance-2.0-mini，文生视频，480p，5 秒，带原生声音，$0.136。

这条的柴火声、雨声和风声，来自提示词最后一句。Mini 默认就会生成声音，但具体出什么声音，要靠提示词写清楚。

VIDEO

A border collie sprints across a sunlit beach toward the camera, kicking up wet sand, ears flapping, tongue out, water spray catching the low golden light. Tracking shot moving backward to keep the dog centered, motion blur on the paws, joyful energy, photoreal.

用这个提示词生成 →（5 秒、480p）

seedance-2.0-mini，文生视频，480p，5 秒，$0.136。

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-mini",
    "input": {
      "prompt": "雨夜霓虹赛博朋克街道，镜头缓缓推近，湿漉路面倒影斑斓，电影级氛围",
      "resolution": "480p",
      "duration": 5,
      "aspect_ratio": "16:9"
    }
  }'

5 秒 480p，$0.136。返回 data.taskId 后，用 GET /v1/tasks/{taskId} 查到 status 为 success，再下载 output[0].url。

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(timeout_s=900, **params):
    body = {"model": "seedance-2.0-mini", "input": 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)

# 图生视频：让一张图动起来，720p 5 秒（$0.293）
url = generate(
    prompt="镜头缓缓拉远，云雾在山峰间流动，金色晨光",
    first_frame_url="https://your-cdn.example.com/first-frame.jpg",
    resolution="720p", duration=5, generate_audio=False,
)
with open("clip.mp4", "wb") as f:
    f.write(requests.get(url).content)

一个模型，三种模式

传什么参数，就进入哪种模式：

参数一览

算一下费用

传了 reference_video_urls 时按另一档单价计费：480p 每秒 $0.0172，720p 每秒 $0.0358。$10 在 480p 下能生成约 367 秒。建议先用 480p 调提示词，定稿后再出 720p；要 1080p，就换 Seedance 2.0 或 Seedance 2.5。

上线前注意

• 用回调代替轮询：请求顶层（和 input 同级）加 "callback": {"url": "https://你的域名/hiapi/callback"}，按 taskId 去重。
• 及时转存：output[0].url 是临时链接。
• 重试带幂等键：请求头加 Idempotency-Key，同一个键重试只会创建一次任务。
• 失败自动退款：只按成功生成的视频计费。

常见问题

Seedance 2.0 Mini 和 Seedance 2.0 怎么选？

480p 下 Mini 的价格大约是 2.0 的五分之一（每秒 $0.0272 对 $0.136），但最高只到 720p。打草稿、批量出社媒短视频、测提示词用 Mini；要 1080p 或 4K 就换 Seedance 2.0。

不传 resolution 为什么报错？

这个模型的 resolution 是必填项，要显式写 "480p" 或 "720p"。

有声音吗？

默认有。在提示词里写清想要的声音；不要声音就把 generate_audio 设为 false。

一条最长多久？

4 到 15 秒。

想看更多写法，参考 Seedance 2.0 提示词指南；也可以直接去模型页生成拉面这条。