¿Qué es una API de generación de imágenes con IA?

Es un endpoint HTTP que convierte una descripción escrita en una imagen. Envías un prompt como JSON y el servicio devuelve las imágenes generadas en la respuesta, lo que permite a un producto ofrecer texto a imagen sin ejecutar ninguna infraestructura de modelos propia.

¿Cuántas imágenes puedo generar por solicitud?

Entre una y cuatro, con el parámetro samples. Todas las imágenes solicitadas vuelven en un único array images dentro de la misma respuesta.

¿Qué modelos están disponibles?

Tres: imggen-base es el predeterminado y equilibra calidad y velocidad, imggen-base-fast devuelve resultados más rápido con menos detalle e imggen-xl apunta a la máxima calidad. Eliges por solicitud con el parámetro model.

¿Qué relaciones de aspecto se admiten?

square, portrait y landscape, con el parámetro aspect_ratio. Si lo omites, el valor predeterminado es square.

¿Cuánto cuesta la generación de imágenes?

La generación se cobra por modelo y no con una tarifa plana, porque los modelos difieren bastante en cómputo. Empieza en 3 créditos por imagen con el modelo predeterminado y sube en los de mayor calidad. Tu saldo restante vuelve en la cabecera X-Credit-Remaining de cada llamada correcta, y el coste actual de cada modelo se muestra en tu cuenta de ImgGen.

¿De quién son las imágenes generadas con la API?

Tuyas. ImgGen no reclama la propiedad de nada de lo que devuelve la API, y todos los planes incluyen derechos de uso comercial completos y sin marca de agua. Ten en cuenta que los derechos de autor sobre imágenes generadas por IA se tratan de forma distinta según la jurisdicción, así que si la propiedad es determinante en tu caso, comprueba la situación legal en tu país.

¿Puedo usar comercialmente las imágenes generadas?

Sí. Todos los planes, incluido el gratuito, incluyen derechos de uso comercial completos, y ningún resultado lleva marca de agua. Puedes vender, imprimir o publicar cualquier cosa que devuelva la API.

¿Almacenáis los prompts o las imágenes generadas?

Las imágenes generadas se devuelven en la respuesta y no se conservan. Como en todos los endpoints de ImgGen, lo único que se guarda es un registro de uso que anota que hubo una llamada y cuánto costó. Tu contenido no se usa para entrenar modelos.

desde 3 créditos por llamada

API de generación de imágenes con IA

Genera imágenes a partir de un prompt de texto con una sola solicitud JSON. Hasta cuatro muestras por llamada, tres modelos para equilibrar velocidad y calidad, y derechos comerciales completos sobre el resultado.

REST · JSON
Sin marca de agua
No se almacena nada

Obtén tu clave de API Ver la documentación

endpoint

POST /v1/generate-image

URL base: https://app.imggen.ai
Auth: Authorization: Bearer sk_live_…
Coste: desde 3 créditos
Entrada: JPEG (JPG), PNG and WebP · max 25 MB

01 — Resumen

¿Qué es la API de generación de imágenes con IA?

La API de generación de imágenes de ImgGen AI es un endpoint REST que convierte un prompt de texto en imágenes. Envías un cuerpo JSON con el prompt, cuántas muestras quieres, una relación de aspecto y qué modelo usar; el endpoint devuelve las imágenes generadas codificadas en base64 dentro de un array. Es el único endpoint que recibe JSON en lugar de un archivo.

Es uno de los siete endpoints de la API de edición de imágenes de ImgGen AI, que comparten una única clave de API, una única URL base y la misma forma de solicitud y respuesta. Si además necesitas esta función en el navegador y no desde código, el mismo modelo de IA impulsa la herramienta AI Image Generator.

02 — Solicitud

Parámetros de la solicitud

Envía una solicitud POST a https://app.imggen.ai/v1/generate-image, autenticada con una clave de API en la cabecera Authorization.

Parámetros que acepta este endpoint
Parámetro	Tipo	Obligatorio	Predeterminado	Descripción
prompt	string	OBLIGATORIO	—	Descripción en texto de la imagen que se va a generar.
samples	number	opcional	1	Cuántas imágenes generar, de 1 a 4.
aspect_ratio	string	opcional	square	Forma de la salida. Acepta square, portrait o landscape.
model	string	opcional	imggen-base	Modelo de generación. Acepta imggen-base, imggen-base-fast o imggen-xl.

03 — Integración

¿Cómo integro la API de generación de imágenes con IA?

Crea una clave de API en tu cuenta de ImgGen, guárdala como variable de entorno y llama al endpoint. Esta es la misma solicitud en cURL, Node.js y Python.

curl --request POST \
  --url 'https://app.imggen.ai/v1/generate-image' \
  --header 'Authorization: Bearer sk_live_YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "prompt": "close up photo of a rabbit in a wildflower meadow",
    "samples": 1,
    "aspect_ratio": "square",
    "model": "imggen-base"
  }'

import fs from 'node:fs';

const res = await fetch('https://app.imggen.ai/v1/generate-image', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.IMGGEN_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    prompt: 'close up photo of a rabbit in a wildflower meadow',
    samples: 1,
    aspect_ratio: 'square',
    model: 'imggen-base',
  }),
});

const data = await res.json();
data.images.forEach((img, i) =>
  fs.writeFileSync(`image-${i}.png`, Buffer.from(img, 'base64')),
);

import base64, os, requests

res = requests.post(
    "https://app.imggen.ai/v1/generate-image",
    headers={
        "Authorization": f"Bearer {os.environ['IMGGEN_API_KEY']}",
        "Content-Type": "application/json",
    },
    json={
        "prompt": "close up photo of a rabbit in a wildflower meadow",
        "samples": 1,
        "aspect_ratio": "square",
        "model": "imggen-base",
    },
)

for i, img in enumerate(res.json()["images"]):
    with open(f"image-{i}.png", "wb") as out:
        out.write(base64.b64decode(img))

04 — Respuesta

Respuesta

Una llamada correcta devuelve JSON. El resultado viene codificado en base64: decodifícalo antes de escribirlo en disco o en tu almacenamiento de objetos. Cada respuesta correcta incluye además una cabecera X-Credit-Remaining con tu saldo tras la llamada.

{
  "success": true,
  "message": "Images generated successfully",
  "images": ["iVBORw0KGgoAAAANSUhEUgAA...SUVORK5CYII="]
}

05 — Límites

Límites y comportamientos que conviene conocer

El endpoint acepta JPEG (JPG), PNG y WebP con un tamaño máximo de archivo de 25 MB, y responde de forma síncrona en menos de 60 segundos: no hay ningún trabajo que consultar ni ningún webhook que configurar.

Devuelve un array images

A diferencia de los endpoints de edición, que devuelven un único campo image, la generación devuelve images: un array con una entrada por cada muestra solicitada.

Tres modelos

imggen-base es el equilibrio por defecto, imggen-base-fast cambia detalle por velocidad e imggen-xl apunta a la máxima calidad. Se elige por solicitud, no por cuenta.

JSON, no multipart

Es el único endpoint que recibe un cuerpo JSON. Envía Content-Type: application/json en lugar de un formulario multipart.

06 — En producción

¿Para qué se usa la API de generación de imágenes con IA?

Dónde ponen los equipos este endpoint en producción para procesar imágenes de forma programática y a escala.

Imágenes editoriales y de blog

Genera una imagen de cabecera original para cada artículo a partir del titular, en lugar de tirar de un banco de imágenes que usa todo el mundo.

Conceptualización de producto y campañas

Produce cuatro variaciones de una idea visual en una sola llamada para que el equipo elija una dirección antes de encargar el trabajo real.

Funciones creativas dentro de la app

Permite a tus usuarios generar imágenes dentro de tu producto sin que tengas que montar infraestructura de GPU.

Contenido de relleno y maquetas

Llena demos, prototipos y entornos de prueba con imágenes verosímiles generadas bajo demanda.

07 — Coste

¿Cuánto cuesta la API de generación de imágenes con IA?

Cada llamada correcta cuesta desde 3 créditos, así que tu coste real por imagen depende del plan que tengas. Los créditos salen de tu plan y se comparten entre todos los endpoints y el editor web, de modo que no compras una cuota separada por herramienta. Una llamada fallida se reembolsa automáticamente. Consulta todos los detalles en la página de precios.

Planes de ImgGen AI y acceso a la API
Plan	Precio	Créditos	API
Free	$0	50 créditos gratuitos de una sola vez	Sin acceso a la API
Starter	$9.99 / month	400 créditos / mes	Acceso a la API incluido
Pro	$29.99 / month	1.400 créditos / mes	Acceso a la API + soporte prioritario
Enterprise	Custom	Volumen personalizado	Infraestructura dedicada

Costes en créditos y límites verificados por última vez el 2026-08-27.

08 — Relacionado

Los equipos que usan la API de generación de imágenes con IA suelen recurrir después a estos.

→API de eliminación de fondos →API de escalado de imágenes AI Image Generator (herramienta web)Todos los endpoints de la API

También disponibles: Eliminación de marcas de agua, Eliminación de texto, Restauración de fotos, Coloreado de fotos.

FAQ

Preguntas frecuentes sobre la API de generación de imágenes con IA

: Es un endpoint HTTP que convierte una descripción escrita en una imagen. Envías un prompt como JSON y el servicio devuelve las imágenes generadas en la respuesta, lo que permite a un producto ofrecer texto a imagen sin ejecutar ninguna infraestructura de modelos propia.
: Entre una y cuatro, con el parámetro samples. Todas las imágenes solicitadas vuelven en un único array images dentro de la misma respuesta.
: Tres: imggen-base es el predeterminado y equilibra calidad y velocidad, imggen-base-fast devuelve resultados más rápido con menos detalle e imggen-xl apunta a la máxima calidad. Eliges por solicitud con el parámetro model.
: square, portrait y landscape, con el parámetro aspect_ratio. Si lo omites, el valor predeterminado es square.
: La generación se cobra por modelo y no con una tarifa plana, porque los modelos difieren bastante en cómputo. Empieza en 3 créditos por imagen con el modelo predeterminado y sube en los de mayor calidad. Tu saldo restante vuelve en la cabecera X-Credit-Remaining de cada llamada correcta, y el coste actual de cada modelo se muestra en tu cuenta de ImgGen.
: Tuyas. ImgGen no reclama la propiedad de nada de lo que devuelve la API, y todos los planes incluyen derechos de uso comercial completos y sin marca de agua. Ten en cuenta que los derechos de autor sobre imágenes generadas por IA se tratan de forma distinta según la jurisdicción, así que si la propiedad es determinante en tu caso, comprueba la situación legal en tu país.
: Sí. Todos los planes, incluido el gratuito, incluyen derechos de uso comercial completos, y ningún resultado lleva marca de agua. Puedes vender, imprimir o publicar cualquier cosa que devuelva la API.
: Las imágenes generadas se devuelven en la respuesta y no se conservan. Como en todos los endpoints de ImgGen, lo único que se guarda es un registro de uso que anota que hubo una llamada y cuánto costó. Tu contenido no se usa para entrenar modelos.

Empezar

Empieza a llamar a la API de generación de imágenes con IA

Una sola clave desbloquea los siete endpoints. Sin marca de agua, con derechos comerciales completos y sin que se almacene nada de lo que envías una vez devuelta la respuesta.

Obtén tu clave de API