Устранение неполадок
Указатель по симптомам — найдите наблюдаемую проблему и перейдите к её причине.
Проверьте доступ перед повторной попыткой
- Проверьте, активно ли нужное право доступа, и обратите внимание на срок его действия.
- Убедитесь, что ключ использует нужную группу. Тарифы Claude с ограниченным сроком действия используют Claude Unlimited; доступ к Codex предоставляется отдельно.
- Получите список моделей с тем же ключом, выберите ID из ответа и отправьте один небольшой запрос.
Используйте Модели и группы ключей или контрольный список настройки агента если вы не уверены, на каком шаге произошёл сбой.
Ничего не работает
Проверьте базовую работоспособность, прежде чем разбираться с остальными проблемами:
curl -s -o /dev/null -w "%{http_code}\n" https://aiprimetech.io/v1/models \
-H "Authorization: Bearer $CLAUDEAPIKEY"После успешного получения списка моделей проверьте, есть ли в нём выбранная модель, и отправьте один небольшой запрос на генерацию. Генерация всё ещё может завершиться ошибкой из-за доступности модели, прав доступа, лимитов или конфигурации клиента.
По симптомам
| Симптом | Вероятная причина | Решение |
|---|---|---|
404 при каждом вызове | В базовом URL неправильно настроена /v1 обработка | Базовые URL |
401 с только что созданным ключом | Неправильный заголовок для этого формата или пробел в конце | Аутентификация |
402 | Нет средств или срок действия тарифа истёк | Пополнить баланс · Тарифы |
400 max_tokens | Messages требует max_tokens; Chat Completions не требует | Messages |
model_not_found | Неверный ID, неверная группа ключа или модель недоступна для этого ключа | Модели и группы ключей |
| Потоковое соединение устанавливается, но данные не поступают | Разбор структуры событий другого формата | Потоковая передача |
| Ответ обрывается на середине предложения | stop_reason: max_tokens | Увеличьте max_tokens |
| Работает в curl, но не работает в SDK | SDK добавляет собственный путь к вашему базовому URL | Базовые URL |
| Использование не отображается в панели управления | Запросы отправляются с другим ключом или на другой эндпоинт | Проверьте ANTHROPIC_API_KEY не задан — Claude Code |
Частые 429 | Слишком много параллельных операций агента | Ограничения частоты запросов |
| Счёт выше ожидаемого | Рост контекста с каждым шагом | Управление контекстом |
Как читать тело ответа с ошибкой
Код статуса указывает на категорию проблемы; поля error.type и error.message показывают, какая именно проблема возникла. Записывайте в журнал всё тело ответа — 400 на "missing max_tokens" и 400 на "invalid role" требуют совершенно разных способов устранения.
Проблема всё ещё не решена
Свяжитесь с support@aiprimetech.io с указанием эндпоинта, ID модели, кода статуса и тела ответа с ошибкой. Никогда не включайте свой API-ключ — если вы уже где-то его опубликовали, сначала отзовите его.