Tutorial da API de compressão de imagens

O MiniPic oferece uma API de compressão de imagens compatível com a autenticação HTTP Basic / Bearer e o formato de resposta de serviços de compressão populares, então na maioria dos casos você pode migrar do TinyPNG e de serviços parecidos apenas trocando o endpoint e a chave da API. Nosso motor próprio reduz PNG, JPEG e WebP em 60% em média, sem perda visível de qualidade, há uma cota mensal gratuita, e você só é cobrado por compressões bem-sucedidas. Para a referência completa dos endpoints, veja a documentação para desenvolvedores (minipic.ai/docs).

Por que escolher a API de compressão de imagens do MiniPic

Compatível com APIs de compressão populares: mesma autenticação e formato de resposta — na maioria dos casos você integra trocando o endpoint e a chave.
Rápida, baixa latência: uploads e respostas ágeis, para que as chamadas ao serviço não travem.
Cota mensal gratuita: é reiniciada no primeiro dia de cada mês — suficiente para começar um projeto típico.
Cobrança apenas por compressões bem-sucedidas: falhas, arquivos grandes demais e requisições bloqueadas nunca são cobrados.

Integre em 3 passos

Passo 1: crie uma chave de API no console

Entre no console do MiniPic e vá até o gerenciamento de chaves de API para criar uma chave. As chaves têm o prefixo mp_live_ (produção) / mp_test_ (sandbox); a chave completa é exibida apenas uma vez na criação, então guarde-a com segurança.

Passo 2: envie sua primeira requisição de compressão

Use a autenticação HTTP Basic (o usuário é sempre api, a senha é a sua chave) para comprimir uma imagem:

# Comprime um PNG (autenticação Basic, usuário é sempre api) curl -s --user api:SUA_CHAVE_DE_API \ --data-binary @input.png \ -o output.png \ https://api.minipic.ai/v1/compress

Passo 3: obtenha e baixe o resultado

O endpoint de compatibilidade /shrink retorna 201 Created, com o resultado servido por um link privado criptografado que só você (o detentor da chave) pode acessar; o endpoint nativo /v1/compress retorna o binário comprimido diretamente. Baixar novamente o mesmo resultado não é cobrado.

Exemplo em Node.js

// Node.js (>=18, fetch nativo): lê uma imagem local e a comprime 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("Comprimido, economizou", res.headers.get("X-Ratio"));

Exemplo em Python

# Python (requests): lê uma imagem local e a comprime 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("Comprimido, economizou", res.headers.get("X-Ratio"))

Migrando da API do TinyPNG

O MiniPic é compatível com a autenticação e o formato de resposta de serviços de compressão populares, então na maioria dos casos você pode migrar do TinyPNG e de serviços parecidos apenas trocando o endpoint e a chave da API, sem alterações no código da sua aplicação. Aponte a URL base para o MiniPic (minipic.ai), insira sua chave de API do MiniPic e comece a comprimir.

Cota, limites de taxa e cobrança

Cota gratuita: um número fixo de requisições por mês, reiniciado no primeiro dia de cada mês.
Preços por faixa: o valor por imagem diminui conforme seu volume mensal cresce.
Cobrança: você é cobrado apenas por compressões bem-sucedidas; falhas, arquivos grandes demais e requisições bloqueadas nunca são cobrados.
Limite de taxa: 10 req/s por chave, burst de 20; ao ultrapassar, retorna 429 + Retry-After.

Para a referência completa dos endpoints e a tabela de códigos de erro, veja a documentação para desenvolvedores; para as faixas de preço, veja a página de preços; para detalhes de cobrança, veja cobrança.

Perguntas frequentes

Como faço para integrar a API de compressão de imagens do MiniPic?

Crie uma chave de API no console do MiniPic e, depois, envie sua requisição ao endpoint de compressão usando a autenticação HTTP Basic (usuário api, senha a sua chave) ou um token Bearer. A API é compatível com a autenticação e o formato de resposta de serviços de compressão populares, então na maioria dos casos você só precisa trocar o endpoint e a chave.

A API de compressão de imagens do MiniPic é gratuita?

Há uma cota mensal gratuita que é reiniciada no primeiro dia de cada mês. Além disso, o uso é cobrado por imagem comprimida com sucesso, em valores por faixa. Você só é cobrado por compressões bem-sucedidas — falhas, arquivos grandes demais e requisições bloqueadas nunca são cobrados.

Posso migrar da API do TinyPNG para o MiniPic?

Sim. O endpoint /shrink do MiniPic é compatível com a autenticação e o formato de resposta de serviços de compressão populares, então na maioria dos casos você pode migrar mudando o endpoint e a chave da API, sem alterações no código da sua aplicação.

Integre em 3 passos, com cota mensal gratuita

Crie uma chave de API e, depois, troque o endpoint e a chave para começar a comprimir.

Crie uma chave de API, comece grátis →Ver as docs completas da API Ver os preços da API