Перейти к содержимому
Документация 1ZheAI
中文

Ошибки API и диагностика

Проверка ключа, URL, модели, параметров, соединения и журнала.

Сначала воспроизведите проблему минимальным запросом из примеров, затем добавляйте параметры. Это отделяет неправильную конфигурацию клиента от ошибки модели.

ОшибкаЧто проверить
400Обязательные поля, формат протокола и неподдерживаемые параметры; уберите необязательное
401Значение ключа, пробелы, переменные нового процесса и нужный заголовок
403Права, состояние ключа и ограничения доступа
404Полный model ID, базовый URL, дублирование /v1 и правильную конечную точку
429Баланс, ограничения и причину ответа; не повторяйте бесконечно
5xx / соединениеДоступность адреса, сеть, время ожидания и состояние поставщика

Для Claude Code проверьте /status, переменные окружения и настройки settings.json. При конфликте ключей оставьте один поддерживаемый способ. Строгий поставщик может отвергать экспериментальные beta-поля; пример ниже показывает соответствующую настройку из инструкции Claude Code. Отключайте её осознанно и проверяйте нужные возможности.

При потоке ошибка может возникнуть после текста. Сначала проверьте журнал, затем используйте ограниченные повторы.

Поддержке нужны время, часовой пояс, версия клиента, модель, конечный URL без секрета, HTTP-код и обезличенная ошибка. Полный ключ, сессия и приватные сообщения не нужны.

Примеры запросов и конфигурации

Раздел «Примеры запросов и конфигурации»

Используйте пример для выбранного протокола и версии клиента. Замените учебные ключи и идентификаторы моделей своими. Команды выполняются на вашем компьютере или сервере.

bash
curl -i https://1zheai.com/v1/messages \
  -H "x-api-key: sk-YOUR_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-5-5","max_tokens":16,"messages":[{"role":"user","content":"ping"}]}'
json
{"error":{"message":"Invalid token (request id: 202610150244355244812608268d9d6T1pY7T84)","type":"authentication_error"},"type":"error"}
json
{"error":{"type":"billing_error","message":"Insufficient user quota, remaining quota: ＄0.000000 (request id: 202610150244418753787808268d9d67YNhvwXd)"},"type":"error"}
json
{"error":{"message":"This token has no access to model claude-sonnet-4-6 (request id: 202610150244377127013108268d9d6yCiFOxJA)","type":"permission_error"},"type":"error"}
json
{"error":{"message":"Your IP address is not on this token's allowlist (request id: 202610150244409011371208268d9d63tJvd5GD)","type":"permission_error"},"type":"error"}
json
{"error":{"type":"invalid_request_error","message":"messages: Unexpected role \"robot\". Allowed roles are \"user\", \"assistant\" or \"system\" (request id: 202610150245008404167198268d9d6sajV9TX3)"},"type":"error"}
json
{"error":{"message":"Invalid URL (POST /v1/nonexistent)","type":"invalid_request_error","param":"","code":""}}
bash
export CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1
text
Время и часовой пояс:
Клиент и версия:
HTTP-метод и полный путь:
ID модели:
HTTP-статус:
Request ID (если есть):
Текст ошибки без секретов:
Воспроизводится ли минимальным запросом:
Используется ли прокси / затронута ли одна модель:

Внешние источники

Раздел «Внешние источники»