07 · гайд
Коды ошибок
| Код | Что значит | Что делать |
|---|---|---|
| 400 | Неверные параметры: значение вне допустимых, лишнее поле, битый JSON, неизвестное имя модели (код model_not_found). В сообщении — конкретика (например, список допустимых seconds). | Исправить запрос по тексту ошибки и странице модели. |
| 401 | Ключ не передан, не существует или отключён. | Проверить ключ и формат Bearer sk-…; статус ключа виден в кабинете, раздел «API Ключи». |
| 403 | Аккаунт заблокирован либо не хватает токенов на балансе (код insufficient_user_quota). | Пополнить баланс в кабинете. |
| 404 | Задача или файл не найдены: неверный id при опросе статуса, либо результат истёк (файлы живут 14 дней). | Сверить id; истёкший результат не восстановить — генерируйте заново. |
| 429 | Перегрузка: рейт-лимит поставщика модели или потолок одновременных генераций изображений. | Повторить с бэкоффом. |
| 5xx | Сбой на нашей стороне или у поставщика модели (503 с кодом upstream_balance — временная недоступность поставщика). | Повторить позже. Для текста повтор безопасен; создание видео-задачи не повторяйте вслепую — сначала проверьте баланс и логи в кабинете. |
Автовозврат за провал
Если асинхронная задача (видео/музыка) завершилась ошибкой — списанные токены возвращает на баланс фоновый процесс, обычно в течение часа. Отдельной строки в логах кабинета возврат не создаёт — он виден по изменению баланса. Если считаете, что возврат не пришёл, — напишите в поддержку, вернём вручную. Возврат денег на карту не предусмотрен — баланс расходуется только на генерации.