Vtop AiVtop Ai
Начать

API Vtop AI: Anthropic Messages API для агентов и своих приложений

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

Такой шлюз нужен там, где модель вызывается не человеком в чате, а программой: агент Claude Code или Cline, редактор Zed, терминальный OpenCode, собственный скрипт на Python или TypeScript. Всё, что умеет говорить на Anthropic Messages API, работает с Vtop AI без переходников — достаточно подставить адрес шлюза и ключ.

3эндпоинта в публичном API
170моделей в каталоге
2способа передать ключ
0отдельных подписок для API

Быстрый старт

Ключ создаётся в кабинете, адрес — https://vtop-ai.site. Дальше запрос уходит как в обычный Anthropic Messages API.

curl https://vtop-ai.site/v1/messages \
  -H "x-api-key: ВАШ_КЛЮЧ" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-4.5",
    "max_tokens": 256,
    "messages": [{"role": "user", "content": "Привет!"}]
  }'

Три эндпоинта

Больше в публичном API ничего нет — и этого достаточно, потому что протокол целиком реализован на этих трёх точках входа.

Публичный API Vtop AI: методы, адреса и назначение.
МетодАдресЧто делает
POST/v1/messagesЗапрос к модели. Поддерживает потоковую передачу (SSE): при «stream: true» ответ приходит событиями Anthropic.
POST/v1/messages/count_tokensОценка числа входных токенов до отправки запроса. Считается локально, деньги не списывает.
GET/v1/modelsСписок моделей, доступных вашему ключу, в формате Anthropic.

Разделы про API

Ключи, тарифы, расчёт стоимости и подключение агентов — по ссылкам.

Ключи API

Публичный API

API

Как создать ключ, задать лимит расходов и список разрешённых моделей, где хранить ключ и что означают ошибки 401 и 403.

Открыть раздел

Цены API

Публичный API

API

Из чего складывается списание: входные и выходные токены, чтение и запись кэша, наценка платформы. Полная таблица цен на 170 моделей.

Открыть раздел

Калькулятор токенов

Публичный API

API

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

Открыть раздел

Агенты и харнессы

Публичный API

API

Четырнадцать агентов для кода: Claude Code, Cline, Roo Code, Zed, OpenCode, Goose и другие. Кто подключается к Vtop AI напрямую, а кому нужен переходник.

Открыть раздел

Почему API внутри той же платформы

Ключ — это часть аккаунта, а не отдельный сервис со своим счётом.

Один баланс на чат и API

Ключ тратит с того же баланса, что и переписка в чате. Не нужно вести отдельный счёт разработчика и следить за двумя наборами тарифов.

Лимит расходов на каждом ключе

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

Список разрешённых моделей

Ключу можно разрешить не весь каталог, а только нужные модели. Ограничение проверяется до обращения к модели, поэтому запрещённая модель не тратит деньги.

Журнал построчно

Каждый запрос оставляет в журнале строку: модель, число токенов, сумма. Отлаживать расходы агента удобно по этому журналу, а не по догадкам.

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

Что чаще всего спрашивают перед первым запросом.

Какой протокол у публичного API Vtop AI?

Anthropic Messages API. Это значит, что клиент, написанный под официальный API Anthropic, работает с Vtop AI после замены адреса и ключа. Ни OpenAI-совместимого эндпоинта, ни SDK других вендоров на этом адресе нет.

Сколько стоит пользоваться API?

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

Что будет, если ключ утечёт?

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

Нужен ли ключ, чтобы просто попробовать?

Для чата — нет, там достаточно аккаунта. Ключ нужен только для программных обращений: агентов, редакторов, своих скриптов. Если вы просто хотите проверить связку, удобна GPT Terra: входные токены у неё не тарифицируются, а выходные стоят 1 $ за миллион.

Можно ли передать ключ в заголовке Authorization?

Да, шлюз понимает оба стандартных способа: «Authorization: Bearer <ключ>» и «x-api-key: <ключ>». Первый используют Claude Code и скрипты на официальном SDK, второй — большинство сторонних агентов, у которых в интерфейсе нет настройки заголовков. Подробности — в разделе Ключи API.

Есть ли ограничение по скорости запросов?

Публичных лимитов по числу запросов в секунду мы не заявляем: узкое место — лимит расходов на ключе и доступность самой модели у поставщика. Если запрос упирается в лимит ключа, ответ приходит с ошибкой, а не «молча».

Подключите API за пару минут

Ключ создаётся в кабинете, лимит расходов задаётся там же. Для отладки связки удобна GPT Terra: входные токены у неё не тарифицируются.

Открыть кабинет