Skip to main content

Краткий ответ

При устранении неполадок API-вызова сначала зафиксируйте название модели, эндпоинт и время вызова. Затем проверьте заголовки HTTP-ответа на наличие x-request-id или request-id. Если эндпоинт возвращает ошибочный ответ, также проверьте тело JSON на наличие таких идентификаторов, как request_id, и используйте поле, которое можно найти в журналах APIYI. Эндпоинты видео Wan и HappyHorse также возвращают request_id в теле ответа. Значение task_id в том же ответе используется для запроса состояния задачи видео и не совпадает с идентификатором запроса. Значение id или task_id, возвращаемое асинхронными эндпоинтами, такими как Seedance и Veo, также является идентификатором задачи видео.
На странице журналов APIYI можно выполнять поиск идентификаторов, отображаемых в фильтре «Идентификатор запроса / Идентификатор запроса вышестоящего сервиса / Идентификатор завершения». Откройте сведения о журнале в консоли и выполните поиск по идентификатору, предоставленному пользователем.

Начните с этих трёх шагов

1

Шаг 1: Подтвердите модель и эндпоинт

Зафиксируйте полное имя модели и фактический URL. Текстовые модели обычно используют /v1/chat/completions, модели для создания эмбеддингов — /v1/embeddings, модели для генерации изображений могут использовать /v1/images/generations, а модели для генерации видео — /v1/videos или асинхронный эндпоинт, специфичный для модели.
2

Шаг 2: Зафиксируйте время вызова

Зафиксируйте время отправки запроса и укажите часовой пояс, например 2026-08-25 14:32 (UTC+8). Если запрос был отправлен повторно, зафиксируйте приблизительное время каждой повторной попытки.
3

Шаг 3: Сохраните ответ и сведения в журнале

Сохраните код состояния HTTP, все заголовки ответа, всё тело ответа и исключение клиента. Затем откройте страницу «Журналы» в APIYI и выполните поиск по идентификатору запроса, идентификатору запроса upstream или идентификатору завершения.

Где найти идентификатор запроса для каждого типа API

Имена HTTP-заголовков нечувствительны к регистру, но разделители в именах полей имеют значение: x-request-id, request-id и request_id — это разные варианты написания. Проверяйте как заголовки ответа, так и тела ошибок, вместо того чтобы искать только одно имя поля.

Просмотр в коде

Python

cURL

Используйте -i, чтобы вывести как заголовки ответа, так и тело ответа. Ищите x-request-id или request-id в заголовках:
Для вызовов видео Wan или HappyHorse также сохраните два поля тела ответа:

Поиск в журналах консоли

1

Откройте журналы вызовов

Войдите в консоль APIYI, откройте раздел «Журналы» и просмотрите сведения о вызове, который требуется исследовать.
2

Введите доступный идентификатор

Вставьте идентификатор в фильтр «ID запроса / ID запроса вышестоящего сервиса / ID завершения». Предпочтительно использовать ID запроса из заголовков ответа APIYI; если он недоступен, попробуйте ID запроса вышестоящего сервиса или ID завершения.
3

Сравните сведения

Сравните модель, время вызова, эндпоинт, канал, статус HTTP, код ошибки и запись тарификации, чтобы определить, достиг ли запрос APIYI, достиг ли он вышестоящего провайдера и следует ли повторить его после изменения запроса.
Если пользователю известно только примерное время сбоя, поиск всё равно можно сузить по модели, эндпоинту и времени. ID запроса обычно позволяет гораздо быстрее найти отдельный вызов.

Почему может отсутствовать идентификатор запроса?

Если запрос завершается с ошибкой до получения HTTP-ответа — например, из-за разрешения DNS-имени, установки TCP/TLS-соединения, отклонения локальным прокси или тайм-аута соединения на стороне клиента, — у APIYI нет возможности вернуть заголовки ответа. В этом случае идентификатор запроса недоступен клиенту. Вместо этого предоставьте следующие данные:
  • Исходное исключение клиента и полную трассировку стека;
  • Время запроса и часовой пояс;
  • Модель и эндпоинт;
  • HTTP-клиент, прокси или сетевое окружение;
  • Идентификатор запроса из успешного или повторного запроса, если он доступен.
Не отправляйте полный API-ключ в материалах для устранения неполадок. Замаскируйте среднюю часть ключа и не раскрывайте персональные данные или тело запроса, содержащее полный текст рабочей информации или изображения.

Что предоставить в службу поддержки

  • ID запроса;
  • ID запроса вышестоящего сервиса или ID выполнения, если они отображаются в журналах;
  • Название модели и эндпоинт;
  • Время вызова с указанием часового пояса;
  • Статус HTTP, полное тело ответа и исключение клиента;
  • Запрос с удалёнными конфиденциальными данными, а также код ошибки и статус тарификации, отображаемые в журналах консоли.

Связанная документация

Как устранить ошибки моделей?

Устранение проблем с параметрами, группами, тайм-аутами и ошибками моделей

Как просмотреть журналы вызовов?

Просмотр вызовов API, ошибок и сведений о тарификации в консоли

API для запросов к журналам

Запрос журналов вызовов по времени, модели или request_id

Рекомендации по работе с API изображений

Устранение проблем с тайм-аутами изображений, разрывами соединения, тарификацией и идентификаторами запросов