Vtop AiVtop Ai

API для разработчиков в Vtop AI

Ключи с лимитами и шлюз, совместимый с Anthropic Messages API: /v1/messages, /v1/models.

Платформа даёт доступ к моделям не только через интерфейс, но и по API. Ключи создаются в настройках аккаунта: у каждого ключа есть имя, лимит расходов и список моделей, к которым он допущен. Отозвать ключ можно там же — он перестанет работать сразу.

Шлюз совместим с форматом Anthropic Messages API. Это значит, что к нему подключается не только ваше собственное приложение, но и готовые инструменты: достаточно указать адрес платформы как base_url. Оплата идёт с общего баланса аккаунта — тот же баланс, что и у чата в браузере.

3метода: сообщения, подсчёт токенов, список моделей
SSEпотоковые ответы — текст приходит по мере генерации
лимитрасходов на каждый ключ отдельно
allowlistмоделей — ключ допущен только к разрешённым
балансодин на чат и API

Работа с API начинается с ключа. В настройках аккаунта создаётся ключ с именем и лимитом: лимит ограничивает, сколько можно потратить этим ключом, а список разрешённых моделей — к чему он имеет доступ. Такое разделение удобно, когда ключей несколько: один для бота, другой для внутреннего инструмента, третий для эксперимента — и у каждого свой потолок расходов.

Проверка лимита выполняется до обращения к модели: если по ключу исчерпан допустимый расход, запрос отклоняется сразу, не тратя деньги. Так же проверяется и допуск к модели. Подсчёт токенов доступен отдельным методом — это позволяет заранее оценить стоимость запроса, не отправляя его модели.

Что умеет: api для разработчиков

API открывает модели платформы для внешних программ. Типовые сценарии: подключить модель к своему продукту, встроить её в редактор или в инструмент разработчика, сделать бота с доступом к каталогу. При этом используется тот же каталог и тот же баланс, что и в чате, — не нужно отдельно договариваться с каждым разработчиком модели.

Кому подойдёт

API рассчитан на разработчиков и технические команды, которым нужен доступ к моделям из кода. А также на тех, кто пользуется инструментами вроде Claude Code и хочет направлять их запросы на платформу.

Сильные и слабые стороны

Что хорошо

  • Готовый шлюз, совместимый с Anthropic Messages API
  • Отдельные ключи с лимитом расходов и списком моделей
  • Проверка лимита до обращения к модели — деньги не тратятся впустую
  • Потоковые ответы и подсчёт токенов
  • Оплата с общего баланса аккаунта

На что обратить внимание

  • Нужны навыки работы с HTTP API — это инструмент для разработчиков
  • Ключ даёт доступ к балансу аккаунта, поэтому его нужно хранить в тайне
  • Список моделей для ключа ограничивается настройками ключа

Связанные возможности

Эти разделы чаще всего используют вместе с этим — перейти можно в один клик.

Это же можно вызывать из кода

У раздела есть API-двойник: тот же протокол, что у Anthropic, ключ из кабинета и лимит расходов на нём. Пригодится, если возможности платформы нужно встроить в своё приложение или отдать агенту для кода.

Модели для этой задачи

Возможность работает с моделями каталога. Вот модели, которые чаще всего выбирают для таких задач — у каждой есть подробный обзор.

Смотрите также

Связанные разделы и страницы, которые дополняют эту возможность.

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

Как получить ключ доступа?

Ключ создаётся в настройках аккаунта, в разделе API: у него есть имя, лимит расходов и список разрешённых моделей. Там же ключ отзывается — отозванный перестаёт работать.

Какие адреса использует API?

Шлюз совместим с Anthropic Messages API: отправка сообщений, подсчёт токенов и получение списка моделей. Адрес платформы подставляется как base_url в клиенте — например, в Claude Code.

Как считается оплата за API?

Так же, как в чате: по цене выбранной модели, с общего баланса аккаунта. Дополнительно у каждого ключа можно задать свой лимит расходов — когда он исчерпан, запросы по ключу отклоняются до обращения к модели.

Можно ли ограничить ключ конкретными моделями?

Да, у ключа есть список разрешённых моделей. Запрос к модели вне списка отклоняется — это защищает от неожиданных расходов, если ключ используется в чужом коде.

Попробовать в Vtop AI

Один аккаунт и один баланс на все разделы. Начните с бесплатной GPT Terra — она не списывает деньги.

Открыть чат