🎉 Бесплатные генерации при первой покупке каждого пакета — до 20 Lite-видео + 20 Lite-изображений + 10 Medium-видео + 10 Pro-изображений + 2 Pro-видео.

Начать работу
DreamUtopia
ru

Ошибки и ограничения

Каждая ошибка использует один конверт. Код стабилен; сообщение — это англоязычный запасной вариант, который вы можете показать пользователю.

ответ
{
  "error": {
    "code": "insufficient_credits",
    "message": "You need more credits to generate."
  }
}

Статусы

  • 400

    Типичный код
    invalid_request, prompt_too_long, invalid_reference_image
    Что делать
    Исправьте запрос; не повторяйте попытку без изменений
  • 401

    Типичный код
    unauthorized
    Что делать
    Проверь ключ; не повторяй попытки в цикле
  • 402

    Типичный код
    insufficient_credits
    Что делать
    Пополните кредиты; не повторяйте попытку
  • 403

    Типичный код
    unauthorized
    Что делать
    Создание ключа без оплаты или запрос аудио без премиум-подписки
  • 404

    Типичный код
    not_found
    Что делать
    Неизвестное задание или оно принадлежит не этому аккаунту
  • 409

    Типичный код
    invalid_request
    Что делать
    Idempotency-Key конфликт; используйте новый ключ
  • 413 / 415

    Типичный код
    invalid_request / unsupported_image_type
    Что делать
    Загрузите JPEG, PNG или WebP меньшего размера
  • 429

    Типичный код
    rate_limited
    Что делать
    Дождитесь Retry-After
  • 500 / 503

    Типичный код
    internal
    Что делать
    Повторить с задержкой

Неудачная генерация — это ответ задания с кодом 200, содержащий status: "failed" и объект error с кодом internal. Завершённое задание окончательно: не отправляйте его повторно.

Политика повторных попыток

  • Повторяйте только ответы HTTP 429, timeout и internal.
  • Никогда не повторяйте попытку при insufficient_credits и никогда не отправляйте повторно задание, которое уже завершилось со статусом failed.
  • Используйте Idempotency-Key при создании, чтобы повторная попытка не привела к двойному списанию.
  • Экспоненциально увеличивайте задержку с джиттером, начиная примерно с одной секунды.

Лимиты запросов

Лимиты действуют для каждого ключа в фиксированных одноминутных окнах, если не указано иное. Значения по умолчанию:

  • 60 запросов/минуту в целом.
  • 10 генераций в минуту.
  • 5 загрузок/минуту.
  • 120 запросов GET /v1/models в минуту на IP-адрес клиента (маршрут публичный).
  • 5 созданий API-ключей в час на аккаунт.

429 содержит X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset и Retry-After.

Доступность

Если /v1 временно недоступен, каждый маршрут отвечает 503 с кодом internal. Повторите попытку позже с экспоненциальной задержкой.

© 2026 DreamUtopia. Все права защищены.