Para desarrolladores y usuarios de la API

API de optimización de imágenes para desarrolladoresTodo el proceso sobre una API REST

¿Construyes sitios para los negocios de tus clientes? Todo el proceso sobre una API REST, con archivos JSON complementarios para tu propio CMS: el texto de búsqueda y las notas de ubicación del marco HEART de Google para cada imagen.

Primer plano del código de un sitio web en un editor de texto, con sintaxis de PHP de Laravel y estructura HTML
Clave de API
Autenticación
JSON + SSE
Formato de respuesta
60 por minuto en Pro, 120 en Agency
Límite de solicitudes

Lo que cuesta hacerlo por tu cuenta

  • Incorporar la compresión de imágenes en un CMS personalizado exige bibliotecas de códec de bajo nivel
  • Las API de visión por IA cobran por llamada y no incluyen un proceso de compresión
  • Integrar herramientas separadas para compresión, conversión y metadatos es complejo
  • Monitorear el uso de créditos en varios proyectos exige un seguimiento por clave
  • Alojar tu propia infraestructura de procesamiento de imágenes cuesta más que los créditos de la API

Lo que regresa por cada imagen

De nuestra prueba con muestra, la foto de un cliente: arquitecto, de 1,9 MB a 380 KB en AVIF (funciona en Free). El texto alternativo lo escribe la IA, en Starter y superiores.
ElementoAntesDespués
ArchivoJPG original · 1,9 MBmodern-luxury-villa-with-swimming-pool-landscape.avif · 380 KB
Texto alternativo(vacío)Modern two-story luxury villa featuring large glass windows and a turquoise swimming pool under a blue sky [Villa de lujo moderna de dos pisos con grandes ventanales y una piscina turquesa bajo un cielo azul]
TamañosUn solo archivo de tamaño completo150×150 · 300w · 768w · 1024w
MetadatosNingunoArchivo JSON complementario: título, texto alternativo, pie de foto, palabras clave
Desarrolladores y usuarios de API

Cómo encaja con tu forma de trabajar

Arquitectura de la API

La API REST sigue un flujo de trabajo basado en sesiones:

1. Crea una sesión: POST /v1/sessions con tus imágenes.
2. Analiza: POST /v1/analyze para ejecutar la visión por IA sobre las imágenes de la sesión. Las respuestas llegan mediante Server-Sent Events.
3. Revisa los metadatos: GET a los resultados del análisis. Edítalos si hace falta.
4. Exporta: POST /v1/export con tu formato, calidad y ajustes de redimensionado.
5. Descarga: GET a los archivos procesados.

Cada paso puede llamarse por separado. Ejecuta solo el análisis. Ejecuta solo la exportación. Omite los pasos que no necesites.

Autenticación y créditos

Autentícate con una clave de API en el encabezado X-API-Key. El acceso a la API empieza en Pro: Pro incluye 5 claves, Agency 20. Free y Starter no tienen acceso a la API.

Cada llamada a la API que procesa una imagen descuenta créditos de tu saldo. Consulta tu saldo con GET /v1/credits/balance. Calcula el costo antes de comprometer un lote con POST /v1/credits/check.

Ejemplos de integración

Pipeline de CI/CD: agrega un paso de procesamiento de imágenes a tu compilación. Antes del despliegue, envía todas las imágenes nuevas a la API. Reemplaza los archivos fuente por la salida optimizada. Despliega.

CMS headless: cuando un editor de contenido sube una imagen, tu backend la envía a Picture Optimizer, recibe la versión optimizada y la guarda en tu almacenamiento de activos.

Generador de sitios estáticos: durante la compilación, revisa el directorio /images. Envía cada archivo a la API. Reemplázalo por la salida optimizada. Compila el sitio con imágenes comprimidas y con metadatos.

Enterprise · by enquiry

We do it for you, with our designers and photography experts.

For large stores, catalogues and blogs. We resize, convert and tune every image, then upload SEO alt text and EXIF to your site. No file is too big.

Preguntas

Lo que la gente pregunta antes de empezar.

La API usa solicitudes HTTP estándar con respuestas JSON. Cualquier cliente HTTP funciona: cURL, fetch, axios, requests. Hoy no hay un SDK específico para ningún lenguaje.

Novedades del blog: Velocidad de página y Core Web Vitals