使用ガイド

Seedance 2.0 API の使い方：5分で最初の動画を生成

Mini、Fast、標準版の選び方、curl と Python の完全なサンプル、image-to-video、参照素材、ext ルートの書き方。

Oct 14, 2026

TL;DR

Seedance 2.0 は ByteDance の動画生成モデルで、HiAPI では Mini、Fast、標準版の3グレードに分かれています。モデルページを開くとオンラインで生成でき、新規ユーザー登録で200クレジットが付与されます。
秒単位の課金：Mini 720p は毎秒 $0.0586、標準版 720p は毎秒 $0.293、1080p は ext ルートで毎秒 $0.342。音声は追加料金なし。
API は2ステップだけ：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 の6種類のアスペクト比。image-to-video では adaptive で元画像に追従させることもできます。
image-to-video：最初のフレーム（first_frame_url）を渡し、さらに最後のフレーム（last_frame_url）で終了画面を制御できます。
マルチモーダル参照：最大9枚の参照画像、3本の参照動画、3本の参照音声で、人物、カメラワーク、リズムを固定できます。
ネイティブ音声：generate_audio はデフォルトで有効。環境音や効果音が映像と同期して生成されます。

以下の5秒 720p の製品ショットは、1つのプロンプトから直接生成したものです：

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.

このプロンプトで生成 →

2つの導入ルート

オンラインで試す（コード不要）

Seedance 2.0 モデルページを開き、登録またはログインします。
プロンプトを貼り付け、長さ、解像度、アスペクト比を選択します。
生成をクリックし、完成後にそのままダウンロードします（料金ページの5秒 720p ラテのサンプル3本は、送信から完了まで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 ルートに切り替えて高画質を出力します。

image-to-video とマルチモーダル参照

最初のフレームによる image-to-video：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 は最初のフレーム、参照画像、参照動画のうち1つを選択し、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 をすべて明示的に指定すると、費用が予算表と一致します。
失敗時は自動返金：失敗したタスクは課金されず、成功した生成秒数のみ課金されます。

よくある質問

Mini、Fast、標準版はどう選ぶ？

プロンプト調整には Mini、SNS 向けショート動画には Mini または Fast 720p、1080p / 4K が必要なら標準版または ext ルートを使います。詳しい料金は Seedance 2.0 API 料金を参照してください。

プロンプトは中国語で書けますか？

書けます。中国語も英語もサポートされており、カメラ、動作、光、音声を文を分けて明確に書くと最も安定します。

縦向き動画は生成できますか？

できます。aspect_ratio に 9:16 を指定し、image-to-video では adaptive を指定して最初のフレームの比率に追従させます。

1本の動画にどれくらい待つ？

料金ページの5秒 720p ラテのサンプル3本は、送信から完了まで168〜230秒かかりました。本番環境ではコールバックで結果を受け取り、固定の待ち時間に頼らないでください。

上のスマートウォッチのプロンプトをコピーして、モデルページで最初の動画を生成しましょう。すぐに使えるプロンプトをもっと見たい場合は、Seedance 2.0 プロンプト事例を参照してください。

タグSeedance 動画 API ガイドテキストから動画 API チュートリアル動画生成

すべての記事を見る →