API para ampliar imágenes sin registro

Alta de una API normal frente a Airpic: un pack y un token

Para usar casi cualquier API de imagen tienes que pasar por el mismo embudo: crear una cuenta, confirmar el correo, entrar en una consola de desarrollador, generar una clave, meter una tarjeta y elegir un plan mensual con un cupo de llamadas. Si solo quieres ampliar cien fotos de producto una vez al trimestre, el alta te cuesta más tiempo que el trabajo. Y la clave queda ligada a una identidad: un correo, una empresa, una tarjeta.

En Airpic el circuito es otro. No existe el registro de desarrollador porque no existe el registro para nadie: la web funciona sin cuenta ni correo y la API hereda ese mismo modelo. Lo que hace falta es esto:

1. Compras un pack de créditos en la sección de precios de la web. El pago lo gestiona la pasarela, sin crear usuario. Al terminar aparece un código con el formato 0TK-XXXXXXXXXXXX.
2. Ese código es tu clave de API. Lo envías en la cabecera Authorization como token Bearer al descargar un resultado. No hay otro secreto: ni identificador de cliente, ni pareja de clave pública y privada, ni firma de peticiones.
3. Nada más. Crear trabajos y consultar su estado no requiere ni el código: solo lo necesitas en el momento de descargar el archivo completo.

La consecuencia práctica es que puedes tener una integración funcionando en el tiempo que tardas en comprar el pack. El código del navegador y el del servidor son el mismo: si ya usas Airpic a mano, copias ese 0TK a tu script y empiezas.

Hay una contrapartida que conviene decir en la primera sección y no en la letra pequeña: un código al portador es exactamente eso. Quien lo tenga gasta tus créditos, y no existe un «he olvidado mi contraseña» que lo recupere, porque no hay cuenta a la que asociarlo ni panel donde rotarlo. Guárdalo donde guardes el resto de secretos del servidor (variables de entorno, un gestor de secretos) y nunca lo metas en el JavaScript de una página ni en el binario de una app móvil: cualquiera que lo lea puede vaciarlo.

Qué puedes llamar: API para quitar el fondo sin registro, ampliar, restaurar y vídeo

La API expone las mismas herramientas que la web, con los mismos parámetros. No hay un catálogo «solo para desarrolladores» ni funciones recortadas: lo que ajustas con un deslizador en el navegador lo mandas como un campo en un JSON de opciones. Esto es lo que puedes llamar:

• Ampliar imagen: factor ×2, ×4, ×8, ×16 o máximo por mosaico, estilo nitidez o pictórico, y opción de mejorar las caras. ×2 y ×4 consumen crédito estándar; los factores grandes, crédito de gran formato. La versión para dibujo plano, ampliar anime e ilustración, va aparte, con ×2 o ×4.
• Quitar el fondo: fondo transparente, blanco, negro o un color en hexadecimal. Es la respuesta a quien busca una API para quitar el fondo sin registro: la misma precisión en el pelo que ves al quitar el fondo de una foto en la web, con el borde calculado a resolución completa y sin halos.
• Comprimir: formato JPEG, WebP, AVIF o PNG, calidad, tamaño objetivo en KB, lado máximo y borrado de metadatos conservando el perfil ICC. Corre en CPU, tarda segundos y es gratis también por API.
• Colorear, quitar ruido y enfocar: cada una con su deslizador de intensidad. Enfocar distingue entre desenfoque por movimiento y por foco; colorear tiene variante natural o vívida.
• Restaurar fotos antiguas: caras, recoloreado opcional, escala ×1 o ×2 y hasta tres fotos de referencia de la misma persona para guiar el parecido, igual que al restaurar fotos antiguas desde la web.
• Borrar objetos: la imagen más una máscara PNG del mismo tamaño con las zonas a eliminar pintadas. En la web la máscara la dibujas con el editor; por API la generas tú, por ejemplo desde un detector propio.
• Vídeo: transcribir un vídeo a texto (idioma automático o forzado, traducción al inglés opcional, ZIP con TXT, SRT, VTT y JSON), vídeo a documento (DOCX, PDF o Markdown con resumen, puntos clave y capítulos con tiempo) y shorts (de 1 a 5 clips 9:16 con subtítulos por palabra).

Común a todas las de imagen: entrada JPG, PNG (con alfa y 16 bits), WebP, TIFF, HEIC y AVIF; se aplica la orientación EXIF y se conserva el perfil ICC; salida PNG, JPG o WebP con calidad ajustable. Para archivos grandes (vídeos de cientos de MB) hay una subida por trozos: pides un identificador de subida, envías las partes una a una y creas el trabajo con ese identificador en lugar del archivo.

Los nombres exactos de cada campo, los valores admitidos y los límites de tamaño por herramienta están en la documentación de airpic.app/developers (por ahora en inglés), con ejemplos en curl. Este artículo no los repite para no quedarse desfasado: si un campo cambia, cambia allí primero.

Cómo se paga: una API de imagen con IA de pago por uso, por descarga

El modelo de cobro de la API es el mismo que el de la web, y es lo que la convierte en una API de imagen con IA de pago por uso de verdad: no pagas por llamada, ni por mes, ni por un cupo reservado que caduca. Pagas por archivo completo descargado.

• Crear el trabajo es gratis. Subes la imagen, el motor la procesa en una GPU en la Unión Europea y el trabajo queda en estado terminado, con sus dimensiones de salida.
• La vista previa es gratis. Cada trabajo terminado tiene una vista previa de hasta 1600 píxeles de lado que puedes pedir sin token. Sirve para comprobar que el resultado es el que esperas antes de gastar nada: el mismo principio de ver el resultado antes de pagar que rige en la web.
• La primera descarga completa gasta 1 crédito del tipo que corresponda: estándar para ×2, ×4, fondo, color, ruido, enfoque, restauración y borrado; gran formato para ×8, ×16 y máximo; vídeo para transcripción, documento y shorts. Las descargas posteriores del mismo trabajo no vuelven a cobrar mientras el archivo exista.
• Comprimir no gasta nada, ni al procesar ni al descargar. Si tu caso es un proceso que solo necesita comprimir imágenes para la web, el coste es cero.
• Si un trabajo falla, no se cobra. El estado pasa a error y el saldo no se toca.

Si el código no tiene saldo del tipo necesario, la descarga responde con un error 402 que indica qué tipo falta. Puedes consultar el saldo de un código en cualquier momento con una petición sin autenticar a la ruta de créditos descrita en la documentación: devuelve cuántos créditos estándar, de gran formato y de vídeo quedan. Es la única «consola» que existe, y basta para que un script compruebe si le llega saldo antes de lanzar una tanda.

Los créditos no caducan. Puedes comprar un pack en marzo, gastar diez créditos y retomar el resto en noviembre. El pack pensado para desarrolladores es Imprenta 100 + API: cien imágenes de gran formato en un solo código, con el acceso por API en su descripción. Pero cualquier código 0TK funciona como token, también el más pequeño, así que para probar la integración no necesitas comprar el grande. La descarga gratis del mes también se aplica a la API, por IP, igual que en la web. El precio de cada pack está en la sección de precios de la página para ampliar una imagen; no lo reproducimos aquí porque cambia antes que el artículo.

Límites reales: cuota por hora, tope de GPU y arranque en frío

Una API sin alta no es una API sin límites. Estos son los que te vas a encontrar, con la razón de cada uno:

• 20 trabajos por hora por dirección IP. Es el mismo freno que tiene la web contra el abuso. Si lo superas, la API devuelve el mensaje «Has alcanzado el límite de trabajos por hora» y el trabajo no se crea. Para volúmenes mayores hay que escribir a Airpic con el código: el límite se sube a mano, no hay un botón de «plan superior».
• Dos trabajos en vuelo como máximo. No es un bloqueo técnico sino una regla de uso: los workers de GPU son compartidos, así que una tanda debe encadenar trabajos, no lanzar cincuenta a la vez.
• Un tope diario de tiempo de GPU para todo el servicio. Si se agota, la creación de trabajos responde con un error 503 y el texto «La capacidad de hoy se ha agotado. Vuelve mañana: se renueva a medianoche (UTC)». No se cobra nada. Es un seguro contra un uso masivo; un cliente que respeta el límite por hora no lo toca.
• Arranque en frío. Los modelos no están siempre cargados. Si nadie ha usado una herramienta en los últimos minutos, el primer trabajo arranca un worker y carga los pesos: la documentación habla de 60 a 90 segundos extra la primera vez. Los siguientes trabajos van a la velocidad normal. Un ×16 de una imagen grande puede tardar varios minutos aunque el worker esté caliente.
• Tamaños. Entrada hasta 100 MB por archivo (a partir de unos 90 MB, subida por trozos); 32 megapíxeles para el ×4 directo, quitar fondo, ruido, color y borrado; 25 MP para enfocar; 20 MP para restaurar; 37,5 MP para los modos de gran formato; salida hasta 600 MP.

Para que te hagas una idea de la velocidad en caliente, con datos nuestros: en las pruebas de Airpic del 19 de septiembre de 2026, una foto de 320 × 240 píxeles ampliada ×4 a 1280 × 960 tardó 5 segundos. En las del 3 de septiembre de 2026, con fotos de 0,3 a 1 megapíxel, el ×4 tardó entre 6 y 9 segundos, y con «mejorar caras» activado, unos 17 segundos. Son tiempos de proceso en la GPU, sin contar tu subida ni la descarga.

De aquí sale la advertencia honesta: esta API no sirve para procesar imágenes en tiempo real dentro de una petición de usuario. Si tu idea es ampliar la foto cuando alguien carga la página, el arranque en frío de un minuto y los 20 trabajos por hora lo hacen inviable; además, un visitante esperando 90 segundos se marcha. El encaje natural es asíncrono: una cola en tu servidor que procesa el catálogo por la noche, un script que trata las fotos cuando entran al almacén, una tarea programada que genera las versiones para imprimir. Otro punto que suele pillar por sorpresa: la descarga gratis del mes es por IP, y en un servidor todas tus llamadas salen por la misma, así que no cuentes con ella en producción. Y recuerda que el archivo se borra una hora después de descargarlo (un día como máximo si no lo haces): tu código debe guardar el resultado en tu lado, no volver a pedírselo a Airpic. Dónde se procesa y cuándo se borra, con detalle, en el artículo sobre procesamiento de imágenes con IA en la UE.

Ejemplo mínimo de API upscale image: subir, consultar estado y descargar

Si has llegado buscando «api upscale image», probablemente ya tienes el flujo en la cabeza. En Airpic son tres llamadas HTTP sin SDK:

1. Subir y crear el trabajo. Una petición POST multipart a la ruta de trabajos con cuatro campos: el archivo, el nombre de la herramienta (upscale, remove-bg, compress y el resto), un JSON de opciones con los mismos ajustes que la web (para ampliar: modo x4, estilo sharp y caras a true si hay retratos) y el idioma en que quieres los mensajes de error. La respuesta es un identificador de trabajo.
2. Consultar el estado. Una petición GET al trabajo cada 1 o 2 segundos. Verás queued, luego processing y al final done con los datos de salida: ancho, alto, bytes, extensión, la ruta de descarga y la ruta de la vista previa. Si el worker avisa de algo (por ejemplo, que no encontró caras aunque pediste mejorarlas) llega una nota. Si algo sale mal, el estado es error y no se cobra.
3. Descargar. Una petición GET a la ruta de descarga con la cabecera Authorization: Bearer y tu código 0TK. Si hay saldo, recibes el archivo completo y se descuenta 1 crédito; si no, un 402 con el tipo de crédito que falta. Antes de este paso puedes pedir la vista previa sin cabecera alguna y decidir.

Los nombres exactos de rutas y campos están en airpic.app/developers, con ejemplos en curl listos para copiar.

Antes de escribir una sola línea, conviene hacer el mismo recorrido a mano para ver qué hace cada parámetro. Es el mismo motor y los mismos nombres:

1. Sube una foto de las que vas a tratar en tu proceso (arrastra, elige o pega con Ctrl+V). Aparece una tarjeta con la miniatura, el nombre y las dimensiones de entrada y salida.
2. Elige el factor. ×2 o ×4 para web y pantalla (crédito estándar); si marcas «Para imprimir en grande», pasas a ×8, ×16 o máximo (gran formato). La tarjeta actualiza el tamaño de salida: es el mismo valor que te devolverá la API en el estado del trabajo.
3. Abre «Ajustes avanzados». Ahí están «Estilo» (nitidez para fotos, pictórico para imágenes con textura) y el formato de salida (PNG, JPG o WebP). Son los campos de estilo y formato del JSON.
4. Marca «Mejorar caras» solo si hay retratos. Suma unos segundos por imagen; en fotos sin personas no aporta nada y recibirás una nota avisando de que no se encontró ninguna cara.
5. Pulsa Procesar. Verás la barra de progreso y, al terminar, el comparador con el antes y el después y el botón «Ver al 100 %» para inspeccionar el píxel real. Hasta aquí no has gastado nada: es la misma vista previa que la API sirve gratis.
6. Descarga con el botón que indica formato y dimensiones. Si ya tienes un código, es el que usarás como Bearer. Si no, la descarga gratis del mes te sirve para esta prueba.

Cuando el resultado a mano sea el que quieres, los ajustes que has tocado son exactamente los que mandarás en el JSON. Empieza en la página para ampliar una imagen y después pasa al script.

FAQ

Seguir leyendo