Przewodnik szybkiego startu

Zoptymalizuj materiały graficzne i popraw wskaźniki Core Web Vitals (LCP i CLS) w 4 prostych krokach.

Wdrożenie w 4 krokach

Krok 1: Wygeneruj klucz API

Zaloguj się do Panelu SmallPict za pomocą bezpiecznego logowania bezhasłowego kodem OTP przesyłanym na e-mail. W sekcji API Keys utwórz nowy klucz:

• Użyj sp_live_... w środowisku produkcyjnym.
• Użyj sp_test_... do testów lokalnych i w zautomatyzowanych potokach CI/CD.

Krok 2: Wybierz metodę integracji

Opcja A: Wtyczka WordPress

Zainstaluj oficjalną wtyczkę z katalogu WordPress lub wgraj plik ZIP. Wprowadź klucz sp_wp_... w Ustawienia > SmallPict i włącz automatyczną konwersję do formatów WebP i AVIF.

Opcja B: Biblioteka SDK (Backend lub Frontend)

Zainstaluj odpowiedni pakiet dla swojego środowiska:

# 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

Krok 3: Wykonaj pierwszą optymalizację

Przetestuj połączenie z API za pomocą polecenia cURL:

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  }}'

Krok 4: Sprawdź wynik

W odpowiedzi otrzymasz obiekt JSON zawierający bezpośredni adres URL zoptymalizowanego obrazu oraz uzyskany procent oszczędności:

{  "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"  }}

Zalecane ustawienia domyślne