Primeros pasos
Crea tu primera imagen con IA con la API de Cheapest Imagen en tres pasos: crea una clave, envía una solicitud y lee la imagen de la respuesta.
La API usa las mismas solicitudes y respuestas que la API OpenAI Images. Si ya llamas a OpenAI, cambia la URL base y la clave y conserva el resto de tu código.
1. Consigue una clave de API
Inicia sesión y crea una clave en la página de claves de API. Una cuenta nueva tiene 5 imágenes gratis, y funcionan por la API: GPT Image 2, 2.5 o 2.6 en 1K, una imagen por solicitud. Para cualquier otra cosa, recarga primero. Una clave empieza por sk-cheap- y se muestra una sola vez, así que cópiala al crearla.
2. Envía una solicitud
curl https://api.cheapestimagen.com/v1/images/generations \
-H "Authorization: Bearer $YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-image-2",
"prompt": "a red fox in the snow",
"size": "1536x1024"
}'from openai import OpenAI
client = OpenAI(
base_url="https://api.cheapestimagen.com/v1",
api_key="YOUR_KEY",
)
result = client.images.generate(
model="gpt-image-2",
prompt="a red fox in the snow",
size="1536x1024",
)import OpenAI from 'openai';
const client = new OpenAI({
baseURL: 'https://api.cheapestimagen.com/v1',
apiKey: process.env.YOUR_KEY,
});
const result = await client.images.generate({
model: 'gpt-image-2',
prompt: 'a red fox in the snow',
size: '1536x1024',
});3. Lee la imagen
La respuesta contiene una entrada por imagen. Por defecto cada entrada lleva la imagen en base64 en b64_json:
{
"created": 1794660236,
"data": [{ "b64_json": "iVBORw0KGgo..." }]
}Envía "response_format": "url" para recibir un enlace en su lugar. Las imágenes enlazadas se conservan 72 horas.
Síncrona o asíncrona
La solicitud de arriba es síncrona: responde cuando la imagen está lista. Si una solicitud tarda mucho, o envías muchas a la vez, usa la forma asíncrona: añade "async": true para recibir al instante un id de tarea y después consulta la tarea, o añade webhook_url y te llamamos cuando termine. Las dos formas cuestan lo mismo. La consulta, la lectura de muchas tareas en una sola llamada y los webhooks se explican en Solicitudes síncronas y asíncronas.
Cuánto cuesta
GPT Image 2, 2.5 y 2.6 cuestan 8 créditos por imagen; Nano Banana 2 y 2.1 cuestan 12; Nano Banana Pro, gpt-image-2-adobe y las variantes flare, 20; las variantes sunburst, 25; los canales estables de Nano Banana (-1k, -2k, -4k), de 60 a 180. El tamaño y la calidad no cambian el precio (un crédito cuesta de 0,001 a unos 0,0018 US$, consulta precios). Una solicitud fallida no cuesta nada: los créditos se reservan cuando empieza la solicitud y se devuelven por cada imagen que no se entrega. La única excepción: los canales estables de Nano Banana (-1k, -2k, -4k) cobran las imágenes rechazadas por su contenido.