Documentazione API di CheaperGen

MCP

Crea con il tuo agente IA

Chiedi a Claude, ChatGPT, Cursor o Codex di creare un video o un’immagine e l’agente lo farà, usando il tuo saldo. Incolla questo testo nel tuo agente una sola volta.

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

Copia 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

Sviluppa con il tuo agente di programmazione

Claude Code, Cursor o Codex scrivono il codice che chiama la nostra API dalla tua app, con la chiave in una variabile d’ambiente e una prova gratuita.

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

Copia prompt

Cosa legge il tuo agente

Scrivi il codice da te? Guida rapida·Non vuoi scrivere codice? Apri Studio

URL di base#

Tutti gli endpoint usano un unico URL di base versionato. Richieste e risposte sono in JSON su HTTPS; gli importi sono in dollari USA.

Come funziona#

1. Invia Invia una generazione a POST /api/v1/run/{endpoint}. Il prezzo viene trattenuto dal saldo prepagato e ricevi un oggetto generazione con status: "queued" (HTTP 202).
2. Attendi che termini: fai polling su GET /api/v1/generations/{id} ogni pochi secondi oppure passa webhook_url e ti invieremo il risultato con POST. Consulta Generazioni.
3. Scarica il risultato da output.video.url o output.images[].url. Se il job non riesce, l’importo bloccato viene rimborsato automaticamente: non paghi per le generazioni non riuscite.

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": "Lento avvicinamento a un ceramista che modella un vaso all’ora dorata, polvere sospesa nella luce, profondità di campo ridotta",
  "aspect_ratio": "16:9",
  "resolution": "720p",
  "duration": 5
}'

Modelli#

Ogni modello ha un endpoint per attività (per esempio text-to-video e image-to-video) e tutti gli endpoint usano lo stesso formato di richiesta: i campi di input del modello più un webhook_url facoltativo. Consulta l’elenco completo con i prezzi nella pagina Modelli, oppure recuperalo da GET /api/v1/models.

• 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
• Immagine: 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

Convenzioni#

• Autenticati con Authorization: Bearer cg_live_… — consulta Autenticazione.
• Gli ID delle generazioni iniziano con gen_. I timestamp sono in formato ISO 8601 e UTC. I campi monetari terminano con _usd e sono importi decimali in dollari USA.
• Gli errori hanno sempre il formato { "error": { "code", "message", "param" } } e uno stato HTTP significativo — consulta Errori.
• I parametri di richiesta sconosciuti vengono rifiutati con 400 invalid_request, così gli errori di battitura non modificano mai l’output senza avviso.
• Gli endpoint pubblici (/models, /quote) non richiedono una chiave e possono essere chiamati in sicurezza dal browser.

Per agenti IA e LLM#

Una panoramica dell’API e di tutti i modelli leggibile dalle macchine è disponibile in /llms.txt. Ogni modello ha anche una pagina API con lo schema di input completo, generato dallo stesso catalogo usato per la convalida dell’API.

Gli agenti possono anche chiamare CheaperGen direttamente: collega il nostro Server MCP ospitato a Claude Code, ChatGPT, Codex, Cursor o VS Code, oppure installa il skill per agenti CheaperGen. Per fare aggiungere l’API a un tuo progetto da un agente di programmazione, incolla la frase “agente di programmazione” qui sopra: seguirà /agents/integrate.md.