Руководство по Baiyun API: распространённые ошибки и 429
Методы устранения кодов ошибок, аутентификации, ограничения скорости, временных блокировок, интерфейсов и вопросов с оплатой. Включает полные этапы инспекции, практическую проверку и устранение ошибок.
Распространённые ошибки с 429
При обнаружении ошибок сначала проверьте статус HTTP и вернувшуюся версию error.message、error.code и номер запроса. Один и тот же статус может происходить с разных стадий, и корень не может быть подтвержден только цифрами.
Общее состояние
| Статус | Возможные причины | Предложение |
|---|---|---|
| 400 | Поля запросов, форматы или функции недоступны | Ознакомьтесь с текстовыми примерами на этом сайте и удалите инструменты, файлы и медиаполя, автоматически добавленные клиентом |
| 401 | Ключи отсутствуют, недействительны или некорректны | Проверьте формат Bearer и ключ сайта; для вызова модели не нужен пароль для входа |
| 403 | Разрешения, отказы по правилам использования или временная приостановка учетных данных | Прочитайте конкретные инструкции и прекратите повторное размещение запрещённого контента; Временные локдауны ждут восстановления |
| 413 | Просить слишком многого | Сократьте историю переписки и текст; текущий лимит тела запроса составляет 1 MiB |
| 429 | Параллельность, частота или ограничения вверх по течению | Подождите сейчас, судите по конкретному содержанию ошибки и не пытайтесь бесконечно |
| 500 / 502 / 503 | Сервисы или сервисы на уровне направления временно недоступны, и полные ответы пока не получены | Сохраняйте номер и время запроса, с ограниченным лимитом повторов позже |
Бизнес-ошибки, такие как недостаток баланса, недоступные модели или ненастраиваемые цены, также следует читать и возвращать в основной текст; нельзя просто смотреть статусные коды или всплывающие окна фронтенда.
429 Дело не обязательно в том, что вы «слишком много просите»
429 указывает, что определённый уровень ограничивает запрос. В настоящее время каждый удостоверительный документ может быть обработан не более чем одновременно 2 запроса, предел частоты вызова модели равен 60 ударов в минуту； Upstream также имеет свои ограничения по ресурсам и использованию.
concurrency_limit: Дождитесь завершения существующего запроса, прежде чем отправлять следующий. Запросы потоков продолжают совмещаться до их окончания.- Регулярный предел частоты или верхний 429: уважение
Retry-After(Если доступно), используйте ограниченное количество повторных попыток с постепенно увеличенными периодами ожидания, чтобы избежать немедленных повторных запросов. - Страница напрямую показывает HTTP ERROR 429: Запросы на страницы браузера также могут быть ограничены; Подождите немного перед обновлением; если он продолжается, сохраняйте время и путь возникновения для администратора.
Если обычная проблема с текстом неправильно оценена, можно предоставить номер запроса и необходимые нечувствительные заметки для проверки; Не отправляйте доступные ключи, пароли или полностью конфиденциальные оригинальные тексты.
403 Временная герметизация с ваучерами
content_policy_violation Это указывает на то, что этот запрос соответствовал ограничениям сайта и был отклонён до отправки в апстрим.
credential_temporarily_blocked Возвращение 403, и предоставить Retry-After Подсказка ожидания: после того как один и тот же удостоверитель несколько раз срабатывает правило в течение 30 минут, поставьте паузу на 30 минут. Пожалуйста, прекратите соответствующий контент и дождитесь восстановления; не продолжайте попытки, меняя ключ. Это отличается от 429 параллелизма или ограничения частоты.
Вопросы адреса интерфейса и моделей
Базовый URL должен быть https://api.baiyun.si/v1, полный адрес чата — /v1/chat/completions, Ответы адресованы: /v1/responses。 Проверьте дубликаты /v1/v1, и выбрал ли клиент протоколы, не открытые для этого сайта.
Название модели должно быть связано сModel Squareи текущий ключ /v1/models Return последовательно; не используйте псевдонимы на стороне клиента для замены фактического имени вызова.
Вопросы стриминга и стоимости
Чат SSE должен читать [DONE]； Ответы SSE должны читать полный конец события. Некоторое сообщение после отключения сети нельзя считать полностью успешным ответом.
Параметры входа и выхода не гарантируют жёсткого ограничения стоимости. Обычные запросы, сбои после перехода в upstream или отмены клиентов должны быть проверены по фактическим записям потребления; Только запросы, отклонённые локально и не выходящие вверх по потоку, не будут взиматься платой за этот модельный вызов.
Что предоставляется во время инспекции?
- Время и часовой пояс.
- Номер запроса, название модели, путь интерфейса и статус HTTP.
- Сообщения об ошибке после удаления ключей и чувствительного содержимого.
- По вопросам оплаты указывайте номер заказа и статус, но не указывайте ключ платежного продавца.
Станция продолжает постепенно совершенствоваться и ещё не установила круглосуточную ручную работу или фиксированные сроки обработки.
Контрольный список перед практическим применением
- Подготовьте свой собственный аккаунт и ключи доступа, и не используйте общие учетные данные других.
- Записывает клиентские версии, системы и модели для удобства воспроизведения при устранении неполадок.
- Сохраните оригинальную конфигурацию или скриншот, спрячьте ключи, коды подтверждения и приватный контент.
- Убедитесь, что тестирование может потреблять небольшое количество DK, начиная с одного предложения и одного запроса.
- Ознакомьтесь с текущей моделью площади и страницу статуса, прежде чем решать, включать ли новые функции.
Детальное исследование: сузить круг проблемы по порядку
Сначала убедитесь, что счет завершён, ключ действительн, а баланс DK достаточен, затем проверьте протокол, адрес и модель. Сделайте минимальный текстовый запрос с помощью той же клавиши; Только после успеха он восстанавливает вложения, инструменты или автоматически перепробует каждый элемент. После сохранения конфигурации клиента заново откройте сессию, чтобы избежать использования предыдущего поставщика в старой сессии.
Как подтвердить, что этот раздел изучен
Не стоит просто отметить запрос «Конфигурация успешно сохранена». Вы должны чётко указывать текущий базовый URL, использование ключа, выбранную модель и протокол запроса, а также проверять результаты работы на соответствующей консоли. Клиентский туториал использует один реальный ответ в виде обычного текста и соответствующие логи в качестве начального стандарта завершения; Обучающие материалы по аккаунтам основаны на обширной информации о безопасности; В учебном материале по биллингу используется соответствие между принципалом, комиссией за каналы и DK в качестве стандарта.
Если возникает ошибка, запишите время появления, статус HTTP, содержимое анонимизированной ошибки и фактический ожидаемый результат. Не делайте скриншоты полного ключа страницы и не давайте пароль или код подтверждения другим. Для 401 сначала следует решить аутентификацию; для 400 — сначала решить параметры; для 429 — прекратить интенсивные повторные попытки; для 404 — проверить пути запросов и верификация по верхнему потоку; перезарядка не может устранить все ошибки.
Небольшое задание, подходящее для практики
Выполните минимальные шаги в этом разделе в своей тестовой среде, записывая в тексте «как вы изначально настроили, какой элемент изменили и какие результаты увидели». Не воспринимайте производственные данные, реальные платежи или невосстанавливые команды как упражнения. Если вы столкнётесь с функциями, выходящими за рамки этого раздела, сначала ознакомьтесь с соответствующим учебником по протоколу, прежде чем рассматривать возможность добавления новых функций; Изменение только одной конфигурации за раз позволяет легко определить, какой шаг приводит к ошибкам.
Следующий шаг — граница версии
Вернуться к полной карте обучения · Оптимизированная конфигурация сайта API · Статус сайта в реальном времени。
Обучающий материал был составлен 9 октября 2026 года. Конкретный интерфейс и возможности могут различаться в зависимости от клиента и восходящих версий; Инструкции по конфигурации не означают, что все клиентские версии прошли тест. Для оплаты баланса, входа в QQ / Alipay и открытых каналов, пожалуйста, обратитесь к самой странице страницы; Интерфейсы сжатия: Ранее каналы 404 и RAW были недоступны, так что не предполагайте, что конфигурационные файлы можно автоматически удалять.