> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ruapi.ai/llms.txt
> Use this file to discover all available pages before exploring further.

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

> От регистрации до первого запроса к LLM за 5 минут

Этот гайд проведёт вас от пустого экрана до первого успешного запроса к OpenAI / Claude / Gemini через RuAPI.

<Tip>
  **Base URL** — в клиенте достаточно заменить только это (нажмите значок в правом верхнем углу блока, чтобы скопировать):

  **OpenAI-совместимый** · Cursor / Cline / Codex / OpenAI SDK — с `/v1`

  ```bash theme={null}
  https://www.ruapi.ai/v1
  ```

  **Anthropic** · Claude Code / Anthropic SDK — без `/v1`

  ```bash theme={null}
  https://www.ruapi.ai
  ```

  ⚠️ Для Anthropic адрес **без** `/v1` — SDK сам добавляет `/v1/messages`, лишний `/v1` приведёт к 404.
</Tip>

## Шаг 1. Регистрация

Откройте [www.ruapi.ai](https://www.ruapi.ai) и нажмите **«Регистрация»**.
Введите email, пароль и код подтверждения, который придёт на почту.

<Tip>
  Не получили письмо? Проверьте папку «Спам». Если и там нет — напишите на
  [support@ruapi.ai](mailto:support@ruapi.ai).
</Tip>

## Шаг 2. Пополнение баланса (USDT / USDC или картой)

После входа перейдите в **«Кошелёк»** и выберите сумму для пополнения.
Минимум — **5 \$** (в USDT / USDC или картой).

<Warning>
  USDT или USDC отправляйте **только через ту сеть, которую вы выбрали** на странице оплаты
  (TRC20 / BEP20 / Polygon). Перевод по другой сети приведёт к **необратимой потере средств**.
</Warning>

После подтверждения транзакции в блокчейне (обычно 1–5 минут) баланс обновится автоматически.

## Шаг 3. Создание API ключа

В Консоли перейдите в **«Токены»** → **«Создать токен»**.

* **Имя**: любое — для удобства, например `local-dev`.
* **Срок действия**: оставьте «Без ограничения», если не нужен другой.
* **Лимит расхода**: можно ограничить токен суммой в USD.

Скопируйте полученный ключ — он начинается с `sk-...`. Сохраните его в надёжном месте; при необходимости ключ всегда можно посмотреть снова на странице **«Токены»** в Консоли.

## Шаг 4. Базовый адрес (base\_url)

RuAPI поддерживает **два протокола**, и адрес для них **разный** — это главное место, где можно ошибиться:

| Протокол               | Что подставлять в `base_url`             | Кто использует                   |
| ---------------------- | ---------------------------------------- | -------------------------------- |
| **OpenAI-совместимый** | `https://www.ruapi.ai/v1`  ← **с `/v1`** | Cursor, Cline, Codex, OpenAI SDK |
| **Anthropic**          | `https://www.ruapi.ai`  ← **без `/v1`**  | Claude Code, Anthropic SDK       |

<Warning>
  Для Anthropic **не добавляйте** `/v1` в конце адреса. SDK сам подставляет
  `/v1/messages`, и лишний `/v1` приведёт к ошибке **404**. Подробнее — в гайдах
  [Claude Code](/ru/integrations/claude-code) и [Codex](/ru/integrations/codex).
</Warning>

## Шаг 5. Первый запрос

Пример для OpenAI-совместимого протокола — используйте любой удобный OpenAI SDK, заменив `base_url`:

<CodeGroup>
  ```python Python (OpenAI SDK) theme={null}
  from openai import OpenAI

  client = OpenAI(
      api_key="sk-ВАШ_КЛЮЧ",
      base_url="https://www.ruapi.ai/v1",
  )

  response = client.chat.completions.create(
      model="claude-opus-4-8",  # точные имена — на www.ruapi.ai
      messages=[{"role": "user", "content": "Привет!"}],
  )

  print(response.choices[0].message.content)
  ```

  ```javascript Node.js (OpenAI SDK) theme={null}
  import OpenAI from "openai";

  const client = new OpenAI({
    apiKey: "sk-ВАШ_КЛЮЧ",
    baseURL: "https://www.ruapi.ai/v1",
  });

  const response = await client.chat.completions.create({
    model: "claude-opus-4-8", // точные имена — на www.ruapi.ai
    messages: [{ role: "user", content: "Привет!" }],
  });

  console.log(response.choices[0].message.content);
  ```

  ```bash curl theme={null}
  curl https://www.ruapi.ai/v1/chat/completions \
    -H "Authorization: Bearer sk-ВАШ_КЛЮЧ" \
    -H "Content-Type: application/json" \
    -d '{
      "model": "claude-opus-4-8",
      "messages": [{"role": "user", "content": "Привет!"}]
    }'
  ```
</CodeGroup>

## Шаг 6. Смена модели

Чтобы переключить модель, измените поле `model`. Доступные имена — на [www.ruapi.ai](http://www.ruapi.ai).

```python theme={null}
model="claude-opus-4-8"  # точные имена — на www.ruapi.ai
```

Полный список доступных моделей — на странице **«Цены»** на [www.ruapi.ai](https://www.ruapi.ai).

## Что дальше

* [Цены и расход баланса](/ru/pricing) — как считается стоимость каждого запроса
* Возникли вопросы? [support@ruapi.ai](mailto:support@ruapi.ai)