Guía de inicio rápido
Comienza a comprimir imágenes y optimizar el rendimiento web en menos de 5 minutos.
Optimiza tus recursos visuales y mejora las métricas de Core Web Vitals (LCP y CLS) en solo 4 sencillos pasos.
Proceso de inicio en 4 pasos
Paso 1: Obtén tu clave de API
Inicia sesión en el Panel de SmallPict mediante autenticación OTP sin contraseña. En la sección API Keys, genera una nueva clave:
- Usa
sp_live_...para entornos de producción. - Usa
sp_test_...para desarrollo local y pipelines de pruebas automatizadas.
Paso 2: Elige tu método de integración
Selecciona la opción de integración ideal para tu flujo de trabajo:
Opción A: WordPress
Instala el plugin oficial desde el directorio de plugins de WordPress o sube el archivo ZIP desde nuestro repositorio de lanzamientos. Introduce tu clave sp_wp_... en Ajustes > SmallPict y activa la conversión automática a WebP/AVIF.
Opción B: SDK Backend o Frontend
Instala el paquete oficial correspondiente a tu lenguaje de programación:
# 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 smallpictPaso 3: Ejecuta tu primera optimización
Utiliza este ejemplo en cURL para verificar la conectividad de tu clave 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 }}'Paso 4: Verifica el resultado
La API devolverá una respuesta JSON con la URL de la imagen optimizada y el porcentaje de ahorro:
{ "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 de configuración recomendados
| Parámetro | Valor recomendado | Explicación |
|---|---|---|
| Calidad | 80 | Equilibrio óptimo entre fidelidad visual y compresión de peso. |
| Formato | avif con fallback a webp | Máxima compresión en navegadores modernos y soporte universal. |
| Ancho máximo | 1920px | Previene que imágenes de cámaras sobredimensionadas degraden el ancho de banda móvil. |
| Eliminar EXIF | true | Elimina datos de geolocalización y metadatos privados de cámaras para máxima privacidad. |