Документация PlusVibe API
Единый OpenAI-совместимый эндпоинт для топовых LLM, веб-поиска, транскрибации и генерации медиа. Российский эндпоинт, оплата в рублях. Если у вас уже есть код под OpenAI — достаточно поменять одну строку, base_url.
1. Получите ключ
Зарегистрируйтесь и создайте API-ключ в личном кабинете. Ключ начинается с sk-pv- и виден один раз — сохраните его. Пополните баланс в рублях: списание идёт по факту использования.
2. Базовый адрес
Все OpenAI-совместимые запросы идут на единый базовый адрес:
Authorization: Bearer sk-pv-… (или x-api-key: sk-pv-… для клиентов формата Anthropic). Подробнее — в разделе Аутентификация.3. Первый запрос
Один и тот же запрос на curl, в Python-SDK openai и в Node-SDK openai:
curl https://plusvibeapi.ru/v1/chat/completions \
-H "Authorization: Bearer $PLUSVIBE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-5.5",
"messages": [
{"role": "user", "content": "Привет! Кто ты?"}
]
}'Одна строка — смена base_url
Никакой переписи кода: берёте существующий проект на OpenAI SDK и меняете только base_url на https://plusvibeapi.ru/v1 и ключ на свой sk-pv-…. Совместимо с OpenAI SDK, Codex CLI и Claude Code (через /v1/messages, заголовок x-api-key).
Разделы документации
Быстрый старт за 5 минут: вставьте PlusVibe API в Codex CLI, Claude Code, Cursor, OpenAI и Anthropic SDK. Готовые config.toml, settings.json и примеры кода с ключом sk-pv-…, оплата в рублях, российский эндпоинт.
Параметр reasoning_effort (minimal|low|medium|high|xhigh) на одном id модели для GPT и Claude. Claude также поддерживает native thinking на /v1/messages. Чем выше усилие — тем глубже рассуждение и больше токенов. Примеры на curl и Python.
Как авторизовать запросы к PlusVibe API: ключи sk-pv-…, заголовки Authorization: Bearer и x-api-key, белый список IP. Примеры на curl, Python и Node.
/v1/chat/completions — OpenAI-совместимый эндпоинт чатов. Параметры model, messages, stream, temperature. Потоковая передача SSE. Пример запроса и ответа на curl, Python (openai) и Node.
/v1/messages (формат Anthropic, x-api-key) и /v1/responses — для Claude Code и Codex CLI. Подключение через единый base_url plusvibeapi.ru/v1, оплата в рублях.
Список моделей PlusVibe и как указывать их в поле model. Варианты модели через суффикс :2, :3 — разная цена и кеширование. Полный каталог с ценами в рублях.
POST /api/search — веб-поиск по API. Тело query, num, region. Возвращает результаты (заголовок, ссылка, сниппет). Цена 0.30₽ за запрос. Пример на curl, Python и Node.
POST /api/transcribe — асинхронная транскрибация аудио по URL. Параметры audio_url, language, redact_pii (редакция ПДн включена по умолчанию, 152-ФЗ). Опрос результата через GET. Цена 1.5₽/мин.
POST /api/media/generate — асинхронная генерация изображений и видео. Параметры model, prompt, opts. Опрос задачи через GET /api/media/jobs/{id}. Пример на curl и Python.
GET /v1/balance — остаток предоплаченного баланса в рублях. GET /api/key/usage — баланс плюс траты за сегодня и месяц и число запросов по ключу. GET /v1/generations — история использования с пагинацией и фильтрами по датам. Примеры на curl и Python.
Стратегия маршрутизации запросов по умолчанию: по цене, по скорости или авто, плюс фильтр «только кэширующие». Настраивается в кабинете для аккаунта или отдельного API-ключа. Лимит моделей (allowedModels) ограничивает, какие модели может вызывать ключ.
Кэширование промпта для поддерживающих моделей: повторный префикс читается из кэша заметно дешевле полного ввода. Для Claude — точки cache_control; на /v1/messages шлюз проставляет их автоматически. Примеры на curl.
Коды ошибок PlusVibe API: 401 (ключ), 402 (баланс), 403 (IP), 429 (лимит частоты). Как обрабатывать ошибки и повторять запросы с экспоненциальной задержкой.
Как подключить PlusVibe API к Cursor, Cline, Claude Code, Codex CLI, LangChain и n8n. Достаточно сменить OPENAI_BASE_URL на plusvibeapi.ru/v1 и подставить свой ключ.