Подключение к Zexkora AI Gateway

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

От промокода до первого запроса — четыре шага. Понадобится только e-mail и ключ sk-..., полученный после покупки на FunPay.

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

   Откройте https://api.zexkora.cc/register и создайте аккаунт (e-mail и пароль). Это занимает меньше минуты.

   

2. Активируйте промокод

   Перейдите в «Кошелёк» (https://api.zexkora.cc/wallet). В поле «Введите код активации» вставьте промокод с FunPay и нажмите кнопку активации — баланс пополнится мгновенно.

   

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

   Раздел «Ключи» (https://api.zexkora.cc/keys) → «Создать». Задайте имя и неограниченный срок действия. Ключ sk-... показывается один раз — сохраните его.

   

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

   Выберите приложение в меню слева. Все они используют два базовых адреса:

Проверка в терминале

curl https://api.zexkora.cc/v1/chat/completions \
 -H "Content-Type: application/json" \
 -H "Authorization: Bearer sk-ВАШ-КЛЮЧ" \
 -d '{
  "model": "deepseek-v4-flash",
  "messages": [{"role": "user", "content": "Ответь только: OK"}]
 }'

В ответе придёт "content": "OK" — шлюз работает. Дальше выберите свой клиент в меню слева.

Модели и цены

Баланс списывается по факту использования, посекундно. Курс квоты: $1.00 = 500 000 квоты. Тарифы транслируются от внешнего поставщика моделей без наценки.

Фото и видео

Медиа-генерации не тратят токены — за них списывается фиксированная цена за один запрос, независимо от промпта.

Как вызывать

Медиа-модели работают через обычный чат-эндпоинт — генерации /v1/images/generations не поддерживаются. Модель возвращает готовую ссылку на файл прямо в тексте ответа.

curl https://api.zexkora.cc/v1/chat/completions \
  -H "Authorization: Bearer sk-ВАШ-КЛЮЧ" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "qwen-image-3.0-pro",
    "messages": [{"role": "user", "content": "a red circle on white background"}]
  }'

Ответ:

{
  "choices": [{
    "message": {
      "content": "Готово (2048x2048px):\n\n![image](https://…/media/xxxx.png)"
    }
  }]
}

Видео (wan2.7-t2v)

curl https://api.zexkora.cc/v1/chat/completions \
  -H "Authorization: Bearer sk-ВАШ-КЛЮЧ" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan2.7-t2v",
    "messages": [{"role": "user", "content": "cat walking, 1 second"}]
  }'

Вернёт ссылку на MP4 (720P, 16:9). Ссылки на медиа живут ограниченное время — скачивайте файл сразу.

Python SDK

from openai import OpenAI

client = OpenAI(base_url="https://api.zexkora.cc/v1", api_key="sk-ВАШ-КЛЮЧ")

resp = client.chat.completions.create(
    model="qwen-image-3.0-pro",
    messages=[{"role": "user", "content": "a red circle on white background"}],
)
print(resp.choices[0].message.content)  # ссылка на PNG

Доступность моделей и бюджетные пулы

Шлюз подключён напрямую к апстрим-кластеру внешнего поставщика моделей. Все модели разделены на две категории по типу распределения ресурсов — это важно понимать до покупки.

🟢 Безлимитный пул — работают всегда

🟡 Модели с общим бюджетным пулом (Daily Batch Drops)

⏰ График пополнения пула

💡 Рекомендация по работе

1. Флагманы активны (GPT-6 Astra, Claude Opus 5)

   Используйте их для комплексного проектирования, сложной архитектуры и критических задач.

2. Пул исчерпан (статус 402)

   Смело переключайтесь на или DeepSeek-V4-Flash. Они работают всегда, не падают по квотам и отлично справляются со стандартным кодингом и рефакторингом.

Claude Code

Терминальный агент Anthropic. Ходит по Anthropic-совместимому протоколу: Base URL без /v1.

Установка

# Требуется Node.js 18+
node --version

# macOS / Linux / WSL
npm install -g @anthropic-ai/claude-code@latest

# Проверка
claude --version

Настройка окружения

# macOS / Linux — добавьте в ~/.bashrc или ~/.zshrc
export ANTHROPIC_AUTH_TOKEN="sk-ВАШ-КЛЮЧ-Zexkora"
export ANTHROPIC_BASE_URL="https://api.zexkora.cc"
export ANTHROPIC_MODEL="claude-opus-4-8"

# Windows PowerShell
$env:ANTHROPIC_AUTH_TOKEN = "sk-ВАШ-КЛЮЧ-Zexkora"
$env:ANTHROPIC_BASE_URL = "https://api.zexkora.cc"
$env:ANTHROPIC_MODEL = "claude-opus-4-8"

Запуск и тест

claude
# Введите: Ответь только: OK
# Затем: перечисли файлы текущей директории, ничего не изменяя

Codex CLI

Терминальный агент OpenAI. Использует OpenAI-совместимый протокол с Responses API: Base URL с /v1.

Установка

node --version  # Node.js 18+

# pnpm (или npm)
pnpm install -g @openai/codex
# npm i -g @openai/codex

codex --version

Конфигурация ~/.codex/config.toml

model = "gpt-5.6-sol"
model_provider = "zxc"

[model_providers.zxc]
name = "Zexkora AI Gateway"
base_url = "https://api.zexkora.cc/v1"
wire_api = "responses"
experimental_bearer_token = "sk-ВАШ-КЛЮЧ-Zexkora"

Запуск

cd my-project
codex
# Введите: Ответь только: OK

Qwen Code

Терминальный агент от команды Qwen. Поддерживает оба протокола через переменные окружения.

Установка и настройка

npm install -g @qwen-code/qwen-code@latest

# ===== Claude (Anthropic) =====
export ANTHROPIC_AUTH_TOKEN="sk-ВАШ-КЛЮЧ-Zexkora"
export ANTHROPIC_BASE_URL="https://api.zexkora.cc"
export ANTHROPIC_MODEL="claude-opus-4-8"

npm install -g @qwen-code/qwen-code@latest

# ===== GPT (OpenAI) =====
export OPENAI_API_KEY="sk-ВАШ-КЛЮЧ-Zexkora"
export OPENAI_BASE_URL="https://api.zexkora.cc/v1"
export OPENAI_MODEL="gpt-5.6-sol"

Запуск: qwen → «Ответь только: OK».

Cursor

IDE со встроенным AI. Подключается через переопределение OpenAI Base URL.

1. Войдите в аккаунт

   Установите Cursor и войдите в аккаунт — без входа настройки моделей недоступны.

2. Откройте настройки моделей

   Cursor Settings → Models, в поле OpenAI API Key вставьте ключ sk-... и включите переключатель.

3. Переопределите Base URL

   Включите Override OpenAI Base URL и укажите https://api.zexkora.cc/v1.

4. Проверьте

   Нажмите Verify и отправьте в чате «Ответь только: OK». Затем впишите модель вручную: gpt-5.6-sol, или deepseek-v4-flash.

Trae

IDE от ByteDance. Кастомные модели добавляются через Add Model → Custom Config.

1. Войдите в аккаунт

   После установки войдите в личный аккаунт Trae.

2. Добавьте модель

   Settings → Models → Add Model → Custom Config.

3. Заполните параметры

   По таблице ниже — в зависимости от нужного семейства моделей.

Cline

Популярное расширение VS Code для агентной разработки. Поддерживает оба протокола — держите два профиля и переключайтесь одним кликом.

Вариант A — Claude (Anthropic)

1. Установите расширение

   VS Code Extensions → Cline → Install.

2. Откройте настройки API

   Панель Cline → Settings / API Configuration.

3. Заполните параметры

   API Provider: Anthropic; включите Use custom base URL; Custom Base URL: https://api.zexkora.cc (без /v1).

4. Ключ и модель

   API Key: sk-...; Model: claude-opus-4-8 или claude-opus-5.

Вариант B — GPT / DeepSeek (OpenAI)

Roo Code

Форк Cline с режимами (Code / Architect / Ask). Настройка как в Cline, через API Configuration.

Claude (Anthropic)

GPT / DeepSeek (OpenAI)

Kilo Code

Агентное расширение VS Code. Добавляется как кастомный провайдер.

Claude (Anthropic Messages)

GPT (OpenAI Compatible)

Claude Code в VS Code

Официальное расширение Claude Code для VS Code. Настраивается через settings.json.

1. Установите расширение

   VS Code Marketplace → Claude Code. При необходимости доустановите CLI: npm i -g @anthropic-ai/claude-code.

2. Откройте settings.json

   Cmd/Ctrl+Shift+P → Open User Settings (JSON) и добавьте конфиг ниже.

3. Перезагрузите окно

   Developer: Reload Window, затем отправьте «Ответь только: OK».

{
 "claudeCode.environmentVariables": [
  { "name": "ANTHROPIC_AUTH_TOKEN", "value": "sk-ВАШ-КЛЮЧ-Zexkora" },
  { "name": "ANTHROPIC_BASE_URL", "value": "https://api.zexkora.cc" },
  { "name": "CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY", "value": "1" },
  { "name": "ANTHROPIC_MODEL", "value": "claude-opus-4-8" }
 ],
 "claudeCode.disableLoginPrompt": true,
 "claudeCode.initialPermissionMode": "acceptEdits"
}

GitHub Copilot

Copilot Chat поддерживает кастомные эндпоинты — модели Zexkora появляются в общем списке моделей.

1. Убедитесь в готовности

   Copilot Chat установлен, вы вошли в GitHub.

2. Добавьте модель

   В панели Copilot Chat откройте выбор моделей → Управление моделями → Добавить модель → Custom endpoint.

3. Для Claude

   Формат Messages (Anthropic), Base URL https://api.zexkora.cc, модель claude-opus-4-8.

4. Для GPT

   Формат Chat Completions (OpenAI), Base URL https://api.zexkora.cc/v1, модель gpt-5.6-sol / .

OpenCode Desktop

Официальное десктопное графическое приложение OpenCode (для Windows, macOS и Linux). Позволяет работать с моделями шлюза Zexkora прямо в удобном оконном интерфейсе.

Пошаговая настройка в OpenCode Desktop

1. Шаг 1. Откройте папку конфигурации:

   Перейдите в каталог настроек OpenCode на вашем компьютере:

   • Windows: нажмите комбинацию клавиш Win + R, вставьте в поле путь:
     %USERPROFILE%\.config\opencode
     и нажмите Enter (или «ОК»). Если папка opencode отсутствует, просто создайте её.
   • macOS / Linux: откройте терминал или файловый менеджер и перейдите в:
     ~/.config/opencode/
2. Шаг 2. Разместите файл opencode.jsonc:

   Поместите в открывшуюся папку файл с именем opencode.jsonc.

   Вы можете Скачать готовый opencode.jsonc и скопировать его в эту папку, либо создать текстовый документ с этим именем и вставить следующее содержимое:

   opencode.jsoncКопировать

   {
     "$schema": "https://opencode.ai/config.json",
     "provider": {
       "zxc": {
         "name": "zxc",
         "npm": "@ai-sdk/openai-compatible",
         "options": {
           "baseURL": "https://api.zexkora.cc/v1"
         },
         "models": {
           "gpt-6-astra": { "name": "gpt-6-astra" },
           "gpt-5.6-sol": { "name": "gpt-5.6-sol" },
           "gpt-5.6-luna": { "name": "gpt-5.6-luna" },
           "claude-opus-5": { "name": "claude-opus-5" },
           "claude-opus-4-8": { "name": "claude-opus-4-8" },
           "claude-opus-4.7": { "name": "claude-opus-4.7" },
           "claude-fable-5.1": { "name": "claude-fable-5.1" },
           "claude-fable-5": { "name": "claude-fable-5" },
           "deepseek-v4-flash": { "name": "deepseek-v4-flash" }
         }
       }
     }
   }

3. Шаг 3. Активируйте провайдер в приложении OpenCode Desktop:

   Откройте (или перезапустите, если оно было открыто) приложение OpenCode Desktop.

   В строке отправки сообщений внизу экрана напишите команду и нажмите Enter:

   Копировать

   /connect

   В появившемся списке провайдеров пролистайте в самый низ и выберите пункт zxc.

4. Шаг 4. Введите ваш API-ключ:

   Приложение запросит ключ доступа. Вставьте ваш токен формата sk-..., полученный в личном кабинете на вкладке Ключи Zexkora.

   После этого провайдер подключится, и в выпадающем списке выбора моделей в окне чата станут доступны все добавленные модели (GPT-6, Claude Opus 5, DeepSeek V4 и др.).

Работа через локальный проект (опционально)

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

Claude Desktop

Настольное приложение Anthropic. Подключение через режим разработчика и конфигурацию шлюза.

1. Включите режим разработчика

   Help → Troubleshooting → Enable developer mode.

2. Настройте шлюз

   Gateway base URL: https://api.zexkora.cc; Gateway API key: sk-...; Auth scheme: bearer.

3. Примените и перезапустите

   Apply locally → Relaunch now, после перезапуска выберите модель в левом нижнем углу.

NextChat / Chatbox

Лёгкие кроссплатформенные чат-приложения. В обоих — одинаковая настройка через OpenAI-совместимый провайдер.

1. Откройте настройки моделей

   Настройки → Модели / API.

2. Заполните параметры

   Провайдер OpenAI, ключ sk-..., endpoint https://api.zexkora.cc/v1.

3. Впишите модель вручную

   gpt-5.6-sol / gpt-6-astra / / deepseek-v4-flash.

Cherry Studio

Десктопный чат-клиент с поддержкой множества провайдеров.

1. Добавьте провайдера

   Настройки → Провайдеры → добавить OpenAI-совместимого провайдера.

2. Заполните параметры

   По таблице ниже.

3. Добавьте модели вручную

   Через «+» в списке моделей провайдера.

Python SDK

Прямое подключение из кода — OpenAI и Anthropic SDK. Базовые адреса те же, что и у приложений.

OpenAI SDK

pip install openai

from openai import OpenAI

client = OpenAI(
  api_key="sk-ВАШ-КЛЮЧ-Zexkora",
  base_url="https://api.zexkora.cc/v1"
)

resp = client.chat.completions.create(
  model="gpt-6-astra",
  messages=[{"role": "user", "content": "Ответь только: OK"}]
)
print(resp.choices[0].message.content)

Anthropic SDK

pip install anthropic

from anthropic import Anthropic

client = Anthropic(
  api_key="sk-ВАШ-КЛЮЧ-Zexkora",
  base_url="https://api.zexkora.cc"
)

msg = client.messages.create(
  model="claude-opus-4-8",
  max_tokens=64,
  messages=[{"role": "user", "content": "Ответь только: OK"}]
)
print(msg.content[0].text)

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