Справочник · Rate limits
Rate limits в Photta API и правила корректного polling
В двух словах
Photta API разрешает 600 запросов в минуту на один API-ключ в фиксированном окне. При 429 возвращается Retry-After: 30. Выполняйте polling задачи каждые 3 секунды; параллельные вызовы ограничены тарифным планом.
- Лимиты: 600 запросов/мин
- Retry-After: Retry-After: 30s
- Обработка: async, polling
Все показатели на этой странице взяты из документации API Photta · проверено
Установленные лимиты
Частота, окно, повторы, размер изображений и форматы — в точном соответствии с документацией.
Лимиты
- 600 запросов в минуту на один API-ключ (Фиксированное окно; лимит одинаков для всех планов)
- Ответ 429 содержит заголовок Retry-After: 30 секунд
- До 10 МБ на изображение
- Форматы: JPEG, PNG, WebP
- Параллельных пакетов на план: Free 1 · Hobby 2 · Seller 3 · Brand 4 · Studio 6
- Только polling — API не отправляет вебхуки.
Параллельная обработка по планам
Сколько пакетов может обрабатываться одновременно, прежде чем отправка вернет 409.
Активные пакеты в обработке по планам
Free
Параллельно: 1
Hobby
Параллельно: 2
Seller
Параллельно: 3
Brand
Параллельно: 4
Studio
Параллельно: 6
Работа в рамках лимитов
Фиксированное окно
Лимит рассчитывается на API-ключ в фиксированном окне и одинаков для всех планов. Два ключа означают два отдельных бюджета.
Polling каждые 3 секунды
Polling — единственный способ узнать о завершении, вебхуки в API не предусмотрены. 3 секунды — рекомендованный документацией интервал; более частые запросы лишь потратят ваш бюджет на пустые ответы.
Используйте экспоненциальную задержку
После 429 подождите указанное в Retry-After количество секунд, а затем увеличивайте интервал при каждой следующей ошибке вместо повторов с фиксированной частотой.
Лимиты на пакетную обработку действуют отдельно
Rate limit считает запросы, а лимит параллелизма — задачи в обработке. Пакет, превышающий лимит, возвращает 409, а не 429.
Вопросы о rate limits
Какой установлен rate limit?
600 запросов в минуту на один API-ключ в рамках фиксированного окна. Документация указывает эту же цифру для каждого эндпоинта.
Как часто опрашивать статус задачи?
Каждые 3 секунды. Вебхуков нет, поэтому поллинг — документированный способ узнать о завершении задачи.
Сколько задач может рендериться одновременно?
Количество параллельных пакетов ограничено тарифом: Free — 1, Hobby — 2, Seller — 3, Brand — 4 и Studio — 6. При превышении лимита отправка возвращает 409.
Что делать при получении 429?
Считайте заголовок Retry-After, подождите указанное количество секунд и повторите запрос с экспоненциальной задержкой. Ставьте задачи в очередь, а не сбрасывайте их.
Эндпоинты и справочные материалы
Возможности
API виртуального try-on для одежды
REST API, примеряющий одежду на AI-манекены. Асинхронно, генерация за 1.5–4 минуты, 5 credits для 2K, 6 для 4K. Примеры для cURL, Node.js и Python.
ЧитатьВозможности
API примерки ювелирных изделий для колье, колец, браслетов и серег
Примерка ожерелий, колец, браслетов и серёг на AI-моделях через REST. 5 credits в 2K, встроенные манекены крупным планом, рендеринг с учётом отражений из документации Photta.
ЧитатьВозможности
API невидимого манекена (ghost mannequin) для фото товаров на невидимом манекене
AI-эндпоинт для эффекта невидимого манекена. Удаляет манекен с фото одежды с сохранением деталей внутренней части. 3D или раскладка, пакетная обработка, 4 credits в 2K.
ЧитатьСправочник
Первое изображение в Photta менее чем за 5 минут.
Зарегистрируйтесь, сгенерируйте API-ключ, выполните первый вызов cURL, опрашивайте статус до завершения, сохраните результат. 5 шагов с полным описанием.
ЧитатьСправочник
Аутентификация в Photta API
Как проходить аутентификацию в Photta API: заголовок Authorization, префикс ключа, где создаются ключи и как безопасно выполнить их ротацию.
ЧитатьСправочник
Тарифы Photta API
Сколько стоит каждый endpoint Photta API в credits при 2K и 4K, как устроены списания и возвраты, и какие эндпоинты бесплатны. Никаких цен в деньгах за изображение.
ЧитатьСправочник
Ошибки Photta API
Полный список типов ошибок Photta API с их статус-кодами, формат тела ошибки и сбои, которые имеет смысл повторять.
ЧитатьСправочник
Эндпоинты ресурсов Photta API
Получайте списки манекенов, поз, фонов, обуви и лейблов брендов, загружайте собственные и проверяйте баланс кредитов. Справочники, на которых строится каждая генерация.
Читать
Все показатели на этой странице взяты из документации API Photta · проверено
Протестируйте API за пять минут
Сгенерируйте API-ключ Photta, вставьте пример cURL выше, и вы получите первое изображение на модели быстрее, чем сварится кофе.
- 600 запросов/мин
- Retry-After: 30s
- async, polling