Texto a imagen
Genera imágenes a partir de un prompt de texto con la API de Cheapest Imagen, y elige el modelo, el tamaño, la calidad, el número de imágenes y el formato de salida.
Envía un prompt a POST /v1/images/generations. Solo model y prompt son obligatorios.
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 lighthouse at dusk, oil painting",
"n": 2,
"size": "1536x1024",
"quality": "high"
}'Opciones
| Campo | Qué hace | Valores |
|---|---|---|
n | Número de imágenes | De 1 a 10, por defecto 1 |
size | Ancho y alto | auto o un tamaño de 1K, 2K o 4K, consulta Proporciones y tamaños |
quality | Calidad de renderizado, mismo precio para todas | auto, low, medium, high; xhigh, max en gpt-image-2.5-sunburst |
background | Fondo transparente o sólido | auto, opaque, transparent |
output_format | Formato de archivo | png (por defecto), jpeg, webp en todos los modelos; gif en gpt-image-2.6 y sus variantes flare y sunburst; svg en gpt-image-2.6 |
output_compression | Calidad para jpeg y webp | De 0 a 100, por defecto 100 |
moderation | Con qué rigor se revisa el contenido | auto, low |
response_format | Datos de la imagen o un enlace | b64_json (por defecto), url |
Por ahora ningún modelo crea un fondo transparente: OpenAI retiró su vista previa de transparencia para los modelos GPT Image, y ahora devuelven un fondo sólido. Una solicitud con background: transparent devuelve un 400 con el código unsupported_parameter. Para obtener un recorte, pide en el prompt un fondo liso de un solo color y quítalo después.
Formatos de salida
PNG, JPEG y WebP funcionan en todos los modelos, como en la API de OpenAI. La mayoría de los modelos crean un PNG, y lo convertimos al JPEG o WebP que pediste dentro de la red de Cloudflare (de 0,1 a 0,4 segundos; un PNG de 2 MB se convierte en un JPEG o WebP de unos 250 KB). gpt-image-2.6-flare y gpt-image-2.6-sunburst crean JPEG y WebP directamente.
| Modelo | PNG | JPEG | WebP | GIF | SVG |
|---|---|---|---|---|---|
gpt-image-2, gpt-image-2.5, gpt-image-2-adobe | Sí | Sí | Sí | – | – |
gpt-image-2.6 | Sí | Sí | Sí | Sí | Sí |
gpt-image-2.5-flare, gpt-image-2.5-sunburst | Sí | Sí | Sí | – | – |
gpt-image-2.6-flare, gpt-image-2.6-sunburst | Sí | Sí | Sí | Sí | – |
| Nano Banana (todas las versiones) | Sí | Sí | Sí | – | – |
«–» devuelve un 400. output_compression fija la calidad del JPEG o WebP en todos los modelos (por defecto 100). Un GIF puede tardar de tres a cinco minutos. El tipo real del archivo está en la extensión del enlace y en su Content-Type.
Cuántos créditos gasta una solicitud
Una solicitud gasta n veces los créditos del modelo: 8 por imagen en GPT Image 2, 2.5 y 2.6, 12 en Nano Banana 2 y 2.1, 20 en Nano Banana Pro, gpt-image-2-adobe y las variantes flare, 25 en las variantes sunburst, de 60 a 180 en los canales estables de Nano Banana. Si vuelven menos imágenes de las que pediste, solo pagas las imágenes que recibiste.
Enviar dos veces la misma solicitud
Añade una cabecera Idempotency-Key con un valor que tú elijas. Si la misma clave llega de nuevo mientras la primera solicitud se está ejecutando o después de que tuviera éxito, la API responde 409 y no genera ni cobra otra vez. Tras una solicitud fallida puedes reutilizar la clave.
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.
Modelos
Todos los ids de modelo de la API de Cheapest Imagen con el modelo oficial de OpenAI o Google que ejecutan, las resoluciones que crean y sus créditos por imagen.