> ## 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.

# Claude API: линейки, версии и подключение

> Линейки Claude — Haiku, Sonnet, Opus — и флагман Claude Fable 5: чем отличаются, как читать номера версий (claude-fable-5, claude-opus-5, claude-sonnet-5) и как подключить по OpenAI-совместимому протоколу.

Claude от Anthropic — семейство моделей, которое особенно ценят за код, агентов и работу с длинными документами. Все модели говорят по OpenAI-совместимому протоколу, поэтому подключаются любым OpenAI SDK — достаточно поменять `base_url`. Ниже — как устроены три линейки, как читать номера версий и как отправить первый запрос.

## Три линейки: Haiku, Sonnet, Opus

У Claude три именованные линейки. Различие простое: чем «выше» линейка, тем модель мощнее, но медленнее и дороже.

| Линейка    | Для чего лучше всего                                                          | Относительная цена |
| ---------- | ----------------------------------------------------------------------------- | ------------------ |
| **Haiku**  | Быстрые массовые задачи: классификация, теги, короткие ответы на потоке       | Самая дешёвая      |
| **Sonnet** | Универсал на каждый день: код, анализ, длинный контекст                       | Средняя            |
| **Opus**   | Самое сложное: тяжёлый рефакторинг, многошаговые агенты, глубокие рассуждения | Премиум            |

<Tip>
  Не уверены — начинайте с **Sonnet** (актуальный — `claude-sonnet-5`). Он закрывает большинство задач. На **Opus** переходите, когда Sonnet перестаёт справляться со сложностью; на **Haiku** — когда важнее скорость и цена, чем максимальное качество.
</Tip>

## Как читать номера версий

В ID зашиты и линейка, и поколение, например `claude-sonnet-5` или `claude-opus-5`. Правило одно: **чем больше число, тем новее и мощнее модель** в пределах своей линейки.

* `claude-haiku-4-5-20251001` — быстрая линейка Haiku. У части снапшотов в ID есть суффикс с датой релиза, как здесь.
* `claude-sonnet-4-5-20250929`, `claude-sonnet-4-6`, `claude-sonnet-5` — линейка Sonnet; `-5` новее, чем `-4-6`, а `-4-6` новее, чем `-4-5`.
* `claude-opus-4-5-20251101`, `claude-opus-4-6`, `claude-opus-4-7`, `claude-opus-4-8`, `claude-opus-5` — линейка Opus; `claude-opus-5` — самое новое поколение, оно новее всей ветки `4-x`.
* `claude-fable-5` — **Fable**, отдельный флагман поверх линеек (см. ниже); в числовую лестницу он не входит.

Сравнивать номера между линейками смысла нет: `opus-4-8` мощнее `sonnet-5` не из-за числа, а потому что это линейка Opus.

<Note>
  Точные актуальные ID, версии и цены за токен — на странице **«Цены»** на [www.ruapi.ai](https://www.ruapi.ai). Имена совпадают с официальными у Anthropic, новые версии появляются в каталоге автоматически.
</Note>

## Claude Fable 5 — флагман

`claude-fable-5` — самая способная общедоступная модель Anthropic, созданная для самых тяжёлых рассуждений и длинных агентных задач: крупные миграции, сложные многошаговые реализации, агенты, которые держат задачу часами. Окно контекста — **1M токенов**; на трудных длинных задачах по коду и анализу Fable обходит линейку Opus, хотя на коротких и чётко очерченных задачах Opus держится рядом и стоит дешевле.

**Fable или Opus?** `claude-fable-5` берите на самое сложное: большие рефакторинги, многодневные агенты, глубокую аналитику. Для повседневного кода и чата `claude-opus-5` быстрее и примерно вдвое дешевле. Fable — в верхней части ценового диапазона; точную цену за токен смотрите на странице [«Цены»](https://www.ruapi.ai).

<Note>
  У Fable 5 есть классификаторы безопасности, которые отклоняют небольшую долю запросов (кибербезопасность, биология и химия, дистилляция моделей). Отклонённый запрос приходит обычным ответом HTTP `200` с `stop_reason: "refusal"`. Это не ошибка, поэтому предусмотрите обработку такого случая на клиенте. У Haiku, Sonnet и Opus такого поведения нет.
</Note>

## В чём Claude силён

* **Код** — написание, рефакторинг и отладка; одна из сильнейших сторон семейства, особенно у Sonnet и Opus.
* **Агенты и вызов инструментов** — модель возвращает структурированные вызовы функций, на которых строятся агенты и пайплайны (пример — в [вызове функций](/ru/function-calling)).
* **Длинные документы** — большое окно контекста вмещает целые кодовые базы и длинные тексты.
* **Vision** — на вход можно подавать изображения: скриншоты, диаграммы, сканы (как это делать в коде — в гайде по [работе с изображениями](/ru/vision)).

## Подключение Claude

`base_url` всегда `https://www.ruapi.ai/v1`. Возьмите любой OpenAI SDK и подставьте ID модели в поле `model`:

```python theme={null}
from openai import OpenAI

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

resp = client.chat.completions.create(
    model="claude-sonnet-5",  # или claude-fable-5 для самых тяжёлых агентных задач
    messages=[{"role": "user", "content": "Привет!"}],
)
print(resp.choices[0].message.content)
```

Пошаговая настройка ключа, `base_url` и первый запрос на Python и curl — в [Быстром старте](/ru/quickstart). Для длинных ответов удобен [потоковый вывод](/ru/streaming). Ключ и баланс — на странице [пополнения](/ru/topup).

## Дальше

<CardGroup cols={2}>
  <Card title="Подключение и первый запрос" icon="bolt" href="/ru/quickstart">
    base\_url, ключ, код на Python и curl.
  </Card>

  <Card title="Модели GPT" icon="robot" href="/ru/gpt-api">
    Линейки OpenAI GPT: какую выбрать.
  </Card>

  <Card title="Модели Gemini" icon="sparkles" href="/ru/gemini-api">
    Google Gemini: линейки и возможности.
  </Card>
</CardGroup>
