Seedance 2.0 Mini API チュートリアル：毎秒 $0.0272 の動画インターフェース

TL;DR

• seedance-2.0-mini は ByteDance の Seedance 2.0 の軽量版です。1つのモデル名でテキストから動画、画像から動画（先頭フレームまたは先頭・末尾フレーム）、参照から動画を生成でき、同期音声も備わっています。モデルページを開く とオンラインで生成でき、新規ユーザー登録で 200 クレジットが付与されます。
• HiAPI で最も安価な動画モデルの1つです：480p は毎秒 $0.0272、720p は毎秒 $0.0586。5 秒の 480p でわずか $0.136 です。
• resolution は必須項目で、指定しないと直接エラーになります。以下に curl と Python のサンプル、全パラメータ、そして3つのモードそれぞれの課金方法を示します。

まずは効果を見る

テキストから動画を3本、いずれも 5 秒 480p、1本あたり $0.136 です。

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。

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 はデフォルトで音声を生成しますが、具体的にどんな音が出るかはプロンプトで明確に指定する必要があります。

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)

1つのモデル、3つのモード

どのパラメータを渡すかで、どのモードになるかが決まります：

モード	渡すもの	説明
テキストから動画	prompt のみ
画像から動画	first_frame_url、必要に応じて last_frame_url も追加	参照画像、参照動画とは併用不可
参照から動画	reference_image_urls、reference_video_urls、reference_audio_urls	参照動画、参照音声はそれぞれ最大3本まで、合計時間はそれぞれ15秒以内

パラメータ一覧

パラメータ	値	説明
prompt	文字列、必須	中国語・英語どちらでも可
resolution	480p / 720p、必須	指定しない場合は 400 が返る
duration	4–15 の整数、必須（例では 5 を使用）	単位は秒
aspect_ratio	1:1 4:3 3:4 16:9 9:16 21:9 adaptive、デフォルト 16:9
generate_audio	デフォルト true	ネイティブ同期音声
first_frame_url / last_frame_url	画像 URL	jpeg/png/webp/bmp/tiff/gif、辺長 300–6000 px、1枚あたり 30 MB 未満
reference_image_urls	画像 URL	先頭・末尾フレームとの合計で最大9枚まで
reference_video_urls	最大3本	mp4/mov、480p または 720p、1本 2–15 秒、合計15秒以内
reference_audio_urls	最大3本	wav/mp3、1本 2–15 秒、合計15秒以内

費用を計算する

長さ	480p（$0.0272/秒）	720p（$0.0586/秒）
4 秒	$0.1088	$0.2344
5 秒	$0.136	$0.293
10 秒	$0.272	$0.586
15 秒	$0.408	$0.879

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 を追加すると、同じキーでのリトライは1回しかタスクを作成しません。
• 失敗時は自動返金：成功した動画のみ課金されます。

よくある質問

Seedance 2.0 Mini と Seedance 2.0 はどう選ぶ？

480p では Mini の価格は約 2.0 の5分の1（毎秒 $0.0272 対 $0.136）ですが、最高 720p までです。下書き、SNS 向けショート動画の一括生成、プロンプトのテストには Mini を、1080p や 4K が必要なら Seedance 2.0 に切り替えてください。

resolution を指定しないとエラーになるのはなぜ？

このモデルでは resolution が必須項目で、"480p" または "720p" を明示的に指定する必要があります。

音声はありますか？

デフォルトではあります。プロンプトで希望する音声を明確に指定してください。音声が不要な場合は generate_audio を false に設定します。

1本の最大の長さは？

4 〜 15 秒です。

さらに書き方の例を知りたい場合は Seedance 2.0 プロンプトガイド を参照してください。モデルページでラーメンの動画を生成する こともできます。