Documentación de la API de CheaperGen

MCP

Crea con tu agente de IA

Pídele a Claude, ChatGPT, Cursor o Codex que genere un video o una imagen y lo hará con cargo a tu saldo. Pega esto en tu agente una sola vez.

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

Copiar 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

Desarrolla con tu agente de programación

Claude Code, Cursor o Codex escribe el código que llama a nuestra API desde tu aplicación, con la clave en una variable de entorno y una prueba gratuita.

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

Copiar prompt

Qué lee tu agente

¿Vas a escribir el código tú? Inicio rápido·¿No quieres programar? Abrir Studio

URL base#

Todos los endpoints usan una única URL base versionada. Las solicitudes y respuestas son JSON por HTTPS; los importes se expresan en dólares estadounidenses.

Cómo funciona#

1. Enviar una generación con POST /api/v1/run/{endpoint}. El precio se reserva de tu saldo prepagado y recibirás un objeto de generación con status: "queued" (HTTP 202).
2. Esperar para que termine: consulta GET /api/v1/generations/{id} cada pocos segundos o proporciona webhook_url y te enviaremos el resultado mediante una solicitud POST. Consulta Generaciones.
3. Obtén el resultado de Descargar o output.video.url o output.images[].url. Si la tarea falla, el importe reservado se reembolsa automáticamente; nunca pagas por generaciones fallidas.

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 lento hacia un ceramista que da forma a un jarrón a la hora dorada; polvo en la luz y poca profundidad de campo",
  "aspect_ratio": "16:9",
  "resolution": "720p",
  "duration": 5
}'

Modelos#

Cada modelo ofrece un endpoint por tarea (por ejemplo, texto a video e imagen a video) y todos usan el mismo formato de solicitud: los campos de entrada del modelo y un webhook_url opcional. Explora la lista completa con precios en la página Modelos o consúltala mediante GET /api/v1/models.

• Videos: 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
• Imagen: 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

Convenciones#

• Autentícate con Authorization: Bearer cg_live_…; consulta Autenticación.
• Los ID de generación empiezan por gen_. Las marcas de tiempo usan ISO 8601 en UTC. Los importes terminan en _usd y se expresan en dólares estadounidenses decimales.
• Los errores siempre siguen el formato { "error": { "code", "message", "param" } } y usan un estado HTTP significativo; consulta Errores.
• Los parámetros desconocidos se rechazan con 400 invalid_request, así que los errores tipográficos nunca cambian el resultado sin avisar.
• Los endpoints públicos (/models, /quote) no requieren una clave y se pueden llamar de forma segura desde un navegador.

Para agentes de IA y LLM#

Hay un resumen legible por máquinas de la API y de todos los modelos en /llms.txt. Cada modelo también tiene una página de API con su esquema completo de entrada, generado a partir del mismo catálogo que valida la API.

Los agentes también pueden llamar directamente a CheaperGen: conecta nuestro Servidor MCP alojado con Claude Code, ChatGPT, Codex, Cursor o VS Code, o instala el skill de agente de CheaperGen. Si quieres que un agente de programación añada la API a tu propio proyecto, pega la frase «agente de programación» de arriba: sigue /agents/integrate.md.