Перейти к содержимому
smallPict

Руководство по быстрому старту

Начните сжимать изображения и ускорять загрузку сайта менее чем за 5 минут.

Оптимизируйте графический контент и улучшите показатели Core Web Vitals (LCP и CLS) всего за 4 простых шага.


Настройка за 4 шага

Шаг 1: Получите API-ключ

Войдите в Панель управления SmallPict с помощью беспарольного входа по коду OTP на почту. В разделе API Keys создайте новый ключ:

  • Используйте sp_live_... для рабочей среды.
  • Используйте sp_test_... для локальной разработки и автоматических тестов CI/CD.

Шаг 2: Выберите способ интеграции

Вариант A: WordPress

Установите официальный плагин из каталога WordPress или загрузите ZIP-архив. Введите ключ sp_wp_... в разделе Настройки > SmallPict и включите автоматическую конвертацию в WebP и AVIF.

Вариант B: Backend или Frontend SDK

Установите библиотеку для вашего языка программирования:

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

Шаг 3: Выполните первую оптимизацию

Проверьте подключение к API с помощью команды cURL:

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

Шаг 4: Проверьте результат

В ответе API вернется JSON-объект со ссылкой на оптимизированное изображение и процентом экономии:

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

Рекомендуемые параметры

ПараметрЗначениеНазначение
Качество80Оптимальный баланс между четкостью изображения и экономией веса.
Форматavif с откатом к webpМаксимальное сжатие в современных браузерах и полная совместимость.
Максимальная ширина1920pxПредотвращает перегрузку мобильных сетей тяжелыми фотографиями с камер.
Удаление EXIFtrueУдаляет геолокацию и метаданные камер для защиты приватности и снижения веса.