Перейти к основному содержимому

Исправление ошибок

Определите причину по симптому и HTTP-статусу, проверьте минимальное исправление и затем восстановите запрос по шагам.

401 Нет аутентификации​

  • Симптом: Обычно запрос возвращает 401 Нет аутентификации, а клиент может показать только «запрос не выполнен».
  • Причина: Key отсутствует, неактивен, скопирован не полностью или отправлен с неверным заголовком.
  • Проверки:
    1. Запишите полный HTTP-статус, путь и время.
    2. Скопируйте Key заново и проверьте пробелы, срок действия и активность.
    3. Сверьте URL, модель и заголовок авторизации с руководством и проверьте минимальным curl.
  • Исправление: Скопируйте Key заново, удалите пробелы и проверьте Bearer, x-api-key либо x-goog-api-key.
  • Проверка: После исправления сначала отправьте короткий текстовый запрос. Расширенные параметры возвращайте только после обычного JSON-ответа.

403 Доступ запрещён​

  • Симптом: Обычно запрос возвращает 403 Доступ запрещён, а клиент может показать только «запрос не выполнен».
  • Причина: Текущий Key, состояние учётной записи или доступ к модели не разрешают запрос.
  • Проверки:
    1. Запишите полный HTTP-статус, путь и время.
    2. Скопируйте Key заново и проверьте пробелы, срок действия и активность.
    3. Сверьте URL, модель и заголовок авторизации с руководством и проверьте минимальным curl.
  • Исправление: Убедитесь, что Key активен, и выберите доступную модель на странице моделей и цен.
  • Проверка: После исправления сначала отправьте короткий текстовый запрос. Расширенные параметры возвращайте только после обычного JSON-ответа.

404 Не найдено​

  • Симптом: Обычно запрос возвращает 404 Не найдено, а клиент может показать только «запрос не выполнен».
  • Причина: Base URL, путь протокола или HTTP-метод не совпадают; клиент мог дважды добавить /v1.
  • Проверки:
    1. Запишите полный HTTP-статус, путь и время.
    2. Скопируйте Key заново и проверьте пробелы, срок действия и активность.
    3. Сверьте URL, модель и заголовок авторизации с руководством и проверьте минимальным curl.
  • Исправление: Сверьте полный метод и путь с руководством и укажите только требуемый уровень Base URL.
  • Проверка: После исправления сначала отправьте короткий текстовый запрос. Расширенные параметры возвращайте только после обычного JSON-ответа.

429 Слишком много запросов​

  • Симптом: Обычно запрос возвращает 429 Слишком много запросов, а клиент может показать только «запрос не выполнен».
  • Причина: Запросы идут слишком часто либо текущего доступного остатка недостаточно.
  • Проверки:
    1. Запишите полный HTTP-статус, путь и время.
    2. Скопируйте Key заново и проверьте пробелы, срок действия и активность.
    3. Сверьте URL, модель и заголовок авторизации с руководством и проверьте минимальным curl.
  • Исправление: Уменьшите параллельность, повторяйте с растущей задержкой и проверьте состояние учётной записи на портале.
  • Проверка: После исправления сначала отправьте короткий текстовый запрос. Расширенные параметры возвращайте только после обычного JSON-ответа.

5xx Ошибка сервиса​

  • Симптом: Обычно запрос возвращает 5xx Ошибка сервиса, а клиент может показать только «запрос не выполнен».
  • Причина: Внешний сервис или шлюз временно не может выполнить запрос.
  • Проверки:
    1. Запишите полный HTTP-статус, путь и время.
    2. Скопируйте Key заново и проверьте пробелы, срок действия и активность.
    3. Сверьте URL, модель и заголовок авторизации с руководством и проверьте минимальным curl.
  • Исправление: Сохраните время и статус и повторите позже. При постоянной ошибке выполните минимальный curl для проверки клиента.
  • Проверка: После исправления сначала отправьте короткий текстовый запрос. Расширенные параметры возвращайте только после обычного JSON-ответа.

Обрыв сети​

  • Симптом: Обычно запрос возвращает Обрыв сети, а клиент может показать только «запрос не выполнен».
  • Причина: Локальная сеть, прокси или длительное соединение закрылись до завершения ответа.
  • Проверки:
    1. Запишите полный HTTP-статус, путь и время.
    2. Скопируйте Key заново и проверьте пробелы, срок действия и активность.
    3. Сверьте URL, модель и заголовок авторизации с руководством и проверьте минимальным curl.
  • Исправление: Проверьте доступ к домену, переподключайте потоки с задержкой и не повторяйте автоматически неидемпотентные операции.
  • Проверка: После исправления сначала отправьте короткий текстовый запрос. Расширенные параметры возвращайте только после обычного JSON-ответа.

Рекомендуемый порядок проверки​

  1. Сначала сохраните полную ошибку: HTTP-статус, путь, клиент и время.
  2. Повторите запрос минимальным curl из быстрого старта, чтобы отделить Key, модель, URL и клиент.
  3. Меняйте только одну переменную за раз. Сначала проверьте короткий текстовый запрос, затем возвращайте streaming, tools или медиапараметры.

Если проблема остаётся​

Сохраните время, протокол, HTTP-метод, путь, статус и очищенный фрагмент ответа. Не прикладывайте полный Key.

Диагностика видеоошибок​

Найдите этап: до отправки,разбор PopGo,принятие,опрос,загрузка. Сохраните конкретную ошибку;500 или отсутствие логов не определяют виновника.

ЭтапДействие
first-frame requires exactly one / first-last-frame requires bothВыберите режим,одну картинку или два разных слота; проверьте входные связи и число
reference-audio requires at least one / audio not supportedПроверьте поддержку и разрешённый режим,добавьте аудио;generate_audio не даёт права на референс
unsupported protocol: data / invalid sourceДля URL-only используйте разрешённый публичный адрес;метка Local не публикует файл
Долго0% / completed без скачиванияОпросите прежний id,дайте подготовить содержимое,не создавайте заново
Успех без использованияПроверьте поля,доступ и файл;HTTP200 недостаточно

400 обычно требует исправления входа;500 может быть в разборе/промежуточном слое;503 часто означает временную нехватку мощности. Сначала изучите обезличенные детали. См.Диагностика задач.