# VibeCode API — документация

Один ключ — доступ к моделям Claude, GPT, Grok и открытым моделям (DeepSeek, Qwen, GLM) по API, дешевле официальных
цен. Совместим с форматами Anthropic и OpenAI: подходит Claude Code, Codex CLI, Cursor, Kilo Code, Roo Code, Cline,
OpenCode и любые библиотеки этих форматов.

Эта страница читается и человеком, и агентом. Агенту: тот же текст в Markdown — `GET https://api.vibecode-claude.online/docs.md`,
короткий указатель — `GET /llms.txt`. Актуальные цены всегда берите из `GET /v1/pricing`, а не из этого текста.

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

1. Зарегистрируйтесь в кабинете: https://api.vibecode-claude.online/site/account — ключ создаётся там же.
2. Пополните кошелёк (СБП, рубли по курсу) и переведите сумму на ключ.
3. Укажите клиенту адрес, ключ и модель.

| что | значение |
|---|---|
| адрес (base URL) | `https://api.vibecode-claude.online` — для OpenAI-клиентов `https://api.vibecode-claude.online/v1` |
| ключ | `sk-…` из кабинета |
| модель | любое имя из `GET /v1/models` или `GET /v1/pricing` |

Запасной адрес `https://eu.vibecode-claude.online` — тот же сервис напрямую, для сетей, где основной не открывается
(Tor, часть VPN).

### Claude Code

```bash
export ANTHROPIC_BASE_URL=https://api.vibecode-claude.online
export ANTHROPIC_AUTH_TOKEN=sk-ваш-ключ
claude
```

Модель выбирается командой `/model` внутри Claude Code или переменной `ANTHROPIC_MODEL`.

### Codex CLI

```toml
# ~/.codex/config.toml
model_provider = "vibecode"

[model_providers.vibecode]
name = "vibecode"
base_url = "https://api.vibecode-claude.online/v1"
wire_api = "responses"
env_key = "VIBECODE_API_KEY"
```

```bash
export VIBECODE_API_KEY=sk-ваш-ключ
codex
```

### OpenAI-совместимые клиенты и библиотеки

```python
from openai import OpenAI

client = OpenAI(base_url="https://api.vibecode-claude.online/v1", api_key="sk-ваш-ключ")
r = client.chat.completions.create(model="gpt-6.1-sol", messages=[{"role": "user", "content": "привет"}])
print(r.choices[0].message.content)
```

## Авторизация

Ключ передаётся одним из заголовков: `x-api-key: sk-…` (формат Anthropic) или `Authorization: Bearer sk-…`
(формат OpenAI). Ключ не привязан к провайдеру: модель выбирается именем в запросе.

## Эндпоинты

| метод и путь | что | ключ |
|---|---|---|
| `POST /v1/messages` | Anthropic Messages API, поток SSE (`"stream": true`) и обычный ответ | нужен |
| `POST /v1/chat/completions` | OpenAI Chat Completions, поток и обычный ответ | нужен |
| `POST /v1/responses` | OpenAI Responses API (Codex CLI и приложение Codex) | нужен |
| `GET /v1/models` | список моделей, доступных ключу | нужен |
| `POST /v1/images/generations` | картинки: `gpt-image-2` и `grok-imagine-image*`, цена за изображение — в `extras` у `/v1/models/prices`; только с оплаченного баланса | нужен |
| `POST /v1/videos/generations` | видео `grok-imagine-video*` (`model`, `prompt`, `duration` в секундах): ответ — номер `vid_…`, статус и ссылка — `GET /v1/videos/{id}`; цена за секунду, только с оплаченного баланса | нужен |
| `POST /v1/videos/edits` | правка своего видео моделью `grok-imagine-video*`: `prompt` и `video` `{url}`; ответ и статус — как у генерации | нужен |
| `POST /v1/web/search` | веб-поиск: `query`, `provider` (`kiro` — по умолчанию, `grok` или `openai`), `max_results`; ответ — ссылки с выдержками; $0.001 за поиск, только с оплаченного баланса | нужен |
| `GET /v1/pricing` | подробный прайс: наша цена, официальная и во сколько раз дешевле | не нужен |
| `GET /v1/models/prices` | прежний прайс (формат не меняется — на нём живут интеграции партнёров) | не нужен |
| `GET /v1/models/stats` | метрики моделей по живому трафику: задержки, скорость, надёжность, кэш | нужен; данные за 24 часа, обновляются раз в 3 минуты |
| `GET /docs.md`, `GET /llms.txt` | эта документация для агента | не нужен |
| `GET /v1/news`, `GET /v1/news/{id}` | новости сервиса: обновления, оперативные новости, исследования, ИИ-новости (параметры `topic` — updates, ops, research или ai; `limit`; `before_id`); страница — `/news` | не нужен |

## Модели и имена

- **GPT** (`gpt-6.1-sol`, `gpt-6-astra`, …) и **Grok** (`grok-4.7`, …) — имя модели как есть.
- **Claude** — с префиксом канала: `databricks-claude-opus-5`, `kiro-claude-sonnet-4-6`.
  Имя без префикса (`claude-opus-5`, `claude-sonnet-5`) тоже принимается и ведёт в канал по умолчанию.
- **Открытые модели** — `vibe-<поставщик>-<модель>`, например `vibe-tencent-deepseek-v4-pro`; у многих есть
  короткое имя (`deepseek-v4-pro`, `glm-5.3`, `kimi-k3`) — список в поле `aliases` у `/v1/pricing`.
- Незнакомое имя — ошибка `400 model_not_found` с подсказкой. Подставлять модель за клиента мы не будем.

## Цены и списание

- Счёт в долларах, цены — за 1 млн токенов. Отдельно тарифицируются новый вход, чтение кэша и выход.
- Цена модели фиксирована и одинакова для всех ключей; текущая — в `GET /v1/pricing`.
- У моделей GPT для запросов длиннее 272 тыс. токенов входа действует надбавка, как у OpenAI.
- Списание видно в дашборде ключа: https://api.vibecode-claude.online/dashboard
- Обрыв и отмена не списываются, если провайдер не отдал счёт токенов.

### `GET /v1/pricing`

```json
{"object": "pricing", "currency": "USD",
 "blend": {"cache_read": 0.95, "input": 0.03, "output": 0.02},
 "models": [{"model": "vibe-tencent-deepseek-v4-pro", "provider": "vibe", "aliases": ["deepseek-v4-pro"],
             "billing": "tokens", "unit": "USD per 1M tokens",
             "price":    {"input": 0.22,  "cached": 0.00733, "output": 0.66},
             "official": {"input": 0.66,  "cached": 0.022,   "output": 1.98},
             "cheaper_x": {"input": 3.0, "cached": 3.0, "output": 3.0, "blend": 3.0}}]}
```

- `price` — наша цена, `official` — официальная цена разработчика модели, `cheaper_x` — во сколько раз мы дешевле:
  по каждому полю и одной цифрой `blend` для типичного агентского хода (95% чтения кэша, 3% нового входа, 2% выхода).
- У Claude в канале Kiro счёт идёт кредитами провайдера: `billing: "credits"`, цена — за кредит.
- `discount` — временная скидка с датой окончания, если она есть; `price` уже со скидкой.

## Кэш

Повторное чтение того же начала истории стоит в 4–30 раз дешевле нового входа (точно — поле `cached` в `/v1/pricing`). Чтобы кэш срабатывал:
не меняйте начало диалога (системный промпт, первые сообщения) между ходами и не переставляйте сообщения.
Claude Code, Codex CLI и OpenCode делают это сами. Долю попаданий кэша по моделям показывает `/v1/models/stats`.

## Метрики моделей — `GET /v1/models/stats`

Считаются по нашему живому трафику, без провайдерских обещаний. Окно — последние 24 часа, снимок обновляется раз
в 3 минуты, лимита на опрос нет. Параметры: `model=a,b`, `fields=price,first_token_s,…`. Поля модели:

| поле | что |
|---|---|
| `first_token_s` | секунды от запроса до первого токена (p50, p90, p95), мышление внутри |
| `first_text_s` | до первого текста ответа |
| `thinking` | доля ходов с видимым мышлением и его длительность; `hidden` — модель думает до первого кадра |
| `speed_tps` | токенов выхода в секунду по ходу потока |
| `success_rate` | доля ходов, отданных целиком |
| `outcomes` | доли исходов: `ok` · `before` — отказ до первого токена · `mid` — обрыв посреди ответа · `cancel` — клиент прервал сам |
| `cache` | следующий ход продолжал прошлый в пределах 5 минут — в какой доле кэш покрыл его целиком |
| `agent_100_turns_min` | сколько минут займёт задача на 100 ходов: обычно и в плохом случае |
| `low_data` | ходов мало — числа предварительные |

Глазами — на дашборде метрик https://vibecode-claude.online/lab/stats (без входа: графики, сравнение моделей, методика)
и кратко на странице https://vibecode-claude.online/site/metrics (нужен вход в кабинет).

## Подлинность моделей — за что мы ручаемся

На странице метрик (`/lab/stats`) у каждой модели указана категория её канала:

- **Официальный канал** — модель напрямую у её разработчика или у официального облака. **За такие модели мы
  ручаемся**: мы сами на них работаем каждый день. Заявить, что наша официальная модель — подделка, — серьёзное
  обвинение. Мы готовы его разбирать и доказывать обратное: пришлите запросы, ответы и ваш метод проверки.
- **Посредник** (сейчас Kiro и Databricks) — доступ к моделям через стороннюю организацию, а не через разработчика.
  Проверить подлинность модели за посредником мы не можем, поэтому не ручаемся и проверку не проводим.
- **Сторонний шлюз** (кастомные провайдеры, модели `vibe-…` и подобные) — чужой продавец доступа. За модели такого
  канала мы не отвечаем.

Нашли признаки подделки у посредника или стороннего шлюза — напишите нам напрямую (чат поддержки в кабинете или
Telegram-бот) и приложите доказательства: запросы, ответы, метод. Это работа с нашими поставщиками: разберём,
и если вы правы, уберём канал из продажи. Будем благодарны.

## Ошибки

| код | что значит | что делать |
|---|---|---|
| 400 `model_not_found` | такой модели нет | взять имя из `/v1/models` |
| 400 прочие | провайдер не принял запрос, текст причины в ответе | поправить запрос |
| 401 | ключа нет или он неверный | проверить ключ и заголовок |
| 403 `insufficient_credits` | на ключе кончились деньги | пополнить ключ в кабинете |
| 413 | тело запроса слишком большое | сжать историю (`/compact`), убрать лишние вложения |
| 429 | слишком часто или слишком много запросов разом | подождать `Retry-After` |
| 503 `No available backends` | модель временно недоступна | повторить через минуту или взять другую модель |
| 5xx прочие, обрыв потока | сбой провайдера | повторить запрос |

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

- **Баланс закончился** — новые запросы получают 403 `insufficient_credits`, ключ и история остаются. Пополните кошелёк и ключ в кабинете — работа продолжится с того же места.
- **Какие клиенты подходят** — Claude Code, Codex CLI и приложение, Cursor, VS Code (Kilo Code, Roo Code, Cline), OpenCode, JetBrains и любые OpenAI- или Anthropic-совместимые клиенты и библиотеки. Ставить ничего не нужно: только адрес и ключ.
- **Как пополнить** — в кабинете через СБП, рубли по курсу ЦБ; бонус к пополнению растёт до +50% на $50 и выше.
- **Кабинет и Telegram-бот** — при входе через Telegram это один кошелёк, те же ключи и покупки. Аккаунт по логину или Google можно привязать к Telegram в кабинете — и получить бонус.

## Поддержка

Чат поддержки — в кабинете и в дашборде ключа. Telegram-бот и кабинет при входе через Telegram — один кошелёк.
