v1 · 7 endpoints · en producción
Edición de imágenes
API para desarrolladores
Siete endpoints de procesamiento de imágenes con IA detrás de una sola clave de API: eliminación de fondos, escalado, eliminación de marcas de agua y de texto, restauración, coloreado y texto a imagen. REST plano, una respuesta JSON y nada almacenado cuando termina la llamada.
- 7 endpoints, 1 clave
- REST sobre HTTPS
- Sin marca de agua
- No se almacena nada
$ curl -X POST app.imggen.ai/v1/remove-background \
-H "Authorization: Bearer sk_live_..." \
-F image=@photo.jpg
→ 200 OK · 128 ms · X-Credit-Remaining: 385
{
"success": true,
"image": "iVBORw0KGgoAAAANSUhEUg..."
}¿Qué es la API de edición de imágenes de ImgGen AI?
La API de edición de imágenes de ImgGen AI es un servicio REST que procesa imágenes con IA bajo demanda. Envías una imagen —o un prompt de texto— a un endpoint mediante HTTPS y el resultado procesado vuelve codificado en base64 dentro de la respuesta JSON. No hay ningún modelo que alojar ni ninguna GPU que aprovisionar.
Todos los endpoints comparten la misma URL base, la misma clave de API y la misma forma de respuesta, así que añadir una segunda capacidad a tu flujo es cambiar de ruta y no montar una integración nueva. Si quieres probar los modelos antes de escribir código, esos mismos modelos impulsan las herramientas gratuitas de ImgGen AI en el navegador.
¿Cómo se usa la API de edición de imágenes?
Genera una clave de API y envía una solicitud multipart con tu imagen. Este ejemplo elimina un fondo; el resto de endpoints de edición siguen el mismo patrón con una ruta distinta. La generación de imágenes es la única excepción: recibe un cuerpo JSON con tu prompt, el número de muestras y la relación de aspecto en lugar de un archivo.
curl --request POST \
--url 'https://app.imggen.ai/v1/remove-background' \
--header 'Authorization: Bearer sk_live_YOUR_API_KEY' \
--form image=@/path/to/photo.jpgimport fs from 'node:fs';
const form = new FormData();
form.append('image', new Blob([fs.readFileSync('photo.jpg')]), 'photo.jpg');
const res = await fetch('https://app.imggen.ai/v1/remove-background', {
method: 'POST',
headers: { Authorization: `Bearer ${process.env.IMGGEN_API_KEY}` },
body: form,
});
const { image } = await res.json();
fs.writeFileSync('result.png', Buffer.from(image, 'base64'));import base64, os, requests
with open("photo.jpg", "rb") as f:
res = requests.post(
"https://app.imggen.ai/v1/remove-background",
headers={"Authorization": f"Bearer {os.environ['IMGGEN_API_KEY']}"},
files={"image": f},
)
with open("result.png", "wb") as out:
out.write(base64.b64decode(res.json()["image"]))Los siete endpoints
Cada uno tiene su propia página de referencia con parámetros, ejemplos de código en tres lenguajes y su coste exacto en créditos.
API de eliminación de fondos
Elimina el fondo de tus imágenes por código con una sola solicitud POST. Una clave de API, salida en PNG transparente y un servicio sin estado que nunca almacena las imágenes que envías.
API de escalado de imágenes
Aumenta la resolución de tus imágenes 2x o 4x desde tu propio backend. Mejora facial y enfoque opcionales, salida en JPEG o PNG y un precio que escala con el factor que pidas.
API de eliminación de marcas de agua
Detecta y borra marcas de agua de tus imágenes en una sola solicitud. El inpainting generativo reconstruye los píxeles que había detrás de la marca, y este es el único endpoint que además acepta un lote de imágenes.
API de eliminación de texto
Borra rótulos, superposiciones, marcas de tiempo y etiquetas incrustadas en tus imágenes por código. La detección es automática, y si la imagen no tiene texto, no se te cobra.
API de restauración de fotos
Repara fotografías antiguas, dañadas y descoloridas desde tu propio backend. Opcionalmente coloréalas y aumenta su resolución en la misma solicitud, en lugar de encadenar tres llamadas.
API de coloreado de fotos
Convierte fotografías en blanco y negro en imágenes con color natural con una sola solicitud. Reparación de roturas opcional en la misma llamada y sin elegir colores a mano en ningún momento.
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.
¿Cuánto cuesta la API de edición de imágenes?
El uso se basa en créditos y no en una tarifa fija por llamada, así que un mes intenso y un mes tranquilo cuestan lo mismo por imagen. Los créditos se comparten entre todos los endpoints y el editor web: un solo saldo, no una cuota separada por herramienta. Una llamada fallida se reembolsa automáticamente, y cada respuesta correcta devuelve tu saldo restante en la cabecera X-Credit-Remaining.
| Endpoint | Ruta | Créditos / llamada |
|---|---|---|
| Eliminación de fondos | /v1/remove-background | 1 |
| Escalado de imágenes | /v1/upscale-image | 2–4 |
| Eliminación de marcas de agua | /v1/remove-watermark | 2 |
| Eliminación de texto | /v1/remove-text | 2 |
| Restauración de fotos | /v1/image-restoration | 2 |
| Coloreado de fotos | /v1/colorize-photo | 2 |
| Generación de imágenes | /v1/generate-image | 3+ |
| Plan | Precio | Créditos | API | Notas |
|---|---|---|---|---|
| Free | $0 | 50 créditos gratuitos de una sola vez | Sin acceso a la API | No se requiere tarjeta de crédito |
| Starter | $9.99 / month | 400 créditos / mes | Acceso a la API incluido | Los créditos no usados se acumulan |
| Pro | $29.99 / month | 1.400 créditos / mes | Acceso a la API + soporte prioritario | Los créditos no usados se acumulan |
| Enterprise | Custom | Volumen personalizado | Infraestructura dedicada | support@imggen.ai |
Costes en créditos y límites verificados por última vez el 2026-08-27. Todos los detalles en la página de precios.
Cómo funciona la API
Deliberadamente aburrida: una solicitud, una respuesta y ninguna orquestación por tu parte.
Síncrona, sin colas
La imagen procesada viene en el cuerpo de la misma respuesta. Ningún ID de trabajo que consultar, ningún endpoint de webhook que levantar, ninguna cola que reconciliar. Las solicitudes están sujetas a un límite de 60 segundos.
Multipart a la entrada, base64 a la salida
Envía tu imagen de entrada como formulario multipart: JPEG (JPG), PNG y WebP, hasta 25 MB. El resultado vuelve codificado en base64 dentro del cuerpo JSON: decodifícalo y guárdalo donde almacenes tus recursos.
Solo se cobra si funciona
Los créditos se descuentan de forma atómica y se reembolsan automáticamente si el procesamiento falla, así que solo se te cobra por las imágenes que realmente vuelven. La eliminación de texto incluso devuelve un 422 sin coste alguno cuando no hay texto que eliminar.
Claves que puedes rotar
Las claves se muestran una sola vez y se guardan únicamente como hash. La revocación se propaga en aproximadamente un minuto, así que una clave filtrada es un problema de un minuto y no un incidente.
¿La API almacena mis imágenes o entrena con ellas?
No. La API no guarda estado. A diferencia del editor web, que guarda tus proyectos para que puedas volver a ellos, una llamada a la API no crea ningún proyecto, ningún registro de tarea ni ningún archivo almacenado. Tu subida se escribe en un objeto temporal, se procesa y se elimina en cuanto se devuelve la respuesta. Lo único que se conserva es un registro de uso que anota que hubo una llamada y cuántos créditos costó.
Tus imágenes nunca se usan para entrenar modelos. Eso importa si procesas fotos de clientes que contractualmente no puedes conservar: es la arquitectura, y no solo la política, lo que las mantiene fuera de nuestro almacenamiento.
Respuestas de error
Los fallos devuelven un envoltorio JSON con la forma { "error": { "message", "code" } }, y el estado HTTP se corresponde con el código.
| Estado | Código | Significado |
|---|---|---|
| 401 | UNAUTHORIZED | Falta la clave de API, tiene un formato incorrecto o ha sido revocada. |
| 402 | INSUFFICIENT_CREDITS | Tu cuenta no tiene créditos suficientes para esta llamada. |
| 403 | FORBIDDEN | Tu plan no da acceso a esta herramienta. |
| 404 | NOT_FOUND | La ruta del endpoint no existe. |
| 409 | CONFLICT | La solicitud entra en conflicto con el estado actual del recurso. |
| 422 | VALIDATION_ERROR | La solicitud fue rechazada: un tipo de archivo no válido, un campo que falta o nada que procesar. No se cobra ningún crédito. |
¿Quién usa la API de ImgGen?
Dónde se gana su sitio una API de procesamiento de imágenes dentro de un producto.
Comercio electrónico y marketplaces
Normaliza las imágenes de proveedores y vendedores al subirlas: recorta fondos, elimina el texto superpuesto y amplía las fotos antiguas de baja resolución para que todos los anuncios parezcan salidos del mismo estudio.
Print-on-demand y mockups de producto
Aísla el diseño, sube la resolución hasta la calidad de impresión y compón sobre plantillas sin que un diseñador tenga que tocar cada pedido.
SaaS de diseño y edición
Lanza funciones de edición en un clic dentro de tu propio producto sin alojar GPU, ajustar modelos ni mantener una infraestructura de inferencia.
Archivos, genealogía y digitalización
Repara, colorea y amplía fotografías escaneadas en un flujo automatizado en lugar de retocar cada imagen a mano.
Plataformas de contenido y publicación
Genera imágenes originales a partir de un prompt y limpia las subidas de los colaboradores como parte de tu flujo editorial actual.
Agencias y herramientas internas
Automatiza el trabajo repetitivo con imágenes que hay entre el briefing de un cliente y el recurso final, desde las herramientas que tu equipo ya usa.
Preguntas frecuentes sobre la API de edición de imágenes
- Sí. La API de edición de imágenes de ImgGen AI expone siete endpoints REST — eliminación de fondos, escalado de imágenes, eliminación de marcas de agua, eliminación de texto, restauración de fotos, coloreado y generación de imágenes a partir de texto — todos bajo https://app.imggen.ai y accesibles con una única clave de API.
- Realiza una edición concreta sobre la imagen que envías y devuelve el resultado en la misma respuesta. Puedes eliminar un fondo y obtener un PNG transparente, escalar 2x o 4x, borrar marcas de agua o texto incrustado, reparar y colorear fotografías dañadas y generar imágenes nuevas a partir de un prompt.
- Crea una cuenta de ImgGen en https://editor.imggen.ai y genera una clave desde los ajustes de tu cuenta. La clave se muestra una sola vez y se guarda únicamente como hash, así que cópiala en un lugar seguro: si la pierdes tendrás que generar una nueva en lugar de recuperar la anterior. Revocar una clave surte efecto en aproximadamente un minuto.
- Envía tu clave como bearer token: Authorization: Bearer sk_live_… en cada solicitud. Las claves emitidas antes del esquema actual también pueden autenticarse con la cabecera heredada x-imggen-key, que se sigue aceptando.
- El uso se mide en créditos y no con una tarifa fija por llamada, y el coste depende del endpoint: la eliminación de fondos cuesta 1 crédito; la eliminación de marcas de agua, la eliminación de texto, la restauración y el coloreado cuestan 2; el escalado cuesta 2 con factor=2 y 4 con factor=4; la generación de imágenes empieza en 3 y varía según el modelo. Starter te da 400 créditos al mes por 9,99 $ y Pro te da 1.400 por 29,99 $, y los créditos no usados se acumulan mientras tu suscripción siga activa.
- Una cuenta gratuita de ImgGen incluye 50 créditos y no pide tarjeta, suficiente para evaluar los modelos en las herramientas web. El acceso a la API forma parte de los planes de pago Starter y Pro: no existe un nivel de API gratuito permanente, y preferimos decirlo claramente antes que anunciar uno que luego limite la velocidad en silencio.
- La API acepta archivos JPEG (JPG), PNG y WebP de hasta 25 MB por imagen. Los resultados se devuelven como una imagen codificada en base64 dentro de la respuesta JSON.
- Síncronos. No hay ningún ID de trabajo que consultar, ninguna cola que gestionar ni ningún webhook que configurar: la imagen procesada viene en el cuerpo de la misma respuesta. Las solicitudes están sujetas a un límite de 60 segundos.
- No. La API no guarda estado: no crea ningún proyecto, no guarda ningún archivo ni conserva tu imagen. Tu subida se escribe en un objeto temporal, se procesa y se elimina en cuanto se devuelve la respuesta. Lo único que se conserva es un registro de uso que anota que hubo una llamada y cuántos créditos costó. Tus imágenes nunca se usan para entrenar modelos.
- 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.
- El endpoint de eliminación de marcas de agua acepta un lote de archivos bajo image[] y devuelve un array images. El resto de endpoints procesan una imagen por solicitud: para volumen, lanza las solicitudes en paralelo desde tu propio worker, ya que cada llamada es independiente.
- Por ahora no. La API es REST plano sobre HTTPS con subidas multipart, así que sirve cualquier cliente HTTP, y la documentación incluye ejemplos listos para copiar en cURL, Node.js y Python. Todavía no hay biblioteca cliente oficial ni especificación OpenAPI publicada.
Empezar
Haz tu primera llamada en cinco minutos
Crea una clave, copia el ejemplo de cURL y ya tienes la eliminación de fondos funcionando. Una sola clave cubre los siete endpoints, en todos los planes que incluyen acceso a la API.
Obtén tu clave de API