Содержание
Быстрый стартАвторизацияЭндпоинтыМодели и именаЦены и списаниеКэшМетрики моделей —GET /v1/models/statsПодлинность моделей — за что мы ручаемсяОшибкиЧастые вопросыПоддержка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, а не из этого текста.
Быстрый старт #
- Зарегистрируйтесь в кабинете: https://api.vibecode-claude.online/site/account — ключ создаётся там же.
- Пополните кошелёк (СБП, рубли по курсу) и переведите сумму на ключ.
- Укажите клиенту адрес, ключ и модель.
| что | значение |
|---|---|
| адрес (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
export ANTHROPIC_BASE_URL=https://api.vibecode-claude.online export ANTHROPIC_AUTH_TOKEN=sk-ваш-ключ claude
Модель выбирается командой /model внутри Claude Code или переменной ANTHROPIC_MODEL.
Codex CLI
# ~/.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"
export VIBECODE_API_KEY=sk-ваш-ключ codex
OpenAI-совместимые клиенты и библиотеки
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
{"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 — один кошелёк.