Para desenvolvedores e usuários de API

API de otimização de imagens para desenvolvedoresTodo o fluxo por uma REST API

Está construindo sites para os negócios dos seus clientes? Todo o fluxo por uma REST API, com arquivos JSON complementares para o seu próprio CMS: o texto de busca mais as notas de posicionamento do framework HEART do Google para cada imagem.

Close do código de um site em um editor de texto, com sintaxe PHP do Laravel e estrutura HTML
Chave de API
Autenticação
JSON + SSE
Formato de resposta
60 por minuto no Pro, 120 no Agency
Limite de requisições

O que custa fazer isso por conta própria

  • Incorporar compressão de imagens em um CMS próprio exige bibliotecas de codec de baixo nível
  • APIs de visão por IA cobram por chamada e não trazem um fluxo de compressão junto
  • Integrar ferramentas separadas para compressão, conversão e metadados é complexo
  • Acompanhar o uso de créditos em vários projetos exige controle por chave
  • Hospedar a própria infraestrutura de processamento de imagens custa mais que créditos de API

O que volta para cada imagem

Da nossa amostra, a foto de um cliente: arquiteto, de 1,9 MB para 380 KB em AVIF (funciona no Free). O texto alternativo é escrito pela IA, a partir do Starter.
ItemAntesDepois
ArquivoJPG original · 1,9 MBmodern-luxury-villa-with-swimming-pool-landscape.avif · 380 KB
Texto alternativo(vazio)"Modern two-story luxury villa featuring large glass windows and a turquoise swimming pool under a blue sky" [Villa de luxo moderna de dois andares, com grandes janelas de vidro e uma piscina turquesa sob um céu azul]
TamanhosUm arquivo em tamanho completo150×150 · 300w · 768w · 1024w
MetadadosNenhumArquivo JSON complementar: título, texto alternativo, legenda e palavras-chave
Desenvolvedores e usuários de API

Como se encaixa no seu jeito de trabalhar

Arquitetura da API

A REST API segue um fluxo baseado em sessão:

1. Crie uma sessão: POST /v1/sessions com as suas imagens.
2. Analise: POST /v1/analyze para rodar a visão de IA nas imagens da sessão. As respostas são transmitidas via Server-Sent Events.
3. Revise os metadados: GET nos resultados da análise. Edite se necessário.
4. Exporte: POST /v1/export com o seu formato, qualidade e configurações de redimensionamento.
5. Baixe: GET nos arquivos processados.

Cada etapa pode ser chamada de forma independente. Rode apenas a análise. Rode apenas a exportação. Pule as etapas de que não precisa.

Autenticação e créditos

Autentique-se com uma chave de API no cabeçalho X-API-Key. O acesso à API começa no Pro: o Pro tem 5 chaves, e o Agency, 20. Free e Starter não têm acesso à API.

Cada chamada à API que processa uma imagem debita créditos do saldo da sua conta. Verifique o saldo em GET /v1/credits/balance. Confira os custos antes de confirmar um lote com POST /v1/credits/check.

Exemplos de integração

Pipeline de CI/CD: adicione uma etapa de processamento de imagens ao seu build. Antes do deploy, envie por POST todas as imagens novas para a API. Substitua os arquivos de origem pela saída otimizada. Faça o deploy.

CMS headless: quando um editor de conteúdo envia uma imagem, o seu backend faz POST dela no Picture Optimizer, recebe a versão otimizada e a armazena no seu armazenamento de ativos.

Gerador de sites estáticos: durante o build, percorra o diretório /images. Envie por POST cada arquivo para a API. Substitua-o pela saída otimizada. Gere o site com imagens comprimidas e com metadados.

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.

Perguntas

O que as pessoas perguntam antes de começar.

A API usa requisições HTTP padrão com respostas em JSON. Qualquer cliente HTTP funciona: cURL, fetch, axios, requests. Hoje não há SDK específico para nenhuma linguagem.

Novidades do blog: Velocidade da página e Core Web Vitals