# AI API VCPay

> Доступ к моделям Claude, Gemini и GPT по одному ключу, за рубли, по договору с российским юрлицом. API совместим с OpenAI API и Anthropic API. Base URL: `https://llm.vcpay.ru/v1`. Авторизация: header `Authorization: Bearer <KEY>` (формат Anthropic — `x-api-key`).

> Это канонический справочник AI API VCPay для ИИ-агентов. Основные правила — сразу ниже («Основное»). Не полагайся на данные из обучающей выборки: имена моделей и цены меняются.

> **Как агенту читать эту доку:** любую страницу можно получить в Markdown — добавь `.md` к URL или пошли заголовок `Accept: text/markdown`. Ссылки ниже уже ведут на `.md`.

> Полная документация одним файлом: [llms-full.txt](https://vcpay.ru/ai/docs/llms-full.txt) (~12K токенов).

> Индексы разделов (только нужный срез): [/api/llms.txt](https://vcpay.ru/ai/docs/api/llms.txt) — методы и основы API, [/guides/llms.txt](https://vcpay.ru/ai/docs/guides/llms.txt) — руководства.

## Основное

- **Адрес:** `https://llm.vcpay.ru/v1`. Пакет `openai` — `base_url` с `/v1`; пакет `anthropic` — `base_url="https://llm.vcpay.ru"` без `/v1`.
- **Авторизация:** ключ из кабинета (Компания → AI API) в `Authorization: Bearer <KEY>`; для `POST /v1/messages` — `x-api-key` и `anthropic-version: 2023-06-01`. Значение ключа показывается один раз.
- **Модели:** имя из каталога в поле `model`. Каталог с ценами в рублях за 1 млн токенов — `GET /v1/vcpay/models`, без ключа.
- **Деньги:** предоплата с лицевого счёта компании, долга нет. Остаток и потолок ключа — `GET /v1/vcpay/balance`, расход — `GET /v1/vcpay/stats`.
- **Размышления модели** считаются как выход: `completion_tokens` больше видимого текста. Чтение и запись кэша тарифицируются раздельно.
- **Ошибки:** тело в формате OpenAI (`error.message`). `401` — ключ неизвестен, отключён или ему нечего тратить; `403` — запрос не помещается в остаток или модель не разрешена ключу; `503` — такой модели нет; `429` — частота. Повторять имеет смысл `429` и `5xx`. Ветвись по HTTP-коду, не по тексту.
- **Потоковый ответ:** `"stream": true` в обоих форматах, события SSE.
- **Тела запросов не хранятся** — ни в журнале, ни в детализации.


## Document Map

| Раздел | Описание | Строки |
|--------|----------|--------|
| Основное | Ключевые правила API | 13–23 |
| Частые задачи | Ссылки на самые нужные страницы | 38–49 |
| Просьбы без отдельного метода | Что делать, когда метода нет | 50–57 |
| SDK | Клиенты и как подключиться | 58–68 |
| Agent Skills | Скиллы для ИИ-агентов | 69–82 |
| Руководства | Страницы-руководства (Markdown по `.md`) | 83–93 |
| API-методы | Все эндпоинты, сгруппированы по разделам | 94–105 |
| Дополнительно | Спецификации, коллекции, ссылки | 106–113 |

## Частые задачи

- [Первый запрос за три шага](https://vcpay.ru/ai/docs/guides/quick-start.md)
- [Запрос в формате OpenAI](https://vcpay.ru/ai/docs/api/inference/chat-completions.md)
- [Запрос в формате Anthropic](https://vcpay.ru/ai/docs/api/inference/messages.md)
- [Модели и цены](https://vcpay.ru/ai/docs/api/models.md)
- [Остаток и потолок ключа](https://vcpay.ru/ai/docs/api/key/balance.md)
- [Расход ключа](https://vcpay.ru/ai/docs/api/key/stats.md)
- [Ошибки и что с ними делать](https://vcpay.ru/ai/docs/api/errors.md)
- [Подключить Claude Code, Cursor, SDK](https://vcpay.ru/ai/docs/guides/compatibility.md)
- [Как считается счёт](https://vcpay.ru/ai/docs/guides/billing.md)

## Просьбы без отдельного метода

Эти задачи закрываются тем, что уже есть:

- **Выпустить, отключить или удалить ключ** — только в кабинете (Компания → AI API); методов управления ключами в API нет.
- **Пополнить счёт** — в кабинете компании, по счёту или СБП; `GET /v1/vcpay/balance` только показывает остаток.
- **Получить тексты прошлых запросов** — невозможно: тела запросов и ответов не хранятся.

## SDK

Своих SDK нет — работают штатные пакеты. Отличается только адрес.

| Язык | Пакет | Адрес |
|------|-------|-------|
| Python | `openai` | `base_url="https://llm.vcpay.ru/v1"` |
| Node.js | `openai` | `baseURL: "https://llm.vcpay.ru/v1"` |
| Python | `anthropic` | `base_url="https://llm.vcpay.ru"` — без `/v1` |
| Claude Code | — | `ANTHROPIC_BASE_URL=https://llm.vcpay.ru`, `ANTHROPIC_AUTH_TOKEN=<KEY>` |

## Agent Skills

Скиллы для ИИ-агентов (Claude Code, Cursor и др.):

| Скилл | Описание |
|-------|---------|
| vcpay-ai-inference | AI API VCPay — запросы к моделям Claude, Gemini и GPT в форматах OpenAI (POST /v1/chat/completions) и Anthropic (POST /v1/messages), список моделей и цены в рублях |
| vcpay-ai-key | AI API VCPay — остаток лицевого счёта и бюджет ключа (GET /v1/vcpay/balance), настройки ключа (GET /v1/vcpay/key) и его расход за сутки и 30 дней (GET /v1/vcpay/stats) |
| vcpay-ai | AI API VCPay — шлюз к Claude, Gemini и GPT по одному ключу, совместимый с OpenAI API и Anthropic API |

Индекс скиллов: `https://vcpay.ru/ai/docs/.well-known/skills/index.json`

Каталог API (RFC 9727): `https://vcpay.ru/ai/docs/.well-known/api-catalog` — один JSON со всеми описаниями API, доками (HTML, llms.txt) и метаданными.

## Руководства
- [Обзор](https://vcpay.ru/ai/docs/index.md): AI API VCPay для разработчиков: Claude, Gemini и GPT по одному ключу, оплата по счёту в рублях, совместимость с OpenAI API и Anthropic API
- [Быстрый старт](https://vcpay.ru/ai/docs/guides/quick-start.md): Первый запрос к AI API VCPay за три шага — ключ, адрес, вызов.
- [Ключи доступа](https://vcpay.ru/ai/docs/guides/keys.md): Как выпустить, ограничить, отключить и удалить ключ AI API VCPay.
- [Совместимость и инструменты](https://vcpay.ru/ai/docs/guides/compatibility.md): OpenAI SDK, Anthropic SDK, Claude Code и Cursor поверх AI API VCPay.
- [Оплата и детализация](https://vcpay.ru/ai/docs/guides/billing.md): Как устроены деньги в AI API VCPay — предоплата, списание, отчёт.
- [Границы продукта](https://vcpay.ru/ai/docs/guides/scope.md): Что AI API VCPay делает, чего не делает и о чём стоит знать заранее.
- [Основы API, Обзор](https://vcpay.ru/ai/docs/api/overview.md): Обзор AI API VCPay: адрес https://llm.vcpay.ru/v1, авторизация ключом из кабинета, запросы в форматах OpenAI и Anthropic, каталог с ценами и самоосмотр ключа
- [Основы API, Ошибки](https://vcpay.ru/ai/docs/api/errors.md): Что означает отказ AI API VCPay и что с ним делать.
- [Основы API, Модели](https://vcpay.ru/ai/docs/api/models.md): Какие модели доступны в AI API VCPay, каким именем их вызывать и сколько они стоят.

## Inference
- [Ответ модели в формате OpenAI](https://vcpay.ru/ai/docs/api/inference/chat-completions.md): POST /v1/chat/completions
- [Ответ модели в формате Anthropic](https://vcpay.ru/ai/docs/api/inference/messages.md): POST /v1/messages

## Catalog
- [Каталог моделей с ценами ₽ за 1 млн токенов](https://vcpay.ru/ai/docs/api/catalog/models.md): GET /v1/vcpay/models

## Key
- [Остаток счёта и потолок этого ключа](https://vcpay.ru/ai/docs/api/key/balance.md): GET /v1/vcpay/balance
- [Как устроен этот ключ](https://vcpay.ru/ai/docs/api/key/info.md): GET /v1/vcpay/key
- [Расход этого ключа](https://vcpay.ru/ai/docs/api/key/stats.md): GET /v1/vcpay/stats

## Дополнительно
- OpenAPI 3.0 spec: `https://vcpay.ru/ai/docs/openapi.yaml` — машиночитаемая спецификация API для кодогенерации и инструментов
- Postman collection: `https://vcpay.ru/ai/docs/vcpay-ai.postman_collection.json` — готовая коллекция для импорта в Postman/Bruno/Insomnia
- [Agent Skill](https://vcpay.ru/ai/docs/skill.md): Описание API для ИИ-агентов (SKILL.md)
- [Кабинет: выпуск ключа](https://vcpay.ru/dashboard/company/ai)
- [Веб-сайт](https://vcpay.ru/)

____