---
title: "Ошибки API и диагностика"
description: "Проверка ключа, URL, модели, параметров, соединения и журнала."
---

<aside className="docs-publication" data-pagefind-ignore>Документацию поддерживает <a href="https://1zheai.com/ru/editorial/#publisher">1ZheAI</a>. <a href="https://1zheai.com/ru/editorial/">Источники, коммерческие интересы и исправления</a>. Об ошибке сообщите на <a href="mailto:support@1zheai.com">support@1zheai.com</a>, указав URL и проверяемое подтверждение, без ключей и данных входа.</aside>

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

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

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

При потоке ошибка может возникнуть после текста. Сначала проверьте [журнал](/ru/docs/usage-logs/), затем используйте [ограниченные повторы](/ru/docs/retries/).

Поддержке нужны время, часовой пояс, версия клиента, модель, конечный 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 (если есть):
Текст ошибки без секретов:
Воспроизводится ли минимальным запросом:
Используется ли прокси / затронута ли одна модель:
```


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

- [Источник 1](https://platform.claude.com/docs/en/api/errors)