Точки доступа и форматы API

API-протоколы Anthropic и OpenAI в QCode.cc (путь Gemini сейчас недоступен), три точки доступа и правильное заполнение BASE_URL

Нужен API-ключ? Зарегистрироваться →·Эндпоинты и Base URL →

Эта страница объясняет, как QCode.cc предоставляет три API-протокола, три домена доступа и как корректно указывать BASE_URL. Один и тот же API-ключ работает со всеми тремя протоколами — протокол определяется путём запроса, маршрутизация происходит на стороне сервера автоматически.

Ключ используется одинаково при любом варианте. Ещё не выбрали? Прочитайте Как выбрать тариф, затем получите ключ в консоли.

1. API-протоколы¶

QCode.cc совместим с протоколами Anthropic Messages и OpenAI. Существует также путь протокола Google Gemini, но QCode временно снял с предложения все модели Gemini, поэтому этот путь сейчас недоступен, а материалы про Gemini ниже приведены только как справка по протоколу:

Схема тела запроса совпадает с соответствующими официальными API (Anthropic POST /v1/messages / OpenAI POST /v1/chat/completions / OpenAI POST /v1/responses / Google POST /v1beta/models/{model}:generateContent).

Внимание: /api, /claude и /openai/v1 — это префиксы пути, а не самостоятельные конечные точки. SDK автоматически добавляют /v1/messages, /chat/completions или /responses. Прямой вызов curl https://api.qcode.cc/api возвращает HTML-страницу-заглушку (HTTP 200): это не ошибка, но и не подтверждение, что путь рабочий — используйте POST-проверку из раздела 5 ниже.

2. Какие модели работают по какому протоколу¶

Протокол определяется путём запроса, но не каждое семейство моделей работает по каждому протоколу. Таблица ниже — единственный источник истины; остальные страницы опираются на неё.

🔴 Модели Claude работают только по протоколу Anthropic. Если указать claude-… в /openai/v1/chat/completions, вернётся:

{"error":{"code":"model_not_available_on_endpoint",
          "message":"Model 'claude-sonnet-5' is not available on this endpoint. Claude models are served only through the Anthropic Messages API: use a base URL ending in /api (or /claude) and send POST /v1/messages. OpenAI-compatible endpoints do not serve Claude models. / Claude 模型只能走 Anthropic Messages 接口：BASE_URL 以 /api（或 /claude）结尾，请求 POST /v1/messages；OpenAI 兼容接口不提供 Claude 模型。",
          "param":"model",
          "type":"invalid_request_error"}}

Эта проверка выполняется до аутентификации — ошибка появится даже с недействительным ключом. Поэтому model_not_available_on_endpoint означает, что выбран не тот протокол, а не то, что ключ неверен; при неверном ключе возвращается Invalid API key. Не путайте эти два случая.

Ограничение касается только Claude, это не общее правило «межпротокольно нельзя»:

• Четыре китайских семейства (GLM / Kimi / DeepSeek / Qwen) работают и по Anthropic, и по OpenAI Chat

• Модели GPT работают по двум протоколам OpenAI и так же не работают по Anthropic

Что это значит при выборе инструмента: клиенты, которые поддерживают только протокол OpenAI и не позволяют задать свою Anthropic-точку (например DeepSeek-TUI и WorkBuddy), не смогут использовать модели Claude через QCode — при этом GPT и китайские модели работают нормально. Для Claude выбирайте клиент с поддержкой протокола Anthropic (Claude Code, Cline, Zed или Anthropic-путь в Cursor).

3. Три домена доступа¶

У всех трёх доменов одинаковые возможности, различие — только в сетевой маршрутизации:

Один API-ключ работает в трёх доменах — переключайтесь свободно.

🇨🇳 Для пользователей из КНР: рекомендуем asia.qcode.cc (азиатский узел: Корея / Тайвань / Гонконг); при нестабильности переключитесь на api.qcode.cc (глобальный Route 53). Запросы со всех доменов отправляются на probe.qcode.cc — введите свой API Key, чтобы увидеть детали запросов, длину контекста, расход токенов и т.д.

4. Таблица BASE_URL¶

Заполняйте согласно используемому инструменту:

Почему для Gemini две формы записи? Провайдер google в OpenCode не добавляет /v1beta/ автоматически, поэтому baseURL должен включать его (/gemini/v1beta). Gemini CLI и официальный SDK Google @google/genai сами добавляют /v1beta/, поэтому base URL должен заканчиваться на /gemini. Если добавить /v1beta вручную, получится /gemini/v1beta/v1beta/... и ошибка 404.

⚠️ Gemini сейчас недоступен: QCode временно снял с предложения все модели Gemini, поэтому две строки с base URL для Gemini выше приведены только как справка по протоколу; используйте Claude, GPT или китайские модели. Отдельно: Gemini CLI прекратил поддержку 2026-06-18 (личные тарифы), официально рекомендуется Google Antigravity CLI.

Десктопные клиенты: в Cherry Studio настраиваются все четыре протокола выше — см. Подключение Cherry Studio. Какие протоколы поддерживает каждый инструмент и работает ли Claude — в Обзоре совместимости инструментов; про подписки и ключи — Подписка, официальный API и ключ QCode.

5. Самопроверка через curl¶

Перед подключением полноценного SDK путь и сетевую доступность можно проверить простым POST:

KEY="cr_ваш_ключ"

# Тест пути протокола Anthropic
curl -s -o /dev/null -w '%{http_code}\n' -X POST https://api.qcode.cc/api/v1/messages \
  -H "Authorization: Bearer $KEY"
# → 400 = путь и ключ в порядке (отсутствие тела — ожидаемо); 401 = ключ недействителен

# Тест пути OpenAI Chat Completions
curl -s -o /dev/null -w '%{http_code}\n' -X POST https://api.qcode.cc/openai/v1/chat/completions \
  -H "Authorization: Bearer $KEY"
# → 400 / 401 аналогично

# OpenAI Responses (для Codex)
curl -s -o /dev/null -w '%{http_code}\n' -X POST https://api.qcode.cc/openai/v1/responses \
  -H "Authorization: Bearer $KEY"
# → 400 / 401 аналогично

# Тест пути протокола Google Gemini (QCode пока не предоставляет Gemini, путь недоступен, только для справки)
curl -s -o /dev/null -w '%{http_code}\n' -X POST "https://api.qcode.cc/gemini/v1beta/models/gemini-2.5-pro:generateContent" \
  -H "x-goog-api-key: $KEY"
# → 400 / 401 = путь OK

Пояснение: с ключом ответы 400 (нет тела запроса) или 401 (проблема с ключом) означают, что маршрутизация пути и сеть в порядке; 404 — неверный префикс пути, сверьтесь с таблицей в разделе 4. Если запрос с ключом возвращает 402 с code вида *_cost_limit_exceeded, то путь и ключ тоже в порядке — просто квота этого ключа исчерпана (см. справочник ошибок). Важно: запрос к этим путям без ключа вернёт HTML-страницу-заглушку (HTTP 200), а не ошибку — это признак того, что ключ не был передан.

Сквозной тест с реальным API-ключом:

curl -X POST https://api.qcode.cc/api/v1/messages \
  -H "x-api-key: YOUR_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-5","max_tokens":64,"messages":[{"role":"user","content":"ping"}]}'

Замена домена на us.qcode.cc / asia.qcode.cc с тем же путём должна дать идентичный результат — это подтверждает, что альтернативный домен доступен.

6. Часто задаваемые вопросы¶

В: Почему curl https://api.qcode.cc/api возвращает 404?

О: /api — это префикс, а не конечная точка. Полный путь: /api/v1/messages.

В: Есть ли разница между /api/v1/messages и /claude/v1/messages?

О: Нет. Оба префикса маршрутизируются в протокол Anthropic Messages. В документации мы используем /api, так как это значение по умолчанию в большинстве SDK экосистемы Claude.

В: Можно ли одним API-ключом вызывать и Claude, и Codex (GPT)?

О: Да. Ключ не зависит от протокола, протокол определяется путём запроса. /api/v1/messages — Anthropic, /openai/v1/responses — OpenAI Responses. Модели Gemini QCode сейчас не предоставляет.

В: Нужен ли у Gemini хвост /v1beta в baseURL?

О: (QCode сейчас не предоставляет Gemini, ниже — только справка по протоколу.) Зависит от инструмента. В провайдере google OpenCode нужен (укажите baseURL = /gemini/v1beta) — этот провайдер не добавляет /v1beta/ автоматически. Для Gemini CLI и официального SDK Google @google/genai — не нужен (base URL до /gemini), SDK добавит /v1beta/ сам; иначе получится /gemini/v1beta/v1beta/... и ошибка 404.

В: Какой эндпоинт выбрать?

О: Материковый Китай → asia.qcode.cc (Корея / Тайвань / Гонконг) или api.qcode.cc (глобальный Route 53); Северная Америка / Европа → us.qcode.cc. Если основной домен нестабилен, переключайтесь на другой домен.

В: Могу ли я посмотреть свою историю запросов?

О: Да. Запросы, отправленные через любой домен (api.qcode.cc / asia.qcode.cc / us.qcode.cc), отправляются на probe.qcode.cc. Введите свой API Key, чтобы увидеть список запросов, модели, токены и т.д.

В: Нужен ли конечный слэш в BASE_URL?

О: Нет. Большинство SDK сами добавляют /v1/messages и т. п.; при наличии слэша получится //v1/messages и ошибка 404.

Enterprise →