Pixlet API · Для разработчиков

Оживите ваши пиксели — прямо в вашем коде

REST API и вебхуки Pixlet превращают любой бэкенд в фабрику анимированных стикеров, эмодзи и микровидео. Генерируйте, рендерьте и доставляйте анимацию из одной строки кода — без GUI, без ожидания, без ограничений.

  • REST + WebSocket
  • SDK на Python, JS, Go
  • SLA 99.95%
Обзор API

Эндпоинты, которые делают всё за вас

Единая точка входа api.pixlet.dev/v3. Все методы возвращают JSON, поддерживают идемпотентность и работают с OAuth 2.0 или API-ключом.

POST /v3/renders

Создаёт задачу рендера. Принимает исходник (URL или base64), стиль, fps и целевой формат. Возвращает render_id и ссылку на статус.

GET /v3/renders/{id}

Получает прогресс и результат задачи. Поля: status, progress, output_url, bytes.

POST /v3/webhooks

Подписываете webhook на событие render.completed. Pixlet шлёт HMAC-подписанный payload, когда анимация готова к скачиванию.

POST /v3/stickers/batch

Пакетная генерация до 50 стикеров за один вызов. Идеально для каталогов, ботов и игровых ассетов. Приоритетная очередь на тарифах Dev+ и выше.

GET /v3/presets

Список всех 40+ неоновых пресетов с JSON-схемой параметров. Можно передавать ID пресета в /renders или оверрайдить конкретные поля.

GET /v3/assets/{id}/download

Прямая ссылка на рендер в выбранном формате: GIF, MP4 (H.264), APNG, WebM. Поддерживает CDN-кэширование и параметр ?width= для ресайза на лету.

Примеры кода

От строки кода до живого стикера

Два минимальных примера — Python и JavaScript. Скопируйте, подставьте ключ и получите готовую анимацию за ~3 секунды.

Python · requests

# pip install pixlet-sdk
import pixlet

client = pixlet.Client(api_key="px_live_9f2c...")

render = client.renders.create(
    source="https://cdn.example/cat.png",
    preset="neon-pulse",
    fps=12,
    format="apng",
)

# ждём завершения
url = render.wait(timeout=30).output_url
print(url)
# → https://cdn.pixlet.dev/r/8a3f…/cat.apng

JavaScript · fetch

const key = "px_live_9f2c...";

async function renderSticker(imgUrl, preset) {
  const res = await fetch(
    "https://api.pixlet.dev/v3/renders",
    {
      method: "POST",
      headers: {
        "Authorization": `Bearer ${key}`,
        "Content-Type": "application/json",
      },
      body: JSON.stringify({
        source: imgUrl,
        preset,
        fps: 12,
        format: "gif",
      }),
    }
  );
  return res.json();
}
Скриншот редактора Pixlet API Console с примером запроса и ответом
Документация и лимиты

Прозрачные лимиты, быстрые ответы

Полная документация — в OpenAPI-справке. Ниже — ключевые ограничения по тарифам.

Rate limits

Free: 60 запросов/мин, 10 000 рендеров/мес. Dev: 600/мин, без месячного лимита. Dev+: 3 000/мин и приоритетная очередь рендера.

Размер исходника

До 25 МБ на файл. Поддерживаются PNG, JPG, WebP, SVG (до 2000×2000 px). Для микровидео — MP4/WebM до 30 секунд и 1080p.

Хранение ассетов

Рендеры хранятся в CDN 30 дней на Free, 90 дней на Dev, бессрочно на Dev+. Прямые ссылки кэшируются и работают из любой точки мира.

Версии API

Актуальная версия — v3 (релиз 14.03.2025). v2 остаётся в поддержке до 31.12.2026. Все изменения анонсируются за 90 дней в changelog.

SDK и примеры

Официальные библиотеки: pixlet-sdk (Python), @pixlet/js (Node/TS), pixlet-go. Плюс 20+ готовых сниппетов для ботов Telegram и Discord.

Ошибки и ретраи

Стандартные коды HTTP. Для 429 и 5xx Pixlet возвращает заголовок Retry-After. SDK автоматически повторяет запрос с экспоненциальным бэкоффом.

Планы для разработчиков

Выберите темп, под который работает ваш продукт

Все тарифы включают полный доступ к API v3, webhook-подписки и доступ к 40+ пресетам. Разница — в лимитах, SLA и поддержке.

Free Dev

0 ₽

Для прототипов и хобби-проектов. 10 000 рендеров в месяц, 60 запросов/мин, хранение 30 дней. Водяной знак на выводе.

Начать бесплатно

Dev

4 900 ₽/мес

Для стартапов и side-проектов. Без месячного лимита, 600 запросов/мин, хранение 90 дней, без водяного знака, приоритетная почта.

Подключить Dev

Dev+

14 900 ₽/мес

Для продакшена. 3 000 запросов/мин, приоритетная очередь рендера, бессрочное хранение, SLA 99.95%, выделенный инженер на связи.

Оставить заявку

Enterprise

По запросу

Для банков, ритейла и игровых студий. On-premise или private cloud, кастомные лимиты, DPA, аудит-логи, 24/7 поддержка и персональный SLA до 99.99%.

Связаться с продажами
Поддержка и SLA

Когда код не работает — мы уже рядом

Команда Pixlet DevRel и SRE отвечает на вопросы разработчиков и держит платформу в рабочем состоянии 24/7.

SLA 99.95%

Гарантия доступности API на тарифах Dev и выше. За каждый процент простоя сверх нормы — кредит на счёт до 25% месячной оплаты. Статус в реальном времени: status.pixlet.dev.

Каналы поддержки

Публичный форум, почта dev@pixlet.ru, Telegram-канал #pixlet-dev. На Dev+ — выделенный инженер и приватный Slack-канал с ответом в течение 2 часов в рабочие часы.

Changelog и roadmap

Каждый релиз с датой, номером версии и описанием брейкинг-чейнж. Roadmap открыт — голосуйте за фичи на форуме. Последний крупный релиз: v3.4 (02.05.2025) с пакетным рендером и WebP-выводом.

DevDays и вебинары

Ежемесячные 45-минутные сессии с инженерами Pixlet: новые пресеты, оптимизация рендера, кейсы клиентов. Записи — в DevDays-архиве. Ближайший стрим: 18 июня в 19:00 МСК.

Готовы встроить анимацию в свой продукт?

Получите API-ключ за 30 секунд и сделайте первый рендер уже сегодня. Первые 10 000 запросов — бесплатно, без карты.

Получить API-ключ
Вопросы разработчиков

Коротко о техническом

Два варианта: статический API-ключ в заголовке Authorization: Bearer или OAuth 2.0 с scope render.write для сервисов с пользовательскими сессиями. Ключи можно ротировать в кабинете без простоя.

Да, на тарифе Enterprise доступна on-premise установка в Kubernetes или private cloud. Лицензия включает обновления, патчи и выделенную поддержку. Развёртывание занимает 1–2 дня.

Исходники и рендеры хранятся в шифрованном объектном хранилище. Мы не используем их для обучения моделей и не передаём третьим лицам. Для Enterprise доступен DPA и аудит-лог всех обращений.

Да, 14 дней Dev-тарифа без карты. После окончания — автоматический переход на Free Dev, все ключи и вебхуки продолжают работать, просто с лимитами бесплатного плана.

Официально — Python, Node.js/TypeScript и Go. Для iOS и Android рекомендуем тонкую обёртку над REST API — примеры в репозитории pixlet-mobile-examples. Обработка идёт в облаке, так что устройство не нагружается.