Saltar al contenido
smallPict

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:

Shell
# 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 smallpict

Paso 3: Ejecuta tu primera optimización

Utiliza este ejemplo en cURL para verificar la conectividad de tu clave de API:

Shell
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:

Response · 200 OK
{  "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ámetroValor recomendadoExplicación
Calidad80Equilibrio óptimo entre fidelidad visual y compresión de peso.
Formatoavif con fallback a webpMáxima compresión en navegadores modernos y soporte universal.
Ancho máximo1920pxPreviene que imágenes de cámaras sobredimensionadas degraden el ancho de banda móvil.
Eliminar EXIFtrueElimina datos de geolocalización y metadatos privados de cámaras para máxima privacidad.