Краткий ответ
Не диагностируйте запрос только по коду состояния HTTP. Сначала сохраните полную ошибку, имя модели, базовый URL, token-группу и идентификатор запроса, затем определите, является ли проблема ошибкой конфигурации запроса или временным сбоем на стороне upstream:400,401,403, неподдерживаемые параметры, блокировки безопасности и несоответствия групп обычно требуют изменения запроса или конфигурации. Повторная отправка того же запроса не устранит проблему.429,503, некоторые ответы504иUpstream model timed outмогут быть вызваны нагрузкой на стороне upstream, доступностью ресурсов или длительным выполнением запросов. Проверьте журналы, затем используйте ограниченное число повторных попыток с экспоненциальной задержкой.- Если сбой возникает только у одной модели или группы, проверьте авторизованную резервную группу. Если одновременно возникают сбои у нескольких моделей, сначала проверьте API-ключ, базовый URL и сетевой маршрут.
Сохраните полную информацию об ошибке
На снимках экрана часто отсутствуют наиболее полезные поля. Перед устранением неполадок сохраните следующую информацию:Устранение неполадок по типу ошибки
429 может означать перегрузку вышестоящей системы, но также может указывать на проблему совместимости запроса, подробности которой отображаются только в полном сообщении об ошибке. Используйте тело ответа и журналы вызовов как окончательное подтверждение.Стандартные шаги устранения неполадок
Шаг 1: Воспроизведите проблему с минимальным запросом
Шаг 2: Проверьте эндпоинт, token и группу
api.apiyi.com. В консоли проверьте основную группу token, резервную группу и разрешённые модели. Для некоторых моделей требуется выделенная группа.Шаг 3: Определите, уместна ли повторная попытка
429, 503 и подтверждённых временных сбоев upstream-сервиса. При ошибках параметров, блокировках безопасности, недопустимых именах моделей и несоответствии групп измените запрос или конфигурацию, а не повторяйте запрос без изменений.Шаг 4: Проверьте тайм-аут и сетевой путь
api.apiyi.com или vip.apiyi.com вместо узла CDN api-cf.apiyi.com, для которого действует ограничение примерно в 100 секунд.Шаг 5: Проверьте журналы вызовов перед повторной отправкой
Минимальный тестовый запрос
Используйте следующий запрос, чтобы проверить эндпоинт, token и базовый вызов модели. ЗаменитеYOUR_MODEL на модель, доступную для вашего token, и не добавляйте необязательные поля, пока минимальный вызов не заработает.
Предотвращение повторяющихся ошибок
- Начните с минимального запроса, затем добавляйте
stop, tools, параметры управления рассуждением, изображения и другие необязательные поля по одному. - Ведите таблицу совместимости параметров для своих моделей вместо того, чтобы предполагать, что каждая модель поддерживает одни и те же поля.
- Не отправляйте сразу множество параллельных запросов после
429; используйте экспоненциальную задержку и контролируйте количество параллельных запросов для каждой модели. - Задавайте достаточный тайм-аут для запросов на генерацию изображений и рассуждение. Не сочетайте повторы SDK с собственными повторами на уровне бизнес-логики.
- Настройте резервную группу, протестированную с вашими фактическими рабочими параметрами.
Часто задаваемые вопросы
Всегда ли 429 означает, что число параллельных запросов слишком велико?
Всегда ли 429 означает, что число параллельных запросов слишком велико?
429 может быть вызвано числом параллельных запросов или перегрузкой вышестоящего сервиса, однако сообщение об ошибке также может скрывать проблему совместимости параметров. Прежде чем решать, уменьшить ли число параллельных запросов или изменить запрос, ознакомьтесь с полным текстом error.message.Нужно ли всегда создавать новый token после ошибки 401?
Нужно ли всегда создавать новый token после ошибки 401?
Invalid token наряду с ошибками 5xx или тайм-аутами, причиной также может быть маршрут вышестоящего сервиса.Можно ли повторить запрос сразу после тайм-аута?
Можно ли повторить запрос сразу после тайм-аута?
Взимается ли плата за неудачные запросы?
Взимается ли плата за неудачные запросы?
Всё ещё не удаётся решить проблему? Обратитесь в поддержку
Если после выполнения описанных выше действий проблема сохраняется, обратитесь в поддержку APIYI через WeCom или по электронной почте. Чтобы ускорить устранение неполадки, укажите следующую информацию:- Название модели, группу token и базовый URL
- Полное сообщение об ошибке, статус HTTP и ID запроса
- Время возникновения, включая часовой пояс
UTC+8 - Минимизированный пример запроса или тело запроса с удалёнными конфиденциальными данными
- Содержат ли журналы вызовов запись о списании средств