Перейти к содержанию
СтартКлючи и URL

Ключи и URL

Что использовать, что не трогать.

Протокол модели

Guard выдаёт собственные универсальные ключи gd-…. Шлюз проверяет ключ, определяет семейство по точному id модели и списывает расход Claude, Kimi, Composer или Grok с одного общего баланса ключа.

ПараметрЗначение
Base URLhttps://api.guardrelay.ai
API Keygd-… из @subscribe_ai_bot
Дашбордapp.guardrelay.ai/
Один адрес, три протокола
Общий ключ
gd-…
GUARD API
https://api.guardrelay.ai
Anthropic Messages
/v1/messages
Chat Completions
/v1/chat/completions
Responses
/v1/responses
Точный id модели
model
Выберите протокол, который ожидает ваш клиент. Для OpenAI SDK Base URL включает /v1; семейство задаётся в поле model.

Endpoint'ы Claude

Для Claude шлюз понимает Anthropic- и OpenAI-совместимые форматы. Выбирайте endpoint, который ждёт ваш клиент.

EndpointФорматКто использует
/v1/messagesAnthropic MessagesClaude Code, Anthropic SDK, curl
/v1/chat/completionsOpenAI ChatOpenAI SDK, большинство клиентов
/v1/responsesOpenAI ResponsesCodex (новые версии)

Поверхности Kimi

Ключ и адрес общие для всех семейств. Семейство шлюз определяет по точному id модели в поле model, поэтому отдельный ключ и отдельный адрес для Kimi заводить не нужно.

Что настраиваетсяЗначение для Kimi
Base URL для OpenAI SDKhttps://api.guardrelay.ai/v1
ЗаголовокAuthorization: Bearer gd-…
Поверхностивсе три: обычный POST /v1/chat/completions, протокол Anthropic Messages и протокол Responses
Моделиk3, k3-256k, kimi-for-coding, kimi-for-coding-highspeed

Проверка ключа

bash
curl -X POST https://api.guardrelay.ai/v1/chat/completions \
  -H "Authorization: Bearer gd-ваш-ключ" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "k3",
    "messages": [{"role": "user", "content": "Привет!"}],
    "max_tokens": 128
  }'

Цепочка запроса

  1. Проверка ключа: лимит, срок, отзыв.
  2. Маршрутизация в Claude, Kimi, Composer или Grok по точному id модели.
  3. Списание токенов с общего кредита ключа.

Claude Code

Переменные окружения
bash · macOS / Linux
export ANTHROPIC_BASE_URL="https://api.guardrelay.ai"
export ANTHROPIC_AUTH_TOKEN="gd-ваш-ключ-из-бота"

claude
PowerShell · Windows
$env:ANTHROPIC_BASE_URL = "https://api.guardrelay.ai"
$env:ANTHROPIC_AUTH_TOKEN = "gd-ваш-ключ-из-бота"

claude

Endpoint'ы Composer и Grok

Эти модели отвечают на всех трёх поверхностях. Endpoint выбирается по клиенту, а модель по полю model.

EndpointПоля запроса
/v1/messagesmodel, messages, system, max_tokens, stream, tools
/v1/chat/completionsmodel, messages, max_tokens либо max_completion_tokens, stream, tools
/v1/responsesmodel, input, instructions, max_output_tokens, stream, tools

Проверка ключа

Ключ и адрес те же, что у Claude: отдельной регистрации и отдельного адреса для этих моделей нет. Семейство шлюз определяет по точному id в поле model, а баланс у ключа один на все семейства.

bash
curl -X POST https://api.guardrelay.ai/v1/chat/completions \
  -H "Authorization: Bearer gd-ваш-ключ" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "cursor-grok-4.6-low",
    "messages": [{"role": "user", "content": "Привет!"}],
    "max_tokens": 128
  }'
bash
curl -X POST https://api.guardrelay.ai/v1/chat/completions \
  -H "Authorization: Bearer gd-ваш-ключ" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "composer-2.5",
    "messages": [{"role": "user", "content": "Привет!"}],
    "max_tokens": 128
  }'

Разделы документации

На этой странице