Guia de início rápido
Comece a comprimir imagens e otimizar a velocidade web em menos de 5 minutos.
Otimize seus recursos visuais e melhore as métricas do Core Web Vitals (LCP e CLS) em 4 etapas simples.
Processo de início em 4 etapas
Etapa 1: Obtenha sua chave de API
Acesse o Painel do SmallPict com login seguro sem senha por OTP. Na seção API Keys, gere uma nova chave:
- Use
sp_live_...para produção. - Use
sp_test_...para desenvolvimento local e testes automatizados.
Etapa 2: Escolha seu método de integração
Opção A: WordPress
Instale o plugin oficial pelo repositório do WordPress ou envie o arquivo ZIP. Insira sua chave sp_wp_... em Configurações > SmallPict e habilite a conversão automática para WebP/AVIF.
Opção B: SDK Backend ou Frontend
Instale a biblioteca nativa correspondente ao seu ambiente:
# Node.js & TypeScriptnpm install @smallpict/sdk
# Golanggo get github.com/smallpict/smallpict-go
# Pythonpip install smallpict
# PHP (Composer)composer require smallpict/smallpict-php
# Rust (Cargo)cargo add smallpict
# Ruby (Bundler)gem install smallpictEtapa 3: Execute sua primeira otimização
Execute uma chamada cURL para validar sua chave de API:
curl -X POST https://api.smallpict.app/v1/optimize \ -H "X-API-Key: sp_sdk_9a8b7c6d5e4f..." \ -H "X-Timestamp: 1716301234" \ -H "X-Signature: 3a9f8b2c4d6e8a..." \ -H "Content-Type: application/json" \ -d { "filename": "hero.jpg", "mime_type": "image/jpeg", "filesize": 2508800, "options": { "format": "avif", "quality": 80, "max_width": 1920 }}'Etapa 4: Valide o resultado
A API responderá com o payload JSON contendo a URL da imagem otimizada e a porcentagem de economia:
{ "success": true, "data": { "job_id": "job_9a8b7c6d5e4f", "status": "completed", "original_size": 2508800, "optimized_size": 312400, "savings_percentage": 87.54, "format": "avif", "url": "https://cdn.smallpict.app/media/hero.avif" }}Parâmetros recomendados de configuração
| Parâmetro | Valor recomendado | Finalidade |
|---|---|---|
| Qualidade | 80 | Bom equilíbrio entre clareza visual e peso reduzido. |
| Formato | avif com fallback para webp | Máxima compressão para navegadores modernos com suporte universal. |
| Largura máxima | 1920px | Evita que fotos brutas de câmeras sobrecarreguem telas móveis. |
| Remover EXIF | true | Descarta geolocalização e metadados de câmeras para privacidade e economia. |