Saltar al contenido
Cheapest Imagen
Guías

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

CampoQué haceValores
nNúmero de imágenesDe 1 a 10, por defecto 1
sizeAncho y altoauto o un tamaño de 1K, 2K o 4K, consulta Proporciones y tamaños
qualityCalidad de renderizado, mismo precio para todasauto, low, medium, high; xhigh, max en gpt-image-2.5-sunburst
backgroundFondo transparente o sólidoauto, opaque, transparent
output_formatFormato de archivopng (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_compressionCalidad para jpeg y webpDe 0 a 100, por defecto 100
moderationCon qué rigor se revisa el contenidoauto, low
response_formatDatos de la imagen o un enlaceb64_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.

ModeloPNGJPEGWebPGIFSVG
gpt-image-2, gpt-image-2.5, gpt-image-2-adobeSíSíSí––
gpt-image-2.6SíSíSíSíSí
gpt-image-2.5-flare, gpt-image-2.5-sunburstSíSíSí––
gpt-image-2.6-flare, gpt-image-2.6-sunburstSí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.

En esta página