API v1

Ошибки и лимиты

Формат ошибки

При ошибке API возвращает код HTTP 4xx или 5xx и JSON с машинным кодом и описанием:

json

{
  "error": {
    "code": "quota_exceeded",
    "message": "Лимит генераций по тарифу исчерпан до 2026-10-15.",
    "request_id": "req_7Hc2mXp4Ld"
  }
}

Передавайте request_id в поддержку — по нему мы найдём запрос в журналах.

Коды

HTTP	Код	Что делать
400	`invalid_request`	Проверьте поля запроса; подробности — в `message`.
401	`unauthorized`	Ключ не передан, отозван или неверен.
403	`scope_missing`	У ключа нет нужной области доступа.
404	`not_found`	Ресурс не существует или принадлежит другому пространству.
409	`idempotency_conflict`	Тот же `Idempotency-Key` с другим телом запроса.
413	`file_too_large`	Файл больше 20 МБ.
422	`unsupported_image`	Формат или размер изображения не подходит.
402	`quota_exceeded`	Лимит генераций исчерпан — повысьте тариф или дождитесь обновления.
429	`rate_limited`	Слишком много запросов; повторите после `Retry-After`.
5xx	`internal_error`	Повторите запрос с тем же `Idempotency-Key`.

Лимиты частоты

Тариф	Запросов в минуту	Одновременных генераций
Команда	120	5
Бизнес	600	по договору

Текущие значения приходят в заголовках каждого ответа: RateLimit-Limit, RateLimit-Remaining и RateLimit-Reset.