Guide de démarrage rapide
Commencez à compresser vos images et à accélérer votre site en moins de 5 minutes.
Optimisez vos ressources graphiques et améliorez vos scores Core Web Vitals (LCP et CLS) en 4 étapes simples.
Mise en route en 4 étapes
Étape 1 : Obtenez votre clé d'API
Connectez-vous au Tableau de bord SmallPict grâce à l'authentification sans mot de passe par OTP. Dans la section API Keys, créez une nouvelle clé :
- Utilisez
sp_live_...pour vos environnements de production. - Utilisez
sp_test_...pour vos tests locaux et pipelines CI/CD.
Étape 2 : Choisissez votre mode d'intégration
Option A : WordPress
Installez l'extension officielle depuis le répertoire WordPress ou téléversez le fichier ZIP. Renseignez votre clé sp_wp_... dans Réglages > SmallPict et activez la conversion automatique WebP/AVIF.
Option B : SDK Backend ou Frontend
Installez la bibliothèque officielle dans votre environnement de prédilection :
# 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Étape 3 : Effectuez votre première optimisation
Exécutez cette commande cURL pour vérifier la validité de votre clé d'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 }}'Étape 4 : Vérifiez le résultat
L'API renvoie une réponse JSON contenant l'URL du fichier optimisé et le taux d'économie réalisé :
{ "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" }}Paramètres recommandés
| Paramètre | Valeur recommandée | Justification |
|---|---|---|
| Qualité | 80 | Bon équilibre entre clarté visuelle et réduction de poids. |
| Format | avif avec repli sur webp | Compression maximale sur les navigateurs récents avec compatibilité universelle. |
| Largeur max | 1920px | Empêche les photos d'appareils photo brutes de surcharger les connexions mobiles. |
| Suppression EXIF | true | Supprime les données de géolocalisation et métadonnées pour la confidentialité et le gain de poids. |