> Краткое содержание: Первый запрос к AI API VCPay за три шага — ключ, адрес, вызов.
> Это Markdown-версия конкретной страницы. Для контекста за её пределами (правила API, полный перечень методов, авторизация) ОБЯЗАТЕЛЬНО открой [llms.txt](https://vcpay.ru/ai/docs/llms.txt) перед ответом — это сэкономит токены и предотвратит неполный ответ.


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

Три шага: получить ключ, подставить адрес, сделать запрос. Менять код интеграции не нужно — наш API совместим с OpenAI API и с Anthropic API.

## Шаг 1. Получите ключ

Ключи выпускаются в личном кабинете: [Кабинет → Компания → AI API](https://vcpay.ru/dashboard/company/ai). Нажмите «Создать ключ», дайте ему понятное имя и при желании поставьте потолок расхода.

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


## Шаг 2. Возьмите адрес

```text
https://llm.vcpay.ru/v1
```

Это точка входа, совместимая с OpenAI API. Она же принимает запросы в формате Anthropic — см. [Совместимость](https://vcpay.ru/ai/docs/guides/compatibility).

## Шаг 3. Сделайте запрос

```bash
curl https://llm.vcpay.ru/v1/chat/completions \
  -H "Authorization: Bearer ВАШ_КЛЮЧ" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-5",
    "messages": [{"role": "user", "content": "Привет! Ответь одним словом."}]
  }'
```

Ответ приходит в привычном формате (здесь и далее ответы приведены сокращённо — мы показываем только те поля, которые нужны):

```json
{
  "object": "chat.completion",
  "model": "claude-sonnet-5",
  "choices": [
    {"index": 0, "finish_reason": "stop", "message": {"role": "assistant", "content": "Привет!"}}
  ],
  "usage": {"prompt_tokens": 12, "completion_tokens": 3, "total_tokens": 15}
}
```

> **Внимание:** **Считайте `completion_tokens`, а не длину ответа.** У моделей с размышлениями — а у Claude Opus они включены по умолчанию — модель думает перед ответом, и эти токены тарифицируются как выход. Исходящих токенов на запрос будет заметно больше, чем видно по тексту. Это не ошибка счёта: подробнее — [Оплата и детализация](https://vcpay.ru/ai/docs/guides/billing).


## То же самое на Python

Работает штатный пакет `openai` — отличается только `base_url`:

```python
from openai import OpenAI

client = OpenAI(
    api_key="ВАШ_КЛЮЧ",
    base_url="https://llm.vcpay.ru/v1",
)

response = client.chat.completions.create(
    model="claude-sonnet-5",
    messages=[{"role": "user", "content": "Привет! Ответь одним словом."}],
)
print(response.choices[0].message.content)
```

## Что дальше

- [Ключи доступа](https://vcpay.ru/ai/docs/guides/keys) — потолки, ограничение по моделям, отключение.
- [Модели](https://vcpay.ru/ai/docs/api/models) — какие имена доступны.
- [Ошибки](https://vcpay.ru/ai/docs/api/errors) — что означает отказ и что с ним делать.
- [Справочник: ответ модели](https://vcpay.ru/ai/docs/api/inference/chat-completions) — все поля запроса и ответа.