Популярные вопросы по 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, переменные окружения и настройка ключа.
Правовые вопросы и данные
Оператор персональных данных, трансграничная передача, права на результаты и хранение.
Вы оператор персональных данных?
Да. ИП Шкарупа А.А. включён в реестр операторов персональных данных Роскомнадзора: № 77-26-558256, уведомление об обработке зарегистрировано 19.06.2026. Уведомление о трансграничной передаче № 100326340 зарегистрировано 23.06.2026; ограничений по нему не установлено. Проверить запись можно в публичном реестре Роскомнадзора по номеру или ИНН.
Какие данные уходят за пределы России и на каком основании?
Содержимое ваших запросов к моделям — тексты, а также изображения, аудио и видео, если вы их передаёте, — уходит поставщикам моделей, в том числе на ресурсы в США, Китае и странах Европейского союза. Основание — согласие субъекта персональных данных и исполнение договора, ст. 12 Федерального закона № 152-ФЗ. Собственные данные клиента (email, имя или наименование, ИНН, платёжные и технические данные) хранятся в базах на территории Российской Федерации.
Кто оператор данных моих пользователей?
Если вы встраиваете API в свой продукт, оператором персональных данных ваших пользователей являетесь вы. Вы отвечаете за законность включения их данных в запросы и за наличие согласия или иного законного основания. Мы передаём содержимое запросов поставщикам моделей как технический посредник.
Можно ли замаскировать персональные данные в запросе?
Автоматическое маскирование персональных данных для ключа сейчас не применяется на пути запроса: функция выведена из работы, поэтому она не является защитой или гарантией. Если передавать персональные данные третьих лиц нельзя, не отправляйте их в запросах или ограничьте ключ моделями с отметкой «Серверы в РФ».
Как исключить трансграничную передачу?
Выберите в каталоге модели с отметкой «Серверы в РФ» и укажите только их в списке разрешённых моделей ключа. Если у модели несколько каналов, закрепите канал с этой отметкой. Тогда содержимое запроса не уйдёт зарубежному поставщику.
Можно ли пользоваться сервисом несовершеннолетним?
Сервис предназначен для лиц, достигших 18 лет. Использование несовершеннолетним допускается только с согласия и под контролем законного представителя. По конкретной ситуации рекомендуем получить консультацию юриста.
Вы храните запросы и обучаете на них модели?
Нет. Мы не храним содержимое запросов как историю чатов и не используем его для обучения моделей. Для биллинга и безопасности хранятся служебные данные: идентификаторы ключей, объём токенов, сведения о платежах и балансе.
Можно перепродавать доступ под своим брендом?
Да. Публичная оферта, пункт 5.1, разрешает перепродавать доступ к API и предоставлять его третьим лицам, в том числе в составе своего сервиса или под своим брендом, без отдельного соглашения. Вы оплачиваете весь объём по своим ключам и отвечаете за действия третьих лиц, получивших доступ.
Кому принадлежат результаты генерации?
Вам. По оферте, пункт 14, результаты генерации, созданные с использованием сервиса, принадлежат клиенту. Оператор не претендует на них и не использует их без письменного согласия клиента.
Сколько хранятся входные файлы и результаты?
Копии входных файлов, переданных inline (base64), удаляются через 24 ч. Файлы, загруженные через POST /v1/files, хранятся 7 дней. Готовые результаты генераций лежат на нашем домене 7 дней после завершения задачи (resultsExpireAt), затем удаляются.
Какие документы получит организация?
Для организаций и ИП в разделе «Организация и документы» доступны договор и закрывающие документы. Акт формируется за календарный месяц на сумму фактически потреблённых услуг, а не на сумму пополнений. Оплата по счёту доступна в разделе «Оплата».
Личный кабинет и оплата
Бонус, пополнение, возврат, счёт, ключи, 2FA и команда.
Почему не начислили бонус 100 ₽?
Стартовый бонус 100 ₽ начисляется один раз новому аккаунту после подтверждения почты кодом из письма и действует 14 дней. Его не получают аккаунты на одноразовой почте и повторные аккаунты одного человека. Если почта подтверждена, а бонуса нет, напишите в «Поддержку».
Не приходит код подтверждения на почту — что делать?
Проверьте папки «Спам» и «Рассылки». Новый код можно запросить не чаще раза в минуту; вводите код из самого свежего письма. Если в адресе опечатка или письмо так и не пришло, напишите в «Поддержку» и укажите правильный адрес.
Как пополнить баланс и какой минимум?
Пополнение — в разделе «Оплата». На plusvibeapi.ru доступны карта и СБП через Robokassa, запасной вариант ЮKassa и оплата по счёту для организаций через Точку. Минимальное пополнение — 100 ₽.
Деньги списались, а баланс не пополнился — что делать?
Обычно баланс пополняется сразу после того, как банк подтвердит оплату. Откройте «Оплата» → «История платежей»: если платёж там в статусе «Ожидание», а деньги уже списаны, напишите в «Поддержку» и приложите чек или номер операции. Мы проверим платёж и зачислим сумму вручную.
Можно ли вернуть деньги с баланса?
Да. Платёж, из которого ещё ничего не потрачено, можно вернуть в течение 14 дней: в разделе «Оплата» нажмите «Вернуть» рядом с ним, деньги придут на карту за 3–5 рабочих дней. Если кнопки нет (часть суммы уже потрачена, срок прошёл или способ оплаты не поддерживает самостоятельный возврат), напишите в «Поддержку».
Как получить счёт на оплату для компании?
В разделе «Оплата» выберите вкладку «Счёт (юрлица)» и заполните реквизиты организации: счёт формируется на сумму пополнения. Закрывающие документы, акт за фактически потреблённые услуги, находятся в разделе «Организация и документы».
Что можно настроить у API-ключа?
В карточке ключа задаются лимит расходов, список разрешённых моделей, IP-allowlist и стратегия роутинга: «По умолчанию» — первый доступный канал, «Только дефолтный» — без переключения на альтернативы, «По порядку (failover)» — идёт по каналам сверху вниз при сбое.
Как включить двухфакторную аутентификацию?
В «Настройках» откройте «Двухфакторная аутентификация» и включите приложение-аутентификатор (TOTP) или код на почту. Дополнительный фактор защищает вход в кабинет и смену платёжных данных.
Как добавить сотрудников в команду?
В разделе «Команда» владелец аккаунта приглашает сотрудников по email и задаёт дневной, месячный или общий лимит расходов. Сотрудник видит свою историю использования, но не может пополнять баланс или менять платёжные данные.
Ответы носят справочный характер и не являются юридической консультацией. По вашей ситуации обратитесь к юристу.
Полезные разделы
FAQ и лимиты API
Лимиты частоты, параллельные запросы, 429 и Retry-After.
Ошибки и лимиты
Коды ответов и что делать при временных ошибках.
Инструкции для инструментов
[CC], Codex, Cursor, OpenCode и другие клиенты.
[CC]
Настройка Anthropic CLI через /v1/messages.
Codex CLI
Настройка Responses API и wire_api = "responses".
Cursor
Override [OI] Base URL и пользовательская модель.
OpenCode
Провайдер opencode.json и загрузка конфига.
152-ФЗ и данные
Где хранятся данные и что передаётся поставщикам моделей.
Политика обработки данных
Полный текст политики и порядок обращения.
Публичная оферта
Правила использования, перепродажа и права на результаты.
Поддержка
Создайте тикет, если ответа на странице нет.
Не нашли ответ?
Создайте тикет в поддержке — мы ответим и поможем разобраться с вашим случаем.