CheaperGen API-Dokumentation

MCP

Mit Ihrem KI-Agenten erstellen

Bitten Sie Claude, ChatGPT, Cursor oder Codex um ein Video oder Bild, und der Agent erstellt es. Die Kosten werden von Ihrem Guthaben abgezogen. Fügen Sie diesen Text einmal in Ihren Agenten ein.

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

Prompt kopieren

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

Mit Ihrem Coding-Agenten entwickeln

Claude Code, Cursor oder Codex schreibt den Code, der aus Ihrer App unsere API aufruft – mit dem Schlüssel in einer Umgebungsvariablen und einem kostenlosen Test.

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

Prompt kopieren

Was Ihr Agent liest

Schreiben Sie den Code selbst? Schnellstart·Kein Code? Studio öffnen

Basis-URL#

Alle Endpunkte verwenden eine einzige versionierte Basis-URL. Anfragen und Antworten sind JSON über HTTPS; die Beträge sind in US-Dollar angegeben.

So funktioniert es#

1. Absenden: eine Generierung mit POST /api/v1/run/{endpoint}. Der Preis wird von Ihrem vorausbezahlten Guthaben reserviert. Sie erhalten ein Generierungsobjekt mit status: "queued" (HTTP 202).
2. Warten Warten Sie auf den Abschluss: Fragen Sie den Status mit GET /api/v1/generations/{id} alle paar Sekunden ab oder übergeben Sie webhook_url. Wir senden Ihnen das Ergebnis dann per POST. Siehe Generierungen.
3. Herunterladen: die Ausgabe von output.video.url oder output.images[].url. Schlägt der Auftrag fehl, wird der reservierte Betrag automatisch erstattet – fehlgeschlagene Generierungen kosten nichts.

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": "Langsame Kamerafahrt auf einen Keramiker, der zur goldenen Stunde eine Vase formt, Staub im Licht, geringe Tiefenschärfe",
  "aspect_ratio": "16:9",
  "resolution": "720p",
  "duration": 5
}'

Modelle#

Jedes Modell stellt einen Endpunkt pro Aufgabe bereit, zum Beispiel für Text-zu-Video und Bild-zu-Video. Alle Endpunkte verwenden dieselbe Anforderungsstruktur: die Eingabefelder des Modells sowie optional webhook_url. Die vollständige Liste mit Preisen finden Sie auf der Seite Modelle oder können sie über GET /api/v1/models abrufen.

• Video: 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
• Bild: 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

Konventionen#

• Authentifizieren Sie sich mit Authorization: Bearer cg_live_… – siehe Authentifizierung.
• Generierungs-IDs beginnen mit gen_. Zeitstempel verwenden UTC im ISO-8601-Format. Geldbeträge enden auf _usd und sind in US-Dollar mit Dezimalstellen angegeben.
• Fehler haben immer das Format { "error": { "code", "message", "param" } } und einen aussagekräftigen HTTP-Statuscode – siehe Fehler.
• Unbekannte Anfrageparameter werden mit 400 invalid_request abgelehnt, damit Tippfehler Ihre Ausgabe nicht unbemerkt verändern.
• Öffentliche Endpunkte (/models, /quote) benötigen keinen API-Schlüssel und können sicher im Browser aufgerufen werden.

Für KI-Agenten und LLMs#

Eine maschinenlesbare Übersicht über die API und alle Modelle finden Sie unter /llms.txt. Für jedes Modell gibt es außerdem eine API-Seite mit dem vollständigen Eingabeschema, das aus demselben Katalog generiert wird, gegen den die API Anfragen validiert.

Agenten können CheaperGen auch direkt aufrufen: Verbinden Sie unser gehostetes MCP-Server mit Claude Code, ChatGPT, Codex, Cursor oder VS Code, oder installieren Sie den CheaperGen-Agent-Skill. Wenn ein Coding-Agent die API in Ihr eigenes Projekt einbauen soll, fügen Sie den Satz für „Coding-Agenten“ von oben ein: Er folgt /agents/integrate.md.