На этой странице
Частые ошибки
Ошибки, с которыми может столкнуться любой инструмент агентов при подключении к HiAPI, и способы их исправить.
В руководстве каждого инструмента перечислены только ошибки, характерные для него. Эти ошибки могут возникнуть в любом инструменте. Сначала проверьте код состояния или ключевое слово в тексте ошибки, затем найдите её в таблице ниже:
| Ошибка | Причина | Как исправить |
|---|---|---|
| 401 / invalid api key | Ключ неполный, содержит пробелы в начале или конце, либо вы скопировали замаскированное отображаемое значение | Перейдите на страницу API Keys, нажмите значок копирования и скопируйте полный API-ключ HiAPI заново |
| В ошибке упоминаются баланс, квота или лимит расходов | Баланс аккаунта слишком мал или лимит расходов этого ключа исчерпан | Пополните баланс в разделе Баланс аккаунта или поднимите лимит расходов этого ключа на странице API Keys |
| 403 | У этого ключа нет прав на модель | Проверьте группу и права ключа, см. Аутентификацию |
| 404 / model not available | В Base URL есть лишний или отсутствующий /v1, либо имя модели написано с ошибкой | Сверьте URL с разделом Base URL и протоколы; скопируйте имя модели из списка текстовых моделей |
| 400 does not support this endpoint | Выбранный в инструменте протокол не поддерживается этой моделью | Попробуйте другой протокол (например, Anthropic Messages для Claude) или переключитесь на другую модель |
| 400 stream must be true / бесконечная загрузка | Модель поддерживает только потоковый режим, а инструмент отправил обычный запрос | Включите потоковый режим в инструменте. Если эта ошибка возвращается кнопкой «Check» или «Test connection», не обращайте на неё внимания и ориентируйтесь на реальный чат |
| 429 | Слишком много запросов или слишком большая параллельность | Подождите и повторите, запускайте меньше задач одновременно; если в ошибке упоминается квота, следуйте строке «баланс, квота» выше |
| 500 / 502 / 503 | Сервис модели временно дал сбой | Подождите минуту-две и повторите; если ошибка повторяется, сначала попробуйте другую модель, затем свяжитесь с нами |
| Тайм-аут / прерванный ответ | Сеть или прокси оборвали долгоживущее соединение | Проверьте правила сети и прокси для api.hiapi.ai, затем повторите |
Перед повтором проверьте журнал запросов
Задача агента может быть уже выполнена на сервере, а оборвалось только соединение инструмента. Перед повтором проверьте Журнал запросов: выполнился ли этот запрос и сколько он стоил, чтобы не заплатить дважды за одну и ту же работу.
Всё равно не получается
Отправьте обращение через Связаться с поддержкой с информацией ниже — это поможет нам быстрее найти причину:
- время ошибки (с точностью до минуты)
- использованный инструмент и версия, например Claude Code 2.1.284
- имя модели и base URL
- исходный текст ошибки или скриншот
Перед скриншотом замаскируйте API-ключ и никогда не отправляйте ключ никому, включая поддержку.