Краткий ответ
При устранении неполадок 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
Просмотр в коде
Python
cURL
Используйте-i, чтобы вывести как заголовки ответа, так и тело ответа. Ищите x-request-id или request-id в заголовках:
Поиск в журналах консоли
1
Откройте журналы вызовов
Войдите в консоль APIYI, откройте раздел «Журналы» и просмотрите сведения о вызове, который требуется исследовать.
2
Введите доступный идентификатор
Вставьте идентификатор в фильтр «ID запроса / ID запроса вышестоящего сервиса / ID завершения». Предпочтительно использовать ID запроса из заголовков ответа APIYI; если он недоступен, попробуйте ID запроса вышестоящего сервиса или ID завершения.
3
Сравните сведения
Сравните модель, время вызова, эндпоинт, канал, статус HTTP, код ошибки и запись тарификации, чтобы определить, достиг ли запрос APIYI, достиг ли он вышестоящего провайдера и следует ли повторить его после изменения запроса.
Почему может отсутствовать идентификатор запроса?
Если запрос завершается с ошибкой до получения HTTP-ответа — например, из-за разрешения DNS-имени, установки TCP/TLS-соединения, отклонения локальным прокси или тайм-аута соединения на стороне клиента, — у APIYI нет возможности вернуть заголовки ответа. В этом случае идентификатор запроса недоступен клиенту. Вместо этого предоставьте следующие данные:- Исходное исключение клиента и полную трассировку стека;
- Время запроса и часовой пояс;
- Модель и эндпоинт;
- HTTP-клиент, прокси или сетевое окружение;
- Идентификатор запроса из успешного или повторного запроса, если он доступен.
Что предоставить в службу поддержки
- ID запроса;
- ID запроса вышестоящего сервиса или ID выполнения, если они отображаются в журналах;
- Название модели и эндпоинт;
- Время вызова с указанием часового пояса;
- Статус HTTP, полное тело ответа и исключение клиента;
- Запрос с удалёнными конфиденциальными данными, а также код ошибки и статус тарификации, отображаемые в журналах консоли.
Связанная документация
Как устранить ошибки моделей?
Устранение проблем с параметрами, группами, тайм-аутами и ошибками моделей
Как просмотреть журналы вызовов?
Просмотр вызовов API, ошибок и сведений о тарификации в консоли
API для запросов к журналам
Запрос журналов вызовов по времени, модели или request_id
Рекомендации по работе с API изображений
Устранение проблем с тайм-аутами изображений, разрывами соединения, тарификацией и идентификаторами запросов