クイックスタート

このガイドではSeedance 2.0 Fastを使い、最初の動画を作成するまでを説明します。ほかのモデルでも手順は同じで、変わるのはエンドポイントと入力項目だけです。

1. アカウントとAPIキーを作成する

   サインイン Googleまたはメールでサインインし、ダッシュボード → APIキーを開いてキーを作成します。形式はcg_live_…で、表示は一度だけです。安全な場所にコピーしてください。

2. クレジットを追加

   CheaperGenは前払い制です。次でクレジットを追加します： ダッシュボード → お支払い。以下の例の料金は $0.45 — $0.605 の the official price。生成に失敗した場合は自動返金されます。詳しくは お支払いとクレジット.

3. APIキーを設定する

   キーをコードに含めないでください。このドキュメントの例では、すべて環境変数からキーを読み込みます：

   コピー

   export CHEAPERGEN_API_KEY="cg_live_..."

4. 生成を送信

   モデルの入力をPOST /api/v1/run/bytedance/seedance-2.0-fast/text-to-videoへ送信してください。下のスクリプトはジョブを送信し、完了までポーリングして動画URLを表示します。

   JavaScriptPythoncURL

   コピー

   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.0-fast/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);

   コピー

   import os, time, requests
   
   API = "https://cheapergen.com/api/v1"
   headers = {"Authorization": f"Bearer {os.environ['CHEAPERGEN_API_KEY']}"}
   
   # 1. Submit the job
   job = requests.post(f"{API}/run/bytedance/seedance-2.0-fast/text-to-video", headers=headers, json={
       "prompt": "ゴールデンアワーの光の中、陶芸家が花瓶を形作る様子をゆっくり寄って撮影。光に浮かぶほこり、浅い被写界深度。",
       "aspect_ratio": "16:9",
       "resolution": "720p",
       "duration": 5
   }).json()
   
   # 2. Poll until it finishes (or pass "webhook_url" and skip polling)
   while job["status"] in ("queued", "running"):
       time.sleep(3)
       job = requests.get(f"{API}/generations/{job['id']}", headers=headers).json()
   
   print(job["status"], job["output"]["video"]["url"] if job["status"] == "succeeded" else job["error"])

   コピー

   curl -X POST https://cheapergen.com/api/v1/run/bytedance/seedance-2.0-fast/text-to-video \
     -H "Authorization: Bearer $CHEAPERGEN_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{
     "prompt": "ゴールデンアワーの光の中、陶芸家が花瓶を形作る様子をゆっくり寄って撮影。光に浮かぶほこり、浅い被写界深度。",
     "aspect_ratio": "16:9",
     "resolution": "720p",
     "duration": 5
   }'

   APIは直ちに202 Acceptedと、queued状態の生成情報を返します。cost.amount_usdに表示された料金は、ジョブ実行中に残高から確保されます。

   202 Accepted

   コピー

   {
     "id": "gen_8c2QmX1nq0k4Lw7Z",
     "object": "generation",
     "model": "bytedance/seedance-2.0-fast",
     "endpoint": "bytedance/seedance-2.0-fast/text-to-video",
     "mode": "text-to-video",
     "status": "queued",
     "input": {
       "prompt": "ゴールデンアワーの光の中、陶芸家が花瓶を形作る様子をゆっくり寄って撮影。光に浮かぶほこり、浅い被写界深度。",
       "aspect_ratio": "16:9",
       "resolution": "720p",
       "duration": 5,
       "generate_audio": true
     },
     "output": null,
     "error": null,
     "cost": {
       "amount_usd": 0.4494,
       "currency": "usd",
       "estimated": true
     },
     "source": "api",
     "created_at": "2026-10-15T09:21:04.512Z",
     "started_at": null,
     "completed_at": null,
     "retention": "1d",
     "expires_at": null,
     "purged_at": null,
     "urls": {
       "get": "https://cheapergen.com/api/v1/generations/gen_8c2QmX1nq0k4Lw7Z",
       "cancel": "https://cheapergen.com/api/v1/generations/gen_8c2QmX1nq0k4Lw7Z/cancel"
     }
   }

5. 結果を取得する

   statusがsucceededまたはfailedになるまで生成情報をポーリングします。動画は通常1〜数分、画像は数秒で完了します。

   コピー

   curl https://cheapergen.com/api/v1/generations/gen_8c2QmX1nq0k4Lw7Z \
     -H "Authorization: Bearer $CHEAPERGEN_API_KEY"

   200 OK

   コピー

   {
     "id": "gen_8c2QmX1nq0k4Lw7Z",
     "object": "generation",
     "model": "bytedance/seedance-2.0-fast",
     "endpoint": "bytedance/seedance-2.0-fast/text-to-video",
     "mode": "text-to-video",
     "status": "succeeded",
     "input": {
       "prompt": "ゴールデンアワーの光の中、陶芸家が花瓶を形作る様子をゆっくり寄って撮影。光に浮かぶほこり、浅い被写界深度。",
       "aspect_ratio": "16:9",
       "resolution": "720p",
       "duration": 5,
       "generate_audio": true
     },
     "output": {
       "video": {
         "url": "https://cdn.cheapergen.com/outputs/gen_8c2QmX1nq0k4Lw7Z.mp4",
         "content_type": "video/mp4"
       }
     },
     "error": null,
     "cost": {
       "amount_usd": 0.4494,
       "currency": "usd",
       "estimated": false
     },
     "source": "api",
     "created_at": "2026-10-15T09:21:04.512Z",
     "started_at": "2026-10-15T09:21:09.031Z",
     "completed_at": "2026-10-15T09:22:31.870Z",
     "retention": "1d",
     "expires_at": "2026-10-16T09:22:31.870Z",
     "purged_at": null
   }

   Webhookでポーリングを省略する

   リクエスト本文に"webhook_url": "https://your-app.com/hooks/cheapergen"を追加すると、完了した生成をこちらからPOSTします。詳しくはWebhookをご覧ください。

次のステップ#

• 生成のライフサイクルを理解する — ステータス、ポーリング間隔、キャンセル、出力。
• モデルを選ぶ — すべてのエンドポイントIDと、秒または画像1枚あたりの料金。
• エラーに対処する — 再試行するレスポンスと、修正が必要なレスポンス。
• APIリファレンス Seedance 2.0 Fast — すべての入力項目、型、デフォルト値。