Documentation de l’API CheaperGen

MCP

Créer avec votre agent IA

Demandez à Claude, ChatGPT, Cursor ou Codex de créer une vidéo ou une image : le résultat est généré et payé sur votre solde. Copiez-collez ceci une fois dans votre agent.

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

Copier le prompt

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

Développer avec votre agent de programmation

Claude Code, Cursor ou Codex écrit le code qui appelle notre API depuis votre application, avec la clé dans une variable d’environnement et un test gratuit.

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

Copier le prompt

Ce que votre agent lit

Vous écrivez le code vous-même ? Démarrage rapide·Pas de code ? Ouvrir Studio

URL de base#

Tous les points de terminaison utilisent une seule URL de base versionnée. Les requêtes et réponses sont au format JSON sur HTTPS ; les montants sont en dollars américains.

Comment ça marche#

1. Pour lancer une génération avec POST /api/v1/run/{endpoint}, utilisez « Envoyer ». Le prix est réservé sur votre solde prépayé et l’API renvoie un objet de génération avec status: "queued" (HTTP 202).
2. Attendre la fin de la tâche : interrogez GET /api/v1/generations/{id} toutes les quelques secondes, ou indiquez un webhook_url pour que nous vous envoyions le résultat par POST. Voir Générations.
3. Télécharger Récupérez le résultat depuis output.video.url ou output.images[].url. Si la tâche échoue, le montant réservé est automatiquement recrédité : les générations échouées ne sont jamais facturées.

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": "Travelling avant lent sur un céramiste qui façonne un vase à l’heure dorée, poussière dans la lumière, faible profondeur de champ",
  "aspect_ratio": "16:9",
  "resolution": "720p",
  "duration": 5
}'

Modèles#

Chaque modèle expose un point de terminaison par tâche (par exemple, texte-vidéo ou image-vidéo). Tous utilisent la même structure de requête : les champs d’entrée du modèle et, éventuellement, un webhook_url. Parcourez la liste complète et les prix sur la page Modèles, ou récupérez-la via GET /api/v1/models.

• Vidéo : 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
• Image : 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

Conventions#

• Authentifiez-vous avec Authorization: Bearer cg_live_… — voir Authentification.
• Les identifiants de génération commencent par gen_. Les horodatages sont au format ISO 8601 (UTC). Les montants sont en dollars américains décimaux et se terminent par _usd.
• Les erreurs ont toujours la structure { "error": { "code", "message", "param" } } et un code d’état HTTP pertinent — voir Erreurs.
• Les paramètres inconnus sont rejetés avec 400 invalid_request, de sorte qu’une faute de frappe ne modifie jamais silencieusement le résultat.
• Les points de terminaison publics (/models, /quote) ne nécessitent pas de clé et peuvent être appelés sans risque depuis un navigateur.

Pour les agents IA et les LLM#

Un résumé lisible par machine de l’API et de chaque modèle est disponible sur /llms.txt. Chaque modèle dispose également d’une page API avec son schéma d’entrée complet, généré à partir du même catalogue que celui utilisé pour valider les requêtes.

Les agents peuvent aussi appeler CheaperGen directement : connectez notre Serveur MCP hébergé à Claude Code, ChatGPT, Codex, Cursor ou VS Code, ou installez le skill CheaperGen pour agents. Pour qu’un agent de programmation ajoute l’API à votre propre projet, copiez la phrase « coding agent » ci-dessus : elle suit /agents/integrate.md.