> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apiyi.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Основы вызовов API Claude
> APIYI предоставляет двухканальный доступ через официальный релей к AWS Claude + Claude Official API примерно за 85% от прайс-листа, стабильно и по модели pay-as-you-go.
Основные моменты по каналам и тарификации:
* **Канал по умолчанию: AWS Claude** (официальный AWS Bedrock) — высокая стабильность, высокие показатели попадания в кэш.
* **Резервный канал: Claude Official** (прямой Anthropic API с официальными ключами) — автоматическое переключение при проблемах у канала AWS.
* **Оба канала — чистый официальный passthrough.** Оплата по факту использования, без лимита запросов, итоговая стоимость ≈ **85% от прайс-листа** (диапазон 79%–86% после суммирования бонусов за пополнение).
Мы не предоставляем дешевый доступ через reverse-engineering — **только надежное, стабильное качество и сервис**.
Рынок доступа к Claude довольно хаотичен, и чем ниже цена, тем обычно мутнее ситуация: в таких дешевых каналах вы не знаете, что туда подмешали — reverse-engineered хаки, общие аккаунты, упрощенные или незаметно подмененные модели. Хуже того, если ваши данные переписки перепродадут, вы об этом никогда не узнаете. APIYI использует только чистый официальный passthrough (AWS Bedrock + официальные ключи Anthropic): отслеживаемые каналы, без хранения данных. Мы лучше заплатим немного больше, но останемся стабильными и чистыми.
## Получите API-ключ
Создайте токены или управляйте ими в консоли:
`https://api.apiyi.com/token`
* **default token** работает сразу без дополнительных настроек.
* Если вы создадите новый token в **ClaudeCode group**, вы получите **скидку 5%** (95% от прайс-листа).
* Эта скидка группы **суммируется с бонусами пополнения 10%–20%**, снижая итоговую стоимость примерно до **79%–86% от прайс-листа** (заголовок «≈ 85%»).
* Нет лимита запросов, дешевле, чем на официальном сайте, и удобно в использовании.
Тарификация API осуществляется по факту использования (не ежемесячная подписка) — комиссии списываются в реальном времени с вашего предоплаченного баланса.
## Эндпоинты
| Элемент | Значение |
| --------------------------------- | ------------------------------------------- |
| **Базовый URL** | `https://api.apiyi.com` |
| **Нативный эндпоинт Anthropic** | `https://api.apiyi.com/v1/messages` |
| **Совместимый с OpenAI эндпоинт** | `https://api.apiyi.com/v1/chat/completions` |
## Доступные модели
Эти три — самые новые в каждой семье и рекомендуются для прямого использования:
| Семейство | Модель | Лучше всего подходит для |
| ---------- | --------------------------- | ------------------------------------------ |
| **Opus** | `claude-opus-4-8` | Сложная разработка, глубокое рассуждение |
| **Sonnet** | `claude-sonnet-4-6` | Общий интеллект, ежедневная работа с кодом |
| **Haiku** | `claude-haiku-4-5-20251001` | Быстрые ответы, высокая параллельность |
## Формат вызова: нативный vs совместимый с OpenAI
Мы поддерживаем **оба** формата: нативный Anthropic и совместимый с OpenAI — но выберите подходящий для вашего случая:
Эндпоинт: `/v1/messages`
**Если вы используете Claude Code, Cline, Cursor или любой клиент с упором на Claude, вам необходимо использовать нативный формат.**
Только нативный формат корректно активирует **кэширование промптов (cached billing)**, что значительно снижает стоимость при длинном контексте / повторяющихся system prompt.
Эндпоинт: `/v1/chat/completions`
Если ваш проект уже работает на OpenAI SDK и **вам не важна тарификация кэша**, вы можете перейти на Claude почти без затрат на миграцию.
Лучше всего подходит для разовых скриптов, легких нагрузок и устаревших проектов, привязанных к OpenAI SDK.
**Тарификация кэша работает только в нативном формате Anthropic.** При использовании в стиле Claude Code с высокой частотой и длинным контекстом OpenAI-compatible формат может привести к заметно более высоким счетам — это ограничение upstream-протокола, а не проблема APIYI.
Подробнее о том, как работает кэширование промптов и как его проверить, см. [Руководство по кэшированию промптов Claude](/ru/api-capabilities/claude-prompt-caching).
## Примеры
### Нативный формат Anthropic (рекомендуется)
```bash theme={null}
curl https://api.apiyi.com/v1/messages \
-H "x-api-key: your-apiyi-key" \
-H "anthropic-version: 2023-06-01" \
-H "content-type: application/json" \
-d '{
"model": "claude-sonnet-4-6",
"max_tokens": 1024,
"messages": [
{"role": "user", "content": "Hello, please introduce yourself."}
]
}'
```
```python theme={null}
import anthropic
client = anthropic.Anthropic(
api_key="your-apiyi-key",
base_url="https://api.apiyi.com"
)
message = client.messages.create(
model="claude-opus-4-8",
max_tokens=1024,
messages=[
{"role": "user", "content": "Write a Python quicksort example."}
]
)
print(message.content[0].text)
```
### Совместимый с OpenAI формат (для общих миграций)
```python theme={null}
from openai import OpenAI
client = OpenAI(
api_key="your-apiyi-key",
base_url="https://api.apiyi.com/v1"
)
response = client.chat.completions.create(
model="claude-sonnet-4-6",
messages=[
{"role": "user", "content": "Hello, please introduce yourself."}
]
)
print(response.choices[0].message.content)
```
## Примечание о тарификации Opus
**Opus сравнительно дорогой.** В повседневном использовании чата расходы умеренные, но в сценариях программирования с большим входным/выходным объемом token счет быстро растет. Мы рекомендуем начать с **\$10 тестового бюджета**, чтобы оценить реальное потребление перед тем, как принимать решение.
Рекомендации по повседневному использованию:
* **Большинство сценариев**: выбирайте `claude-sonnet-4-6` — лучшее соотношение цены и производительности.
* **Простые / высоконагруженные задачи**: используйте `claude-haiku-4-5-20251001` — быстро и недорого.
* **Сложное программирование / reasoning**: переходите на `claude-opus-4-8`.
## ЧЗВ
Потому что реальная цена «дешевизны» — это то, чего вы не видите. Хаки на основе reverse engineering, общие аккаунты, упрощенные или незаметно подмененные модели — все это может снизить цену, но вы не знаете, что именно было смешано в канале. Качество вывода будет нестабильным, сервис может исчезнуть в одночасье, а если ваши данные переписки перепродадут, вы этого даже не заметите.
Мы используем только **чистый официальный passthrough**: канал по умолчанию — официальный доступ AWS Bedrock, резервный — прямой Anthropic с официальными ключами; оба варианта можно отследить, оплата идет по факту использования, без сохранения ваших данных. Итоговая стоимость составляет примерно **85% от прайс-листа**, и мы считаем это правильной границей между «надежно и стабильно» и «по справедливой цене». Мы предпочтем стоить немного дороже, чем иметь дело с сомнительным, неотслеживаемым дешевым источником.
Это самая частая ошибка 400 при вызове Opus 4.7 / 4.8 через маршрут AWS (Bedrock). Полное сообщение выглядит так:
```
ValidationException: "thinking.type.enabled" is not supported for this model.
Use "thinking.type.adaptive" and "output_config.effort" to control thinking behavior.
```
**Причина**: тело запроса по-прежнему использует старый формат рассуждения с фиксированным бюджетом `thinking: { "type": "enabled", "budget_tokens": N }`. В Opus 4.7 / 4.8 он удален, и поддерживается только адаптивное рассуждение.
**Решение**: уберите `type: "enabled"` и `budget_tokens`, а для управления глубиной рассуждения используйте `thinking: { "type": "adaptive" }` + `output_config.effort`. Аналогично, `temperature` / `top_p` / `top_k` в этих моделях удалены, и при отправке вернут 400. См. [Руководство по Claude Effort & Thinking](/ru/api-capabilities/claude-effort-thinking).
## Связанные ссылки
* Получить / управлять token: `https://api.apiyi.com/token`
* Пополнение и акции: `https://api.apiyi.com`
* [Руководство по кэшированию промптов Claude](/ru/api-capabilities/claude-prompt-caching)