¿Qué es una API de escalado de imágenes y cómo funciona?

Es un endpoint HTTP que aumenta la resolución de una imagen con un modelo entrenado. En lugar de interpolar entre los píxeles existentes, como hace un redimensionado, el modelo predice el detalle que tendría una versión de mayor resolución de esa imagen —bordes, textura y estructura— y lo reconstruye. Envías la imagen por POST y lees el resultado ampliado en la respuesta.

¿Qué factores de escalado y tipos de imagen se admiten?

El parámetro factor acepta 2 o 4 y su valor predeterminado es 4. La entrada puede ser JPEG (JPG), PNG y WebP de hasta 25 MB, y la salida puede devolverse como jpeg (predeterminado) o png.

¿Cómo funciona el precio de la API de escalado?

El coste sigue al factor: 2 créditos con factor=2 y 4 créditos con factor=4 (el valor predeterminado). 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 sigas suscrito. Un precio basado en créditos significa que un mes con mucho volumen y un mes tranquilo te cuestan lo mismo por imagen.

¿La API también puede mejorar la calidad, quitar el desenfoque o restaurar fotos antiguas?

El escalado reconstruye detalle al ampliar, lo que de paso enfoca las imágenes blandas, y el parámetro sharpen lleva ese efecto más lejos para mejorar el resultado. Para fotografías dañadas o descoloridas —arañazos, roturas, pérdida de color— usa mejor la API de restauración de fotos, que está pensada para reparar y no para aumentar la resolución.

¿El escalado es síncrono o asíncrono?

Síncrono. No hay ningún ID de trabajo que consultar ni ningún webhook que configurar: la imagen escalada viene en el cuerpo de la misma respuesta, con un límite de 60 segundos por solicitud.

¿Puedo usar comercialmente las imágenes escaladas?

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 las imágenes que escalo?

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.

2–4 créditos por llamada

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.

REST · JSON
Sin marca de agua
No se almacena nada

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

endpoint

POST /v1/upscale-image

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

01 — Resumen

¿Qué es la API de escalado de imágenes?

La API de escalado de imágenes de ImgGen AI es un endpoint REST que aumenta la resolución de una imagen usando IA en lugar de una simple interpolación. Reconstruye bordes, texturas y detalle fino en vez de estirar píxeles, de modo que el resultado se mantiene nítido. Envías una imagen y un factor de escala, y el resultado de mayor resolución vuelve en la misma solicitud.

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 Upscaler.

02 — Solicitud

Parámetros de la solicitud

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

Parámetros que acepta este endpoint
Parámetro	Tipo	Obligatorio	Predeterminado	Descripción
image	file	OBLIGATORIO	—	Factor de escalado. Acepta 2 o 4.
factor	number	opcional	4	Aplica una reconstrucción facial adicional. Útil para retratos y fotos de grupo.
enhanceFace	boolean	opcional	false	Aplica un enfoque adicional al resultado escalado.
sharpen	boolean	opcional	false	Formato de salida. Acepta jpeg o png.
output	string	opcional	jpeg	Output format. Accepts jpeg or png.

03 — Integración

¿Cómo integro la API de escalado de imágenes?

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/upscale-image' \
  --header 'Authorization: Bearer sk_live_YOUR_API_KEY' \
  --form image=@/path/to/photo.jpg \
  --form factor=4 \
  --form enhanceFace=false \
  --form sharpen=false \
  --form output=jpeg

import fs from 'node:fs';

const form = new FormData();
form.append('image', new Blob([fs.readFileSync('photo.jpg')]), 'photo.jpg');
form.append('factor', '4');
form.append('enhanceFace', 'false');
form.append('sharpen', 'false');
form.append('output', 'jpeg');

const res = await fetch('https://app.imggen.ai/v1/upscale-image', {
  method: 'POST',
  headers: { Authorization: `Bearer ${process.env.IMGGEN_API_KEY}` },
  body: form,
});

const data = await res.json();
// data.image is a base64-encoded PNG
fs.writeFileSync('result.png', Buffer.from(data.image, 'base64'));

import base64, os, requests

with open("photo.jpg", "rb") as f:
    res = requests.post(
        "https://app.imggen.ai/v1/upscale-image",
        headers={"Authorization": f"Bearer {os.environ['IMGGEN_API_KEY']}"},
        files={"image": f},
    data={"factor": "4", "enhanceFace": "false", "sharpen": "false", "output": "jpeg"},
    )

data = res.json()
with open("result.png", "wb") as out:
    out.write(base64.b64decode(data["image"]))

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": "Image upscaled successfully",
  "image": "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.

Elige tu formato de salida

Usa output=png cuando necesites un resultado sin pérdidas o conservar un canal alfa; jpeg mantiene las respuestas ligeras para trabajos de catálogo de gran volumen.

La mejora facial es opcional

enhanceFace aplica una reconstrucción facial adicional para mejorar y escalar retratos. Déjalo desactivado en fotos de producto y paisajes, donde no hay ningún rostro que mejorar.

Synchronous by design

There is no job queue to poll. The upscaled image comes back in the same response, within the 60-second request ceiling.

06 — En producción

¿Para qué se usa la API de escalado de imágenes?

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

Migración de catálogos antiguos

Lleva años de imágenes de producto pequeñas y de baja resolución a los estándares actuales de alta resolución en un proceso por lotes, en lugar de volver a fotografiarlas.

Preparación para impresión

Sube recursos pensados para web hasta un tamaño de calidad que aguante en impresión, con enfoque opcional aplicado en la misma llamada para un resultado más nítido.

Contenido generado por usuarios

Escala avatares y subidas pequeñas en el servidor para que se vean limpios en pantallas de alta densidad.

Medios y archivos

Aumenta la resolución de imágenes escaneadas o comprimidas antes de que entren en un gestor de contenidos, junto con la restauración cuando haga falta.

07 — Coste

¿Cuánto cuesta la API de escalado de imágenes?

Cada llamada correcta cuesta 2–4 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 escalado de imágenes suelen recurrir después a estos.

→API de restauración de fotos →API de coloreado de fotos AI Image Upscaler (herramienta web)Todos los endpoints de la API

También disponibles: Eliminación de fondos, Eliminación de marcas de agua, Eliminación de texto, Generación de imágenes.

FAQ

Preguntas frecuentes sobre la API de escalado de imágenes

: Es un endpoint HTTP que aumenta la resolución de una imagen con un modelo entrenado. En lugar de interpolar entre los píxeles existentes, como hace un redimensionado, el modelo predice el detalle que tendría una versión de mayor resolución de esa imagen —bordes, textura y estructura— y lo reconstruye. Envías la imagen por POST y lees el resultado ampliado en la respuesta.
: El parámetro factor acepta 2 o 4 y su valor predeterminado es 4. La entrada puede ser JPEG (JPG), PNG y WebP de hasta 25 MB, y la salida puede devolverse como jpeg (predeterminado) o png.
: El coste sigue al factor: 2 créditos con factor=2 y 4 créditos con factor=4 (el valor predeterminado). 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 sigas suscrito. Un precio basado en créditos significa que un mes con mucho volumen y un mes tranquilo te cuestan lo mismo por imagen.
: El escalado reconstruye detalle al ampliar, lo que de paso enfoca las imágenes blandas, y el parámetro sharpen lleva ese efecto más lejos para mejorar el resultado. Para fotografías dañadas o descoloridas —arañazos, roturas, pérdida de color— usa mejor la API de restauración de fotos, que está pensada para reparar y no para aumentar la resolución.
: Síncrono. No hay ningún ID de trabajo que consultar ni ningún webhook que configurar: la imagen escalada viene en el cuerpo de la misma respuesta, con un límite de 60 segundos por solicitud.
: 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.
: 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.

Empezar

Empieza a llamar a la API de escalado de imágenes

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