CheaperGen APIドキュメント

MCP

AIエージェントで作成

Claude、ChatGPT、Cursor、Codexに動画や画像の生成を頼むだけで、残高から支払って生成できます。この文を一度エージェントに貼り付けてください。

Set up CheaperGen for me by following https://cheapergen.com/agents/setup.md

プロンプトをコピー

Setup for each agent

lib/cheapergen.ts

export async function generate(prompt) {
  const res = await fetch(`${BASE}/run/${MODEL}`, {
    headers: { Authorization: `Bearer ${process.env.CHEAPERGEN_API_KEY}` },
    body: JSON.stringify({ prompt, max_cost_usd: 1 }),

REST API

コーディングエージェントで開発

Claude Code、Cursor、Codexが、環境変数にキーを設定し、無料テストも行いながら、アプリから当社APIを呼び出すコードを作成します。

Add CheaperGen video and image generation to this project by following https://cheapergen.com/agents/integrate.md

プロンプトをコピー

エージェントが参照する情報

自分でコードを書く場合は？クイックスタート·コードを書かずに使う場合は？Studioを開く

ベースURL#

すべてのエンドポイントは、バージョン管理された1つのベースURLにあります。リクエストとレスポンスはHTTPS経由のJSONで、金額は米ドルです。

仕組み#

1. 送信：生成をPOST /api/v1/run/{endpoint}に送信します。料金は前払い残高から確保され、status: "queued"（HTTP 202）を含む生成オブジェクトが返されます。
2. 完了を待つには、数秒ごとにGET /api/v1/generations/{id}をポーリングするか、webhook_urlを指定すると結果をPOSTで受け取れます。詳しくは生成をご覧ください。
3. ダウンロード：出力はoutput.video.urlまたはoutput.images[].urlから取得できます。ジョブに失敗した場合は確保額が自動返金されます。失敗した生成に料金はかかりません。

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
}'

モデル#

モデルごとにタスク別のエンドポイントがあります（例：テキストから動画、画像から動画）。リクエスト形式は共通で、モデルの入力項目と任意のwebhook_urlを指定します。料金付きの一覧はモデルページで確認するか、GET /api/v1/modelsから取得できます。

• 動画： Seedance 2.0, Seedance 2.5, Seedance 2.0 Fast, Seedance 2.0 Mini, Kling 3.0, Kling 3.0 Omni, Kling 3.0 Turbo, Veo 3.1, Veo 3.1 Fast, Veo 3.1 Lite, Gemini Omni Flash, Wan 3.0, Wan 3.0 Prime, MiniMax H3, MiniMax H3 Max, MiniMax H3 Fast, Vidu Q3 Turbo, Vidu Q3 Pro, Vidu Q4, Grok Imagine Video 1.5, FLUX 3 Video, PixVerse V6, LTX-2.5
• 画像： Seedream 4.5, Seedream 5.0 Pro, Seedream 5.0 Lite, Seedream 5.0 Flash, Nano Banana Pro, Nano Banana 2.1, GPT Image 2.5, GPT Image 2.5 Flare, FLUX 3, FLUX 3 Image Klein, FLUX.2 [klein] 4B, FLUX.2 [pro], FLUX.2 [max], FLUX.2 [flex], FLUX.1 Kontext [pro], FLUX.1 Kontext [max], Grok Imagine Image 2.0, Qwen-Image 3.0 Pro, Qwen-Image 3.0, Z-Image Turbo, Krea 2 Turbo, MOSS Image

基本ルール#

• Authorization: Bearer cg_live_…を使った認証 — 詳しくは認証。
• 生成IDの接頭辞はgen_です。タイムスタンプはUTCのISO 8601形式です。金額フィールドは_usdで終わり、米ドルの10進数です。
• エラーは常に{ "error": { "code", "message", "param" } }の形式で、適切なHTTPステータスを伴います。詳しくはエラーをご覧ください。
• 未定義のリクエストパラメーターは400 invalid_requestで拒否されます。タイプミスによって出力が気付かないまま変わることはありません。
• 公開エンドポイント（/models、/quote）にはキーが不要で、ブラウザーから安全に呼び出せます。

AIエージェントとLLM向け#

APIとすべてのモデルの機械可読な概要は/llms.txtで確認できます。各モデルのAPIページには、APIと同じカタログから生成された完全な入力スキーマも掲載されています。

エージェントからCheaperGenを直接呼び出すこともできます。当社がホストするMCPサーバーをClaude Code、ChatGPT、Codex、Cursor、VS Codeに接続するか、CheaperGen Agent Skillをインストールしてください。コーディングエージェントに自分のプロジェクトへAPIを追加させる場合は、上記の「コーディングエージェント」の文を貼り付けてください。/agents/integrate.mdに沿ってコードを作成します。