Документация

Всё, что нужно для подключения ваших инструментов: инструкции для популярных агентов и редакторов, справочник API и ответы на частые вопросы.

Быстрый старт

1
Зарегистрируйтесь

Создайте аккаунт по email и подтвердите почту.

2
Пополните баланс

Картой РФ, через СБП или криптовалютой. Списываются только использованные токены, баланс не сгорает.

3
Создайте API-ключ

В разделе «API-ключи» выберите группу: Claude для моделей Anthropic или GPT для моделей OpenAI.

4
Подключите клиент

Укажите в клиенте адрес API и ключ. Ниже готовые настройки для популярных инструментов.

Адрес API

Для клиентов в формате Anthropic (Claude Code, Anthropic SDK), без /v1:

https://chapi.space

Для OpenAI-совместимых клиентов (Codex, Cursor, OpenAI SDK и другие), с /v1:

https://chapi.space/v1

В кабинете у каждого ключа есть кнопка «Использовать ключ», она показывает готовую настройку для Claude Code, Codex, OpenCode и других клиентов уже с вашим ключом.

Подключение клиентов

Выберите инструмент. В примерах вместо sk-... подставьте свой ключ.

Claude Code
Агент Anthropic в терминале
Ключ: из группы Claude
  1. 1

    Установите Claude Code:

    bash
    npm install -g @anthropic-ai/claude-code
  2. 2

    Задайте адрес и ключ через переменные окружения и запустите Claude Code. Адрес указывается без /v1: клиент сам добавляет /v1/messages, иначе получится /v1/v1/messages и ошибка 404.

    bash
    export ANTHROPIC_BASE_URL="https://chapi.space"
    export ANTHROPIC_AUTH_TOKEN="sk-..."
    claude
  3. 3

    Чтобы не задавать переменные каждый раз, добавьте их в ~/.claude/settings.json:

    ~/.claude/settings.json
    {
      "env": {
        "ANTHROPIC_BASE_URL": "https://chapi.space",
        "ANTHROPIC_AUTH_TOKEN": "sk-..."
      }
    }
  4. 4

    Модель переключается командой /model внутри сессии или флагом при запуске:

    bash
    claude --model claude-opus-5-5
Подробная инструкция, модели и решение проблем: Claude Code

Модели

Идентификатор указывается в поле model запроса или в настройках клиента. Список моделей, доступных конкретному ключу, отдаёт GET /v1/models.

МодельГруппа ключа
claude-opus-4-5-20251101
Claude Opus 4.5
Claude
claude-opus-4-6
Claude Opus 4.6
Claude
claude-opus-4-7
Claude Opus 4.7
Claude
claude-opus-4-8
Claude Opus 4.8
Claude
claude-opus-5
Claude Opus 5
Claude
claude-opus-5-5
Claude Opus 5.5
Claude
claude-sonnet-4-5-20250929
Claude Sonnet 4.5
Claude
claude-sonnet-4-6
Claude Sonnet 4.6
Claude
claude-sonnet-5
Claude Sonnet 5
Claude
claude-sonnet-5-5
Claude Sonnet 5.5
Claude
claude-haiku-4-5-20251001
Claude Haiku 4.5
Claude
claude-haiku-5-5
Claude Haiku 5.5
Claude
gpt-6
GPT-6
GPT
gpt-6-astra
GPT-6 Astra
GPT
gpt-5.5
GPT-5.5
GPT
gpt-5.6
GPT-5.6
GPT
gpt-5.6-sol
GPT-5.6 Sol
GPT
gpt-5.4
GPT-5.4
GPT
gpt-5.6-terra
GPT-5.6 Terra
GPT
gpt-6-sol
GPT-6 Sol
GPT
gpt-6.1-sol
GPT-6.1 Sol
GPT
gpt-5.2
GPT-5.2
GPT
gpt-5.3-codex-spark
GPT-5.3 Codex Spark
GPT
gpt-6.1-terra
GPT-6.1 Terra
GPT
codex-auto-review
Codex Auto Review
GPT
gpt-5.6-luna
GPT-5.6 Luna
GPT
gpt-6-luna
GPT-6 Luna
GPT

Справочник API

Шлюз совместим с Anthropic API и OpenAI API. Ключ любой группы принимает все три формата запросов, при необходимости шлюз конвертирует запрос в формат провайдера.

Авторизация

Ключ передаётся в заголовке Authorization: Bearer sk-... или x-api-key: sk-... (формат Anthropic). Оба варианта работают на всех эндпоинтах.

Эндпоинты

POST/v1/messages

Anthropic Messages API: потоковые ответы, режим размышлений, tool_use, кэширование промптов.

POST/v1/messages/count_tokens

Подсчёт токенов запроса в формате Anthropic.

POST/v1/chat/completions

OpenAI Chat Completions: потоковые ответы и вызов инструментов.

POST/v1/responses

OpenAI Responses API. Ответы не хранятся: previous_response_id не поддерживается.

GET/v1/models

Список моделей, доступных ключу.

Примеры запросов

POST /v1/messages
curl https://chapi.space/v1/messages \
  -H "x-api-key: sk-..." \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-5-5",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Hello!"}]
  }'
POST /v1/chat/completions
curl https://chapi.space/v1/chat/completions \
  -H "Authorization: Bearer sk-..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.6",
    "messages": [{"role": "user", "content": "Hello!"}]
  }'
POST /v1/responses
curl https://chapi.space/v1/responses \
  -H "Authorization: Bearer sk-..." \
  -H "Content-Type: application/json" \
  -d '{"model": "gpt-5.6", "input": "Hello!"}'
GET /v1/models
curl https://chapi.space/v1/models \
  -H "Authorization: Bearer sk-..."

Для потокового ответа добавьте "stream": true, и ответ придёт в формате Server-Sent Events, как у оригинального API.

Возможности и ограничения

Поддерживается
  • Anthropic Messages API (/v1/messages), OpenAI Responses и Chat Completions (/v1/responses, /v1/chat/completions), список моделей (/v1/models).
  • Потоковые ответы, режим размышлений, вызов инструментов, изображения и PDF на входе.
  • Кэширование промптов: повторный контекст списывается по цене чтения кэша.
  • Claude Code, Codex, Cline, Roo Code, Zed, OpenCode, официальные SDK.
Ограничения
  • Нет Batch API и Files API. Файлы и изображения передаются в теле запроса.
  • Нет эмбеддингов, дообучения (fine-tuning) и Assistants API.
  • Ответы GPT не хранятся на сервере: previous_response_id не работает, историю диалога клиент передаёт сам.
  • Экспериментальные beta-функции Anthropic поддерживаются выборочно.

Частые вопросы

Claude Code возвращает 404

Скорее всего, в ANTHROPIC_BASE_URL адрес указан с /v1. Для Claude Code и Anthropic SDK адрес указывается без /v1.

Ключ не видит нужную модель

Ключ привязан к группе: ключ из группы Claude работает только с моделями Anthropic, из группы GPT только с моделями OpenAI. Создайте ключ в нужной группе. Доступные модели можно проверить запросом GET /v1/models.

Как подключить Cursor?

Нужен платный тариф Cursor. Ключ Chapi из группы Claude или GPT вставляется в Cursor Settings → Models → API Keys в поле OpenAI API Key. Там же включаются Use OpenAI API Key и Override OpenAI Base URL с адресом https://chapi.space/v1, а поле Anthropic API Key остаётся пустым. Модели Claude добавляются через Add model с приставкой chapi-, например chapi-claude-sonnet-5-5. Пошаговая инструкция со скриншотами: раздел Cursor на этой странице и страница chapi.space/cursor.

Cursor пишет «Model name is not valid» или «Provider Error»

«Model name is not valid»: Cursor не отправил запрос в Chapi. Не включён Use OpenAI API Key, или у модели Claude нет приставки chapi-. «Provider Error» с текстом «We're having trouble finding the resource»: запрос дошёл до Chapi, но модели нет в группе ключа. Проверьте имя модели и группу ключа. В обычной группе Claude модели Fable нет, её открывают по запросу.

Как считается стоимость?

По официальным ценам провайдера за входные, выходные и кэшированные токены: к этой сумме применяется скидка: для Claude скидка 50%, для GPT скидка 80%. Расход по каждому запросу виден в разделе «Использование».

Как пополнить баланс?

В разделе пополнения в кабинете: картой РФ или через СБП (сумма пересчитывается в рубли по актуальному курсу) либо криптовалютой. Баланс зачисляется автоматически после оплаты.

Хранится ли переписка?

Нет. История диалогов хранится в вашем клиенте. На сервере сохраняется только статистика расхода: модель, токены и стоимость.

Куда писать, если что-то не работает?

В Telegram @blackvizer или на blackvizer@gmail.com. Приложите текст ошибки, название клиента и модель.