Справочник клиента

Популярные вопросы по API

Собрали ответы, которые чаще всего спрашивают в поддержке: как работают модели и каналы, что происходит с данными, как устроены оплата, бонусы и настройки ключей.

Использование API и моделей

Модели, каналы, ошибки, цены, кэш и генерации — коротко и по делу.

Как выбрать модель и канал?

Модель запрашивается по id из каталога, например deepseek-v4.1-flash. Одна и та же модель может быть доступна в нескольких каналах; канал добавляется через двоеточие: deepseek-v4.1-flash:cxb. Без суффикса сервис сам выбирает доступный канал, с суффиксом — закрепляет выбранный. Список id и каналов с ценами есть в разделе «Модели и цены» и в GET /v1/models.

Что значат буквы после двоеточия (например, :cxb) и что делать при ошибке 503?

Это канал модели: та же модель у другого поставщика, со своей ценой, скоростью и поддержкой кэша. Без суффикса запрос сам выбирает доступный канал и при сбое переходит на следующий. С суффиксом канал закреплён и при ошибке не переключается, поэтому при 503 уберите суффикс или выберите другой канал в карточке модели в разделе «Модели и цены». Как ключ переключает каналы, задаёт «Стратегия роутинга» в настройках ключа.

Как считается цена кэша?

Чтение из кэша обычно стоит 0,1× от цены входных токенов; у отдельных моделей коэффициент другой. Точная цена и коэффициент кэша указаны в карточке модели в каталоге. В ответе usage приходят cache_read_input_tokens и cached_tokens.

Что такое min_price и max_price?

Это необязательные границы цены за 1 млн токенов в валюте проекта: в рублях на plusvibeapi.ru. max_price — потолок, выше которого запрос не будет стоить. min_price — нижняя граница, которая отсекает слишком дешёвые каналы. Если ни один канал не попадает в границы, API вернёт 422 price_bound_no_lane и самую дешёвую и самую дорогую цену среди каналов модели (cheapest_rub_per_million и dearest_rub_per_million). Оба параметра удаляются из запроса и не пересылаются поставщику.

Как устроены медиа-генерации и их цена?

Сначала получите котировку: POST /api/media/price или посмотрите цену в каталоге медиамоделей на /models. Затем создайте задачу POST /api/media/generate — она вернёт 202 и jobId. Опрашивайте GET /api/media/jobs/{jobId} до статуса success или fail либо подключите webhook_url. Успешная задача списывается по котировке, неудачная не списывается. Готовые файлы отдаются с нашего домена 7 дней (resultsExpireAt), затем отвечают 410.

Где инструкции для [CC], Codex, Cursor и OpenCode?

В документации: /docs/integrations — обзор и выбор инструмента, /docs/claude-code — [CC], /docs/codex-cli — Codex CLI, /docs/cursor — Cursor, /docs/opencode — OpenCode. Там же базовый URL, переменные окружения и настройка ключа.

Личный кабинет и оплата

Бонус, пополнение, возврат, счёт, ключи, 2FA и команда.

Почему не начислили бонус 100 ₽?

Стартовый бонус 100 ₽ начисляется один раз новому аккаунту после подтверждения почты кодом из письма и действует 14 дней. Его не получают аккаунты на одноразовой почте и повторные аккаунты одного человека. Если почта подтверждена, а бонуса нет, напишите в «Поддержку».

Не приходит код подтверждения на почту — что делать?

Проверьте папки «Спам» и «Рассылки». Новый код можно запросить не чаще раза в минуту; вводите код из самого свежего письма. Если в адресе опечатка или письмо так и не пришло, напишите в «Поддержку» и укажите правильный адрес.

Как пополнить баланс и какой минимум?

Пополнение — в разделе «Оплата». На plusvibeapi.ru доступны карта и СБП через Robokassa, запасной вариант ЮKassa и оплата по счёту для организаций через Точку. Минимальное пополнение — 100 ₽.

Деньги списались, а баланс не пополнился — что делать?

Обычно баланс пополняется сразу после того, как банк подтвердит оплату. Откройте «Оплата» → «История платежей»: если платёж там в статусе «Ожидание», а деньги уже списаны, напишите в «Поддержку» и приложите чек или номер операции. Мы проверим платёж и зачислим сумму вручную.

Можно ли вернуть деньги с баланса?

Да. Платёж, из которого ещё ничего не потрачено, можно вернуть в течение 14 дней: в разделе «Оплата» нажмите «Вернуть» рядом с ним, деньги придут на карту за 3–5 рабочих дней. Если кнопки нет (часть суммы уже потрачена, срок прошёл или способ оплаты не поддерживает самостоятельный возврат), напишите в «Поддержку».

Как получить счёт на оплату для компании?

В разделе «Оплата» выберите вкладку «Счёт (юрлица)» и заполните реквизиты организации: счёт формируется на сумму пополнения. Закрывающие документы, акт за фактически потреблённые услуги, находятся в разделе «Организация и документы».

Что можно настроить у API-ключа?

В карточке ключа задаются лимит расходов, список разрешённых моделей, IP-allowlist и стратегия роутинга: «По умолчанию» — первый доступный канал, «Только дефолтный» — без переключения на альтернативы, «По порядку (failover)» — идёт по каналам сверху вниз при сбое.

Как включить двухфакторную аутентификацию?

В «Настройках» откройте «Двухфакторная аутентификация» и включите приложение-аутентификатор (TOTP) или код на почту. Дополнительный фактор защищает вход в кабинет и смену платёжных данных.

Как добавить сотрудников в команду?

В разделе «Команда» владелец аккаунта приглашает сотрудников по email и задаёт дневной, месячный или общий лимит расходов. Сотрудник видит свою историю использования, но не может пополнять баланс или менять платёжные данные.

Ответы носят справочный характер и не являются юридической консультацией. По вашей ситуации обратитесь к юристу.

Не нашли ответ?

Создайте тикет в поддержке — мы ответим и поможем разобраться с вашим случаем.