Каталог Ошибок И Решений

Проблема: Тело запроса не является корректным JSON.

Решение: Проверьте синтаксис JSON: кавычки, запятые, скобки и Content-Type application/json.

Проблема: Ожидается JSON-объект с полями запроса.

Решение: Передайте объект с model, prompt и дополнительными параметрами.

Проблема: API ожидает объект JSON, но пришёл другой тип данных.

Решение: Отправьте body в виде JSON-объекта.

Проблема: Указанная модель не поддерживается для текущего endpoint-а.

Решение: Для NanoBanana используйте: nanobanano-2, nanobanano-2-2k, nanobanano-2-4k.

Проблема: Параметр prompt отсутствует или пустой.

Решение: Передайте непустую строку в поле prompt.

Проблема: Поле urls должно быть массивом строк.

Решение: Передайте urls в формате ["https://...", "data:image/png;base64,..."].

Проблема: Передано неподдерживаемое значение aspectRatio.

Решение: Используйте один из вариантов: auto, 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 5:4, 4:5, 21:9.

Проблема: Поле webHook должно быть строкой.

Решение: Передайте URL callback в виде строки или '-1' для polling-сценария.

Проблема: Поле shutProgress должно быть boolean.

Решение: Используйте true или false.

Проблема: Поле id отсутствует или пустое в запросе результата.

Решение: Передайте id, полученный из generate-запроса.

Проблема: Запрос выполнен без заголовка API-ключа.

Решение: Передайте ключ в Authorization: Bearer <APISTOR_API_KEY> или x-api-key.

Проблема: Ключ не найден, отозван или указан с ошибкой.

Решение: Проверьте значение ключа или перевыпустите ключ в личном кабинете.

Проблема: Баланс кабинета меньше стоимости текущего запроса.

Решение: Пополните баланс или используйте более дешёвый тариф/модель.

Проблема: На сервере не задан ключ доступа к Grsai.

Решение: Заполните переменную окружения GRSAI_API_KEY и перезапустите приложение.

Проблема: Провайдер отклонил запрос из-за недействительных credentials.

Решение: Проверьте актуальность upstream API-ключа и права доступа у Grsai.

Проблема: Провайдер временно ограничил частоту запросов.

Решение: Добавьте retry с backoff и/или уменьшите burst нагрузку.

Проблема: Провайдер считает запрос некорректным.

Решение: Проверьте model/prompt/aspectRatio и обязательные поля в body.

Проблема: Переданный id задачи отсутствует у провайдера.

Решение: Проверьте id и что он относится к правильному окружению/проекту.

Проблема: Промпт или входные данные заблокированы модерацией провайдера.

Решение: Смягчите формулировку prompt и уберите запрещённый контент.

Проблема: Результат генерации отклонён модерацией провайдера.

Решение: Переформулируйте prompt и повторите запрос с безопасным контекстом.

Проблема: У провайдера возникла внутренняя ошибка обработки.

Решение: Повторите запрос позже. Для критичных кейсов включите retry-политику.

Проблема: Провайдер не ответил в пределах таймаута сервера.

Решение: Увеличьте GRSAI_TIMEOUT_MS или используйте webhook/polling вместо ожидания.

Проблема: Не удалось соединиться с провайдером.

Решение: Проверьте сеть, DNS, доступность GRSAI_BASE_URL.

Проблема: Провайдер вернул неожиданный статус или ошибку.

Решение: Проверьте details в ответе и upstream логи; повторите запрос при необходимости.