1. Создайте ключ#

В кабинете откройте API-ключи и нажмите «Создать ключ». Секрет показывается один раз — сохраните его в менеджере паролей или секретов.

В разделе Подключение API собраны адреса OpenAI и Claude API, заголовки авторизации и примеры на cURL, Python и Node.js. В терминальном блоке задайте VIBECODE_API_KEY, заменив YOUR_API_KEY своим секретом. Затем выберите модель и скопируйте пример для своего приложения.

2. Сохраните ключ в окружении#

export VIBECODE_API_KEY="sk-vc-ЗАМЕНИТЕ_НА_СВОЙ_КЛЮЧ"

$env:VIBECODE_API_KEY = "sk-vc-ЗАМЕНИТЕ_НА_СВОЙ_КЛЮЧ"

Переменная действует в текущем терминале. На сервере храните ключ в секретах окружения.

3. Отправьте запрос#

Для Python установите pip install openai, для Node.js — npm install openai.

curl https://api.vibecodepro.ru/v1/responses \
  -H "Authorization: Bearer $VIBECODE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-6.1-sol",
    "input": "Ответь одним словом: работает?",
    "max_output_tokens": 256
  }'

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["VIBECODE_API_KEY"],
    base_url="https://api.vibecodepro.ru/v1",
)

response = client.responses.create(
    model="gpt-6.1-sol",
    input="Ответь одним словом: работает?",
    max_output_tokens=256,
)
print(response.output_text)

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.VIBECODE_API_KEY,
  baseURL: "https://api.vibecodepro.ru/v1",
});

const response = await client.responses.create({
  model: "gpt-6.1-sol",
  input: "Ответь одним словом: работает?",
  max_output_tokens: 256,
});
console.log(response.output_text);

4. Найдите запрос в журнале#

В журнале запросов появятся модель, токены и стоимость. Если ответ — ошибка, найдите её код в разделе Ошибки.

Заголовки#

Authorization: Bearer sk-vc-…

x-api-key: sk-vc-…
anthropic-version: 2023-06-01

Оба заголовка принимаются на всех маршрутах. anthropic-version необязателен: по умолчанию — 2023-06-01. Ключ начинается с sk-vc-; ключи OpenAI и Anthropic не подходят.

Права#

По умолчанию у ключа есть все права. Запрос без нужного права получает 403. Каталог моделей открыт без ключа.

Ограничения#

Ротация#

1. Создайте новый ключ
2. Разверните его и проверьте запрос
3. Отзовите старый ключ

   Отозванный ключ перестаёт работать сразу.

Доступные модели#

В поле model указывайте идентификатор так же, как в документации OpenAI и Anthropic. Цена платформы — официальная цена × 0,2 (скидка 80%), в долларах за 1M токенов. Цены сверены с прайсами провайдеров 1 ноября 2026.

OpenAI#

Формат — Responses или Chat Completions.

Anthropic#

Формат — Messages.

Кэш промптов#

Кэшированный вход тарифицируется по официальной цене кэша конкретной модели, а не по единому проценту. У Anthropic чтение кэша и запись на 5 минут — отдельные цены (см. колонки выше). Кэшированный вход не расходует минутный TPM.

Список через API#

curl https://api.vibecodepro.ru/v1/models

Каталог доступен без ключа. С ключом возвращаются модели OpenAI-формата, с заголовком anthropic-version — модели Anthropic в формате Anthropic.

Неизвестная модель#

Если идентификатора нет в каталоге, шлюз возвращает 404 с кодом model_not_found; в тексте ошибки перечислены доступные модели. Подмены на другую модель нет. Официальные датированные версии claude-haiku-4-5-20251001 и claude-opus-4-5-20251101 принимаются и записываются под основным идентификатором; запрошенное имя возвращается в заголовке vc-requested-model.

CodexСкрипт или config.tomlClaude CodeТерминал, VS Code, приложениеCursorНастройки моделейOpenCodeopencode.json, Codex и Claude

Что выбрать#

Установщик#

Для macOS, Linux и WSL. Настраивает Codex и Claude Code: проверяет ключ, сохраняет резервную копию и записывает параметры VibeCode, не трогая остальные настройки.

curl -fsSL 'https://api.vibecodepro.ru/setup/tools.sh?tools=codex%2Cclaude' | bash

Скрипт спросит ключ и подключит весь совместимый каталог. Для одного инструмента укажите в адресе ?tools=codex, ?tools=claude или ?tools=opencode. Выбирайте модель в самом клиенте: /model в Codex и Claude Code, /models в OpenCode. В Windows выполните ту же строку в Ubuntu через WSL.

curl -fsSL https://api.vibecodepro.ru/setup/tools.sh | bash -s -- --doctor

Что меняет скрипт#

Чтобы прочитать скрипт до запуска, скачайте его: curl -fsSL https://api.vibecodepro.ru/setup/tools.sh -o vibecode-setup.sh, затем bash vibecode-setup.sh.

AI-инструменты

Codex

CLI, расширение для IDE и приложение Codex читают один файл настроек — достаточно настроить его один раз.

• ПротоколResponses
• Моделиgpt-6.1-sol · gpt-6.1-terra · другие модели OpenAI
• Где работаетCLI, IDE, приложение
• НастройкаСкрипт или config.toml

Быстрая настройка#

macOS, Linux и WSL:

curl -fsSL 'https://api.vibecodepro.ru/setup/tools.sh?tools=codex' | bash

Скрипт спросит ключ, добавит провайдера vibecode в ~/.codex/config.toml, сохранит ключ в ~/.codex/auth.json вместо входа через ChatGPT и сделает резервную копию. Затем перезапустите Codex и выберите любую модель OpenAI через /model. Установщик загружает весь каталог; модель по умолчанию не ограничивает выбор. Полный список изменений — в разделе Установщик.

Ручная настройка#

Для Windows или если хотите всё контролировать.

1. Сохраните ключ

   Задайте VIBECODE_API_KEY, как в быстром старте.

2. Скачайте каталог моделей

   Без него Codex не знает контекст и уровни рассуждения моделей.

   macOS / LinuxWindows PowerShell

   macOS / LinuxКопировать

   mkdir -p ~/.codex
   curl -fsSL https://api.vibecodepro.ru/backend-api/codex/models -o ~/.codex/vibecode-models.json

3. Добавьте провайдера в config.toml

   Файл ~/.codex/config.toml, в Windows — %USERPROFILE%\.codex\config.toml. Первые четыре строки — до любых таблиц […].

   ~/.codex/config.tomlКопировать

   model = "gpt-6.1-sol"
   model_provider = "vibecode"
   model_catalog_json = "/Users/you/.codex/vibecode-models.json"
   web_search = "disabled"
   
   [model_providers.vibecode]
   name = "VibeCode PRO"
   base_url = "https://api.vibecodepro.ru/v1"
   wire_api = "responses"
   env_key = "VIBECODE_API_KEY"
   supports_websockets = false

   В model_catalog_json укажите полный путь к файлу из шага 2; в Windows — в одинарных кавычках: 'C:\Users\you\.codex\vibecode-models.json'. Встроенный веб-поиск отключён: через шлюз он недоступен.

Проверка#

codex exec "Ответь одним словом: подключено"

В интерактивном режиме выполните /status: там будут провайдер VibeCode PRO и выбранная модель. Сменить модель — /model или codex --model gpt-6.1-terra.

Приложение и IDE#

Приложение Codex и расширение для VS Code и совместимых редакторов читают тот же config.toml — перезапустите их после настройки.

Облачные задачи Codex работают через аккаунт ChatGPT и шлюз не используют.

Если не работает#

AI-инструменты

Claude Code

Терминал, расширение VS Code и вкладка Code в приложении Claude — с оплатой с баланса VibeCode PRO.

• ПротоколMessages
• Моделиclaude-opus-5-5 · claude-sonnet-5-5 · claude-haiku-5-5
• Где работаетТерминал, VS Code, приложение
• НастройкаСкрипт или settings.json

Быстрая настройка#

macOS, Linux и WSL:

curl -fsSL 'https://api.vibecodepro.ru/setup/tools.sh?tools=claude' | bash

Скрипт пропишет адрес, ключ и модели в ~/.claude/settings.json, сохранив остальные настройки и резервную копию. Включается автоматическое получение каталога gateway; все модели Claude доступны через /model.

Ручная настройка#

Добавьте блок env в ~/.claude/settings.json, в Windows — %USERPROFILE%\.claude\settings.json. Настройки из файла действуют в любом терминале.

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.vibecodepro.ru",
    "ANTHROPIC_AUTH_TOKEN": "sk-vc-ЗАМЕНИТЕ_НА_СВОЙ_КЛЮЧ",
    "ANTHROPIC_MODEL": "claude-sonnet-5-5",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5-5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5-5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-5-5",
    "ANTHROPIC_SMALL_FAST_MODEL": "claude-haiku-5-5"
  }
}

Адрес указывается без /v1. Фоновые задачи, которые Claude Code обычно отправляет в Haiku, выполняются на claude-haiku-5-5. ANTHROPIC_AUTH_TOKEN передаёт ключ без дополнительного подтверждения при запуске.

Расширение VS Code#

Откройте Preferences: Open User Settings (JSON) и добавьте переменные в пользовательские настройки — расширение проверяет вход по ним, а не по ~/.claude/settings.json.

{
  "claudeCode.environmentVariables": [
    { "name": "ANTHROPIC_BASE_URL", "value": "https://api.vibecodepro.ru" },
    { "name": "ANTHROPIC_AUTH_TOKEN", "value": "sk-vc-ЗАМЕНИТЕ_НА_СВОЙ_КЛЮЧ" },
    { "name": "ANTHROPIC_MODEL", "value": "claude-sonnet-5-5" }
  ],
  "claudeCode.disableLoginPrompt": true
}

disableLoginPrompt убирает окно входа в аккаунт Anthropic — он не нужен.

Приложение Claude#

Настольное приложение не читает settings.json и переменные терминала — шлюз задаётся в его собственных настройках.

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

   Help → Troubleshooting → Enable Developer Mode. Приложение перезапустится, появится меню Developer.

2. Откройте настройки шлюза

   Developer → Configure Third-Party Inference, в разделе Connection выберите Inference provider: Gateway.

3. Заполните поля

   Поле	Значение
   Gateway base URL	https://api.vibecodepro.ru
   Gateway API key	Ваш ключ sk-vc-…
   Gateway auth scheme	x-api-key

4. Примените настройки

   Apply Changes — приложение перезапустится. Выберите модель claude-sonnet-5-5 или claude-opus-5-5.

Шлюз включается для всего приложения — чата, Cowork и Code. История и вход становятся локальными. Если меню Developer пропало после перезапуска, включите режим разработчика снова.

Проверка#

Запустите claude и выполните /status. Должна появиться строка Anthropic base URL с адресом VibeCode. Если вместо неё указан вход через claude.ai, ключ не применился.

AI-инструменты

Cursor

Подключите ключ VibeCode PRO как OpenAI-ключ и добавьте свою модель в чат.

• ПротоколChat Completions
• Моделиgpt-6.1-terra · gpt-6.1-sol · другие модели OpenAI
• Где работаетЧат с добавленной моделью
• НастройкаSettings → Models

Настройка#

1. Откройте настройки ключей

   Cursor Settings → Models → API Keys.

2. Вставьте ключ

   Включите OpenAI API Key и вставьте ключ sk-vc-….

3. Укажите адрес

   Включите Override OpenAI Base URL и вставьте адрес — без /chat/completions в конце.

   Override OpenAI Base URLКопировать

   https://api.vibecodepro.ru/v1

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

   В списке моделей нажмите Add Custom Model, введите gpt-6.1-terra или gpt-6.1-sol и выберите её в чате.

Что пойдёт через VibeCode#

Собственные ключи доступны не на всех тарифах Cursor. Для агентной работы целиком на балансе VibeCode используйте Codex, Claude Code или OpenCode.

Проверка#

Отправьте сообщение с моделью gpt-6.1-terra и найдите запрос в журнале.

AI-инструменты

OpenCode

Одна команда подключает весь каталог OpenAI и Anthropic. Модель выбирается в OpenCode через /models.

• ПротоколChat Completions · Messages
• МоделиOpenAI · Anthropic
• Где работаетТерминал, приложение, IDE
• Настройкаopencode.json

Быстрая настройка#

macOS, Linux и Ubuntu в WSL. Установите OpenCode и Python 3, затем выполните:

curl -fsSL 'https://api.vibecodepro.ru/setup/tools.sh?tools=opencode' | bash

Введите API-ключ по запросу и перезапустите OpenCode. Скрипт добавит весь каталог в общий opencode.json или существующий opencode.jsonc, сохранит остальные настройки и резервную копию. Ключ хранится отдельно в защищённом файле; повторный запуск обновляет каталог. В /models доступны провайдеры VibeCode PRO · OpenAI и VibeCode PRO · Claude.

curl -fsSL https://api.vibecodepro.ru/setup/tools.sh | bash -s -- --rollback

Ручная настройка#

Добавьте два провайдера — для моделей OpenAI и Anthropic — в opencode.json в корне проекта или в общий ~/.config/opencode/opencode.json, сохранив остальные настройки.

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "vibecode": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "VibeCode PRO",
      "options": {
        "baseURL": "https://api.vibecodepro.ru/v1",
        "apiKey": "{env:VIBECODE_API_KEY}"
      },
      "models": {
        "gpt-6.1-sol": { "name": "GPT-6.1 Sol", "limit": { "context": 272000, "output": 64000 } },
        "gpt-6.1-terra": { "name": "GPT-6.1 Terra", "limit": { "context": 272000, "output": 64000 } }
      }
    },
    "vibecode-claude": {
      "npm": "@ai-sdk/anthropic",
      "name": "VibeCode PRO · Claude",
      "options": {
        "baseURL": "https://api.vibecodepro.ru/v1",
        "apiKey": "{env:VIBECODE_API_KEY}"
      },
      "models": {
        "claude-opus-5-5": { "name": "Claude Opus 5.5", "limit": { "context": 200000, "output": 64000 } },
        "claude-sonnet-5-5": { "name": "Claude Sonnet 5.5", "limit": { "context": 200000, "output": 64000 } }
      }
    }
  },
  "model": "vibecode/gpt-6.1-sol"
}

Ключа в файле нет: OpenCode подставит значение переменной VIBECODE_API_KEY. limit сообщает OpenCode размер контекста — без него он не знает, когда сжимать историю. Нужны только модели OpenAI — удалите блок vibecode-claude. Другие модели каталога добавляются по тому же образцу — см. Модели.

Запуск#

1. Задайте ключ

   Как в быстром старте, в том же терминале.

2. Запустите OpenCode

   Команда opencode в папке проекта.

3. Выберите модель

   Команда /models, провайдеры VibeCode PRO и VibeCode PRO · Claude.

Проверка#

opencode run -m vibecode/gpt-6.1-sol "Ответь одним словом: подключено"

opencode run -m vibecode-claude/claude-sonnet-5-5 "Ответь одним словом: подключено"

Запрос#

curl https://api.vibecodepro.ru/v1/responses \
  -H "Authorization: Bearer $VIBECODE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-6.1-sol",
    "input": "Ответь одним словом: работает?",
    "max_output_tokens": 256
  }'

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["VIBECODE_API_KEY"],
    base_url="https://api.vibecodepro.ru/v1",
)

response = client.responses.create(
    model="gpt-6.1-sol",
    input="Ответь одним словом: работает?",
    max_output_tokens=256,
)
print(response.output_text)

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.VIBECODE_API_KEY,
  baseURL: "https://api.vibecodepro.ru/v1",
});

const response = await client.responses.create({
  model: "gpt-6.1-sol",
  input: "Ответь одним словом: работает?",
  max_output_tokens: 256,
});
console.log(response.output_text);

Параметры#

Ответ#

{
  "id": "resp_…",
  "status": "completed",
  "model": "gpt-6.1-sol",
  "output": [{
    "type": "message",
    "role": "assistant",
    "content": [{ "type": "output_text", "text": "Работает." }]
  }],
  "usage": { "input_tokens": 16, "output_tokens": 4, "total_tokens": 20 }
}

SDK собирает текст в output_text. В output бывают и элементы reasoning и function_call — не берите текст из первого элемента. status: "incomplete" означает, что ответ упёрся в лимит; он тарифицируется по usage.

История диалога#

Надёжнее передавать историю в input самостоятельно. previous_response_id работает, пока ответ хранится у провайдера. Режим background, получение, отмена и удаление ответов не поддерживаются.

Запрос#

curl https://api.vibecodepro.ru/v1/chat/completions \
  -H "Authorization: Bearer $VIBECODE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-6.1-sol",
    "messages": [
      { "role": "system", "content": "Отвечай кратко." },
      { "role": "user", "content": "Что такое API-шлюз?" }
    ],
    "max_completion_tokens": 512
  }'

import os
from openai import OpenAI

client = OpenAI(api_key=os.environ["VIBECODE_API_KEY"],
                base_url="https://api.vibecodepro.ru/v1")

completion = client.chat.completions.create(
    model="gpt-6.1-sol",
    messages=[{"role": "user", "content": "Что такое API-шлюз?"}],
    max_completion_tokens=512,
)
print(completion.choices[0].message.content)

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.VIBECODE_API_KEY,
  baseURL: "https://api.vibecodepro.ru/v1",
});

const completion = await client.chat.completions.create({
  model: "gpt-6.1-sol",
  messages: [{ role: "user", content: "Что такое API-шлюз?" }],
  max_completion_tokens: 512,
});
console.log(completion.choices[0].message.content);

Параметры#

Ответ#

Текст — в choices[].message.content, вызовы функций — в choices[].message.tool_calls. finish_reason: "length" — ответ обрезан лимитом. В потоке читайте choices[].delta: ответ готов, когда пришёл finish_reason. Строка data: [DONE] закрывает поток и после ошибки.

Запрос#

Для SDK: pip install anthropic или npm install @anthropic-ai/sdk. Адрес в SDK указывается без /v1.

curl https://api.vibecodepro.ru/v1/messages \
  -H "x-api-key: $VIBECODE_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-5-5",
    "max_tokens": 512,
    "system": "Отвечай кратко.",
    "messages": [{ "role": "user", "content": "Что такое API-шлюз?" }]
  }'

import os
from anthropic import Anthropic

client = Anthropic(api_key=os.environ["VIBECODE_API_KEY"],
                   base_url="https://api.vibecodepro.ru")

message = client.messages.create(
    model="claude-sonnet-5-5",
    max_tokens=512,
    messages=[{"role": "user", "content": "Что такое API-шлюз?"}],
)
print(message.content[0].text)

import Anthropic from "@anthropic-ai/sdk";

const client = new Anthropic({
  apiKey: process.env.VIBECODE_API_KEY,
  baseURL: "https://api.vibecodepro.ru",
});

const message = await client.messages.create({
  model: "claude-sonnet-5-5",
  max_tokens: 512,
  messages: [{ role: "user", content: "Что такое API-шлюз?" }],
});
console.log(message.content[0].text);

Параметры#

Ответ#

content — массив блоков: text, thinking, tool_use. Обрабатывайте каждый тип отдельно. stop_reason: end_turn — ответ готов, tool_use — нужно выполнить функцию, max_tokens — ответ обрезан.

Подсчёт токенов#

curl https://api.vibecodepro.ru/v1/messages/count_tokens \
  -H "x-api-key: $VIBECODE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "claude-sonnet-5-5", "messages": [{"role": "user", "content": "Привет"}]}'

Возвращает input_tokens и ничего не списывает.

Включение#

Добавьте "stream": true. Ответ придёт как text/event-stream.

curl -N https://api.vibecodepro.ru/v1/responses \
  -H "Authorization: Bearer $VIBECODE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "gpt-6.1-sol", "input": "Объясни SSE в трёх предложениях", "stream": true}'

import os
from openai import OpenAI

client = OpenAI(api_key=os.environ["VIBECODE_API_KEY"],
                base_url="https://api.vibecodepro.ru/v1")

done = False
with client.responses.create(model="gpt-6.1-sol", stream=True,
                             input="Объясни SSE в трёх предложениях") as stream:
    for event in stream:
        if event.type == "response.output_text.delta":
            print(event.delta, end="", flush=True)
        elif event.type == "response.completed":
            done = True
        elif event.type in ("response.failed", "error"):
            raise RuntimeError("Генерация завершилась ошибкой")

if not done:
    raise RuntimeError("Поток оборвался до конца ответа")

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.VIBECODE_API_KEY,
  baseURL: "https://api.vibecodepro.ru/v1",
});

const stream = await client.responses.create({
  model: "gpt-6.1-sol",
  input: "Объясни SSE в трёх предложениях",
  stream: true,
});

let done = false;
for await (const event of stream) {
  if (event.type === "response.output_text.delta") process.stdout.write(event.delta);
  else if (event.type === "response.completed") done = true;
  else if (event.type === "response.failed" || event.type === "error") {
    throw new Error("Генерация завершилась ошибкой");
  }
}
if (!done) throw new Error("Поток оборвался до конца ответа");

События#

Keepalive и таймауты#

Строки, начинающиеся с двоеточия, — комментарии: пропускайте их. В своём reverse proxy отключите буферизацию SSE.

Продолжение после обрыва#

Если поток запущен с заголовком Idempotency-Key, каждое событие получает id. После обрыва повторите тот же запрос с тем же ключом и добавьте Last-Event-ID — придут только недополученные события, без повторного списания.

Idempotency-Key: order-7781-summary
Last-Event-ID: 42

Журнал потока хранится ограниченное время, а после ухода клиента генерация ждёт переподключения 30 секунд.

Цикл#

1. Опишите функции

   Передайте в tools имя, описание и JSON Schema аргументов.

2. Проверьте вызов

   Сверьте имя, аргументы и права пользователя. Не выполняйте произвольные команды из ответа модели.

3. Верните результат

   Responses — элемент function_call_output, Chat Completions — сообщение role: "tool", Messages — блок tool_result. Повторяйте, пока модель не ответит текстом.

Пример#

import json, os
from openai import OpenAI

client = OpenAI(api_key=os.environ["VIBECODE_API_KEY"],
                base_url="https://api.vibecodepro.ru/v1")

tools = [{
    "type": "function",
    "name": "get_stock",
    "description": "Остаток товара по артикулу",
    "parameters": {
        "type": "object",
        "properties": {"sku": {"type": "string"}},
        "required": ["sku"],
        "additionalProperties": False,
    },
    "strict": True,
}]
stock = {"DEMO-1": 12}
history = [{"role": "user", "content": "Сколько осталось DEMO-1?"}]

for _ in range(4):
    response = client.responses.create(model="gpt-6.1-sol", input=history, tools=tools)
    history += response.output
    calls = [item for item in response.output if item.type == "function_call"]
    if not calls:
        print(response.output_text)
        break
    for call in calls:
        sku = json.loads(call.arguments).get("sku")
        result = {"quantity": stock[sku]} if sku in stock else {"error": "unknown sku"}
        history.append({"type": "function_call_output", "call_id": call.call_id,
                        "output": json.dumps(result)})

Ограничения#

Поддерживаются ваши функции и клиентские инструменты Anthropic (bash, text_editor, memory, computer). Встроенные инструменты провайдеров — web_search, file_search, исполнение кода — отклоняются с 400 unsupported_paid_feature: реализуйте поиск своей функцией. Каждый шаг цикла — отдельный оплачиваемый запрос.

Маршруты#

Для клиентов с фиксированными путями: /openai/v1/ — responses, chat/completions и models; /anthropic/v1/ — messages, messages/count_tokens и models.

Что не поддерживается#

Переход с прямого API#

1. Замените адрес и ключ

   OpenAI SDK — https://api.vibecodepro.ru/v1, Anthropic SDK — https://api.vibecodepro.ru. Ключ — sk-vc-….

2. Проверьте идентификатор модели

   Используйте официальные идентификаторы из раздела Модели — например gpt-6.1-sol или claude-sonnet-5-5. Формат запросов прежний.

3. Уберите неподдерживаемое

   Встроенные инструменты, background-режим и приоритетный тариф.

4. Проверьте на части трафика

   Сравните ответы, стриминг, функции и расход в журнале, затем переключайте всё.

Правило#

Сгенерируйте ключ до первой попытки, сохраните его вместе с операцией и передавайте в каждом повторе в заголовке Idempotency-Key (до 256 символов) — с тем же телом запроса. Новая операция — новый ключ. Ключ действует в пределах одного API-ключа и одного маршрута.

Пример#

import os, uuid
from openai import OpenAI

client = OpenAI(api_key=os.environ["VIBECODE_API_KEY"],
                base_url="https://api.vibecodepro.ru/v1")

# Создайте ключ один раз и сохраните вместе с задачей.
operation_key = str(uuid.uuid4())

response = client.responses.create(
    model="gpt-6.1-sol",
    input="Составь план релиза",
    extra_headers={"Idempotency-Key": operation_key},
)
# При повторе — тот же operation_key и те же параметры.

Когда повторять#

Срок хранения#

Ответ для повтора хранится до 5 минут и возвращается с заголовком idempotency-replayed: true. После истечения, а также после оборванного потока тот же ключ даёт 409 и новую генерацию не запускает. Оборванный поток продолжайте через Last-Event-ID.

У SDK есть свои автоматические ретраи. Если включаете их, передавайте один Idempotency-Key на всю операцию.

По умолчанию#

TPM считает некэшированный вход и выход. Ключи одного проекта делят его общий лимит: новый ключ его не увеличивает.

Лимиты расхода#

В настройках ключа задайте предел расхода за час, день, неделю или месяц. При превышении — 429; повтор не поможет до начала нового периода. Нехватка баланса — отдельная ошибка 402.

Ответ 429#

Учитывайте заголовок Retry-After — через сколько секунд повторять. Для лимитов ключа и проекта приходят x-ratelimit-*, для защитных лимитов — vc-ratelimit-scope.

Лимит ответа и таймауты#

Если лимит ответа не указан, шлюз ставит 16 384 токена для моделей с официальной ценой выхода дороже $12 за 1M (например gpt-6-astra, claude-opus-5-5) и 8 192 — для остальных (например gpt-6.1-sol, claude-sonnet-5-5); значение каждой модели — в таблицах раздела Модели. Если баланса не хватает на запрошенный вами лимит, шлюз уменьшает его — не меньше чем до 1 024 токенов — и возвращает новое значение в заголовке vc-max-output-clamped. Иначе — 402.

Для длинных ответов используйте стриминг.

Коды ответов#

Формат#

{
  "error": {
    "message": "Insufficient balance",
    "type": "insufficient_quota",
    "code": "insufficient_balance",
    "param": null
  }
}

{
  "type": "error",
  "error": {
    "type": "authentication_error",
    "message": "Invalid API key"
  }
}

Ветвите логику по HTTP-коду и code / type, а не по тексту message. Ответ 402 дополнительно содержит required_credits и available_credits.

Request ID#

Ответы и ошибки маршрутов модели содержат заголовок x-request-id. По нему запрос находится в журнале. В обращении в поддержку укажите request ID, время и код ответа — без ключа и текста запроса.

Быстрая проверка#

1. Адрес

   OpenAI SDK — с /v1, Anthropic SDK — без.

2. Модель и формат

   Модели OpenAI — Responses и Chat Completions, модели Anthropic — Messages.

3. Баланс и лимиты

   402 — баланс, 429 — лимиты. Это разные проблемы.

4. Статус сервиса

   Проверьте страницу статуса.

Как списывается#

1. Резерв

   Перед запросом шлюз резервирует сумму на вход и лимит ответа. Если её не хватает, лимит ответа уменьшается, а при совсем малом балансе — 402.

2. Списание

   После ответа списывается фактический расход: вход, кэш и выход по тарифу модели (кэшированный вход — по цене кэша этой модели). Рассуждения входят в выход.

3. Возврат

   Неиспользованный остаток резерва сразу возвращается на баланс.

Баланс#

curl https://api.vibecodepro.ru/v1/balance \
  -H "Authorization: Bearer $VIBECODE_API_KEY"

Нужно право billing:read. balance_credits — доступно сейчас, уже за вычетом резерва; reserved_credits — в резерве у выполняющихся запросов.

Расход#

curl -G https://api.vibecodepro.ru/v1/usage \
  -H "Authorization: Bearer $VIBECODE_API_KEY" \
  --data-urlencode "from=2026-10-01T00:00:00Z" \
  --data-urlencode "to=2026-11-01T00:00:00Z" \
  --data-urlencode "limit=100"

Нужно право usage:read. Фильтры: model, status, key_id, период from–to. data — запросы за период, next_cursor — передайте его в cursor за следующей страницей; limit — до 500. summary — итог по всему аккаунту без учёта фильтров.

Перед запуском#

Мониторинг#

Следите за долей 429 и 5xx, обрывами потоков и скоростью расхода. Настройте оповещение о низком балансе и росте 402. Логируйте request ID, модель, статус и задержку — без ключей и текста запросов.

При сбое#

Проверьте статус сервиса, соберите request ID и время ошибок и напишите на @vibecodepro_support.