CheaperGen
ByteDanceチュートリアル

Seedance 2.5 APIの使い方

Seedance 2.5 APIの手順付きチュートリアル（Node.js、Python、cURL）。テキストから動画を生成ジョブを送信して、ポーリングまたはWebhookで状況を確認し、videoをダウンロードします。下記の例の料金は$1.04です。

エンドポイント
3
テキストから動画を生成 · 画像から動画を生成 · 参照素材から動画を生成
リクエスト例
$1.04
テキストから動画を生成
言語
3
Node.js · Python · cURL
失敗した実行
$0
自動返金
APIキーを取得Seedance 2.5で作成APIドキュメント
1

APIキーを取得

アカウントを作成し、クレジットを追加して、ダッシュボード → APIキーからキーを作成します。CHEAPERGEN_API_KEY サーバーに保存します。すべてのリクエストでBearerトークンとして送信してください。として保存してください。

Seedance 2.5 APIキーの取得方法
2

Seedance 2.5のエンドポイントを選択

タスクごとに専用のエンドポイントがあります。どのエンドポイントもJSON本文を受け取り、ポーリング可能な生成情報を返します。

Seedance 2.5 APIエンドポイント、必須入力、料金
タスクエンドポイント必須開始価格
テキストから動画を生成bytedance/seedance-2.5/text-to-videoprompt$0.0935 秒あたり
画像から動画を生成bytedance/seedance-2.5/image-to-videoprompt, image_url$0.0977 秒あたり
参照素材から動画を生成bytedance/seedance-2.5/reference-to-videoprompt$0.0977 秒あたり
3

テキストから動画を生成ジョブを送信

このプログラムはジョブを送信し、完了するまで3秒ごとにポーリングして、video URLを表示します。プロンプトと設定を独自の内容に置き換えてください。

const API = "https://cheapergen.com/api/v1";
const headers = {
  Authorization: `Bearer ${process.env.CHEAPERGEN_API_KEY}`,
  "Content-Type": "application/json",
};

// 1. Submit the job
let job = await fetch(`${API}/run/bytedance/seedance-2.5/text-to-video`, {
  method: "POST",
  headers,
  body: JSON.stringify({
    "prompt": "ゴールデンアワーの光の中、陶芸家が花瓶を形作る様子をゆっくり寄って撮影。光に浮かぶほこり、浅い被写界深度。",
    "aspect_ratio": "16:9",
    "resolution": "720p",
    "duration": 5
  }),
}).then((r) => r.json());

// 2. Poll until it finishes (or pass webhook_url and skip polling)
while (job.status === "queued" || job.status === "running") {
  await new Promise((r) => setTimeout(r, 3000));
  job = await fetch(`${API}/generations/${job.id}`, { headers }).then((r) => r.json());
}

console.log(job.status === "succeeded" ? job.output.video.url : job.error);
4

重要なパラメーターを設定する

各設定の内容と料金への影響（bytedance/seedance-2.5/text-to-video）。

Seedance 2.5のテキストから動画を生成パラメーターと料金への影響
パラメーター型 · デフォルト値説明料金への影響
aspect_ratiostring (enum) · 16:9出力フレームの形状。
16:9 · 9:16 · 1:1 · 4:3 · 3:4 · 21:9
16:9: $0.0935 秒あたり
resolutionstring (enum) · 720p出力解像度。高解像度では秒単価が上がります。
480p · 720p · 1080p
480p: $0.0935 秒あたり
720p: $0.2076 秒あたり
1080p: $0.5113 秒あたり
durationinteger · 5生成クリップの長さ（4〜30秒）。秒単位で課金されます。秒単位で課金
generate_audioboolean · true同期した音声、環境音、セリフを生成します。追加料金はありません。なし
seedinteger同じ結果を再現するには、seedと設定を同じにしてください。ランダムにする場合は空欄のままにします。なし

ほかのSeedance 2.5エンドポイントも、固有の入力項目を使って同じ形式で呼び出せます：

POST /api/v1/run/bytedance/seedance-2.5/image-to-video

{
  "prompt": "カメラがゆっくり近づき、彼女が振り向いて微笑む。風に髪がなびく。",
  "image_url": "https://cdn.cheapergen.com/samples/portrait.jpg",
  "aspect_ratio": "16:9",
  "resolution": "720p",
  "duration": 5
}

POST /api/v1/run/bytedance/seedance-2.5/reference-to-video

{
  "prompt": "大理石の机で、@Image1が@Image2の商品を開封する。@Video1のカメラワークを再現。",
  "reference_image_urls": [
    "https://cdn.cheapergen.com/samples/reference-1.jpg",
    "https://cdn.cheapergen.com/samples/reference-2.jpg"
  ],
  "reference_video_urls": [
    "https://cdn.cheapergen.com/samples/reference-1.mp4"
  ],
  "aspect_ratio": "16:9",
  "resolution": "720p",
  "duration": 5
}
5

結果を取得する

ジョブはqueuedからrunningを経て、succeeded、failed、またはcanceledに移行します。GET /api/v1/generations/{id}をポーリングするか、webhook_urlを指定すると結果をPOSTでお届けします。出力はダウンロードして、ご自身で保存してください。

200 — 成功
{
  "id": "gen_8c2QmX1nq0k4",
  "object": "generation",
  "model": "bytedance/seedance-2.5",
  "endpoint": "bytedance/seedance-2.5/text-to-video",
  "mode": "text-to-video",
  "status": "succeeded",
  "input": {
    "prompt": "ゴールデンアワーの光の中、陶芸家が花瓶を形作る様子をゆっくり寄って撮影。光に浮かぶほこり、浅い被写界深度。",
    "aspect_ratio": "16:9",
    "resolution": "720p",
    "duration": 5
  },
  "output": {
    "video": {
      "url": "https://cdn.cheapergen.com/outputs/gen_8c2Q.mp4",
      "content_type": "video/mp4",
      "duration": 5,
      "width": 1280,
      "height": 720
    }
  },
  "error": null,
  "cost": {
    "amount_usd": 0.2255,
    "currency": "usd",
    "estimated": false,
    "official_usd": 0.264,
    "list_price_source": "official",
    "list_price_label": "Official",
    "saved_usd": 0.0385
  },
  "source": "api",
  "created_at": "2026-10-15T09:21:04Z",
  "started_at": "2026-10-15T09:21:06Z",
  "completed_at": "2026-10-15T09:22:31Z"
}
Webhook署名を検証する
6

実行前にリクエストの料金を確認する

見積もりエンドポイントは無料で、APIキーも不要です。送信した入力内容に対する料金、公式価格、割引額を返します。

curl -X POST https://cheapergen.com/api/v1/quote/bytedance/seedance-2.5/text-to-video \
  -H "Content-Type: application/json" \
  -d '{"prompt":"ゴールデンアワーの光の中、陶芸家が花瓶を形作る様子をゆっくり寄って撮影。光に浮かぶほこり、浅い被写界深度。","aspect_ratio":"16:9","resolution":"720p","duration":5}'
APIエラーと対処方法
ステータスコード内容
400invalid_request必須パラメーターが不足しているか、範囲外です。エラーメッセージに該当項目が示されます。
401unauthorizedAPIキーがない、形式が不正、または失効しています。
402insufficient_balance見積もり料金に対してクレジットが不足しています。チャージするか、自動チャージを有効にしてください。
429rate_limitedリクエスト数または実行中の生成数が多すぎます。間隔を空けて再試行してください。
502upstream_errorモデルの提供元でエラーが発生しました。確保額は返金されるため、再試行できます。
503model_unavailable現在、正常に利用できるルートがありません。後でもう一度試すか、別のモデルを選んでください。
Seedance 2.5 APIの完全版ドキュメント

よくある質問

Seedance 2.5 APIに関するよくある質問

いいえ。APIはJSONを使った通常のHTTPS通信なので、このページにあるNode.js（fetch）とPython（requests）の例は、そのまま動作するプログラムです。HTTPリクエストを送信できる言語なら利用できます。

はい。リクエスト本文に「webhook_url」を追加すると、完了した生成をそのURLへPOSTします。CheaperGen-Signatureヘッダー（タイムスタンプと生の本文に対するHMAC-SHA256）で署名します。GET /api/v1/generations/{id}でポーリングする方法もあります。

公開URLを"image_url", "end_image_url", "reference_image_urls", "reference_video_urls", "reference_audio_urls"に渡してください。公開URLのないファイルは、POST /api/v1/uploadsで先にアップロードできます。レスポンスで返されるURLをリクエストに指定します。

テキストから動画を生成の開始価格は$0.0935 秒あたりです。このページのリクエスト例は$1.04、公式価格より10%安いです。生成に失敗した場合は自動返金されます。