Tutorial de la API de compresión de imágenes

MiniPic ofrece una API de compresión de imágenes compatible con la autenticación HTTP Basic / Bearer y la estructura de respuesta de los servicios de compresión populares, así que en la mayoría de los casos puedes migrar desde TinyPNG y servicios similares con solo cambiar el endpoint y la clave de la API. Nuestro motor propio reduce PNG, JPEG y WebP un 60 % de media sin pérdida visible de calidad, hay una cuota mensual gratuita y solo se te factura por las compresiones correctas. Para la referencia completa del endpoint, consulta la documentación para desarrolladores (minipic.ai/docs).

Por qué elegir la API de compresión de imágenes de MiniPic

Compatible con las API de compresión populares: misma autenticación y estructura de respuesta; en la mayoría de los casos integras cambiando el endpoint y la clave.
Rápida, baja latencia: subidas y respuestas rápidas, para que las llamadas al servicio no se atasquen.
Cuota mensual gratuita: se reinicia el primer día de cada mes: suficiente para arrancar un proyecto típico.
Facturado solo por las compresiones correctas: los fallos, los archivos que superan el límite y las solicitudes bloqueadas nunca se facturan.

Integra en 3 pasos

Paso 1: crea una clave de API en la consola

Inicia sesión en la consola de MiniPic y ve a gestión de claves de API para crear una clave. Las claves llevan el prefijo mp_live_ (producción) / mp_test_ (sandbox); la clave completa se muestra solo una vez en la creación, así que guárdala de forma segura.

Paso 2: envía tu primera solicitud de compresión

Usa autenticación HTTP Basic (el usuario es siempre api, la contraseña es tu clave) para comprimir una imagen:

# Comprimir un PNG (autenticación Basic, el usuario es siempre api) curl -s --user api:TU_CLAVE_DE_API \ --data-binary @input.png \ -o output.png \ https://api.minipic.ai/v1/compress

Paso 3: obtén y descarga el resultado

El endpoint de compatibilidad /shrink devuelve 201 Created, con el resultado servido mediante un enlace privado cifrado al que solo tú (el titular de la clave) puedes acceder; el endpoint nativo /v1/compress devuelve directamente el binario comprimido. Volver a descargar el mismo resultado no se factura.

Ejemplo en Node.js

// Node.js (>=18, fetch integrado): lee una imagen local y comprímela import { readFile, writeFile } from "node:fs/promises"; const key = process.env.MINIPIC_API_KEY; const auth = "Basic " + Buffer.from("api:" + key).toString("base64"); const res = await fetch("https://api.minipic.ai/v1/compress?quality=smart&format=keep", { method: "POST", headers: { Authorization: auth }, body: await readFile("input.png"), }); await writeFile("output.png", Buffer.from(await res.arrayBuffer())); console.log("Comprimida, ahorrado", res.headers.get("X-Ratio"));

Ejemplo en Python

# Python (requests): lee una imagen local y comprímela import os, requests key = os.environ["MINIPIC_API_KEY"] with open("input.jpg", "rb") as f: res = requests.post( "https://api.minipic.ai/v1/compress", params={"quality": "smart", "format": "keep"}, auth=("api", key), data=f.read(), ) with open("output.jpg", "wb") as out: out.write(res.content) print("Comprimida, ahorrado", res.headers.get("X-Ratio"))

Migrar desde la API de TinyPNG

MiniPic es compatible con la autenticación y la estructura de respuesta de los servicios de compresión populares, así que en la mayoría de los casos puedes migrar desde TinyPNG y servicios similares con solo cambiar el endpoint y la clave de la API, sin modificar el código de tu aplicación. Apunta la URL base a MiniPic (minipic.ai), cambia a tu clave de API de MiniPic y empieza a comprimir.

Cuota, límites de tasa y facturación

Cuota gratuita: un número fijo de solicitudes al mes, que se reinicia el primer día de cada mes.
Precios escalonados: la tarifa por imagen disminuye a medida que crece tu volumen mensual.
Facturación: solo se te cobra por las compresiones correctas; los fallos, los archivos que superan el límite y las solicitudes bloqueadas nunca se facturan.
Límite de tasa: 10 sol/s por clave, ráfaga 20; superarlo devuelve 429 + Retry-After.

Para la referencia completa del endpoint y la tabla de códigos de error, consulta la documentación para desarrolladores; para los niveles de precios, consulta la página de precios; para los detalles de facturación, consulta facturación.

Preguntas frecuentes

¿Cómo integro la API de compresión de imágenes de MiniPic?

Crea una clave de API en la consola de MiniPic y luego envía tu solicitud al endpoint de compresión usando autenticación HTTP Basic (usuario api, contraseña tu clave) o un token Bearer. La API es compatible con la autenticación y la estructura de respuesta de los servicios de compresión más populares, así que en la mayoría de los casos solo necesitas cambiar el endpoint y la clave.

¿Es gratuita la API de compresión de imágenes de MiniPic?

Hay una cuota mensual gratuita que se reinicia el primer día de cada mes. A partir de ahí, el uso se factura por imagen comprimida correctamente con tarifas escalonadas. Solo se te cobra por las compresiones correctas: los fallos, los archivos que superan el límite y las solicitudes bloqueadas nunca se facturan.

¿Puedo migrar de la API de TinyPNG a MiniPic?

Sí. El endpoint /shrink de MiniPic es compatible con la autenticación y la estructura de respuesta de los servicios de compresión más populares, así que en la mayoría de los casos puedes migrar cambiando el endpoint y la clave de la API, sin modificar el código de tu aplicación.

Integra en 3 pasos, con una cuota mensual gratuita

Crea una clave de API y luego cambia el endpoint y la clave para empezar a comprimir.

Crea una clave de API, empieza gratis →Ver la documentación completa de la API Ver los precios de la API