Claude API: как получить ключ, цены за токены и подключение

Claude API — программный доступ к моделям Anthropic: ваше приложение отправляет запрос на api.anthropic.com, получает ответ модели и платит только за обработанные токены, без абонентской платы. Ключ выдаётся в консоли Claude Platform на platform.claude.com — там же документация, в том числе на русском. Что умеет сама Claude нейросеть, разобрано в общем обзоре. Ниже — как получить API-ключ, первый запрос на curl и Python, актуальные на октябрь 2026 года цены за токены, лимиты по тирам и способы уменьшить счёт.

Claude API и подписка: два разных продукта

Подписка Pro или Max на claude.ai и API — независимые счета. Подписка даёт чат, приложения и Claude Code с лимитами по времени, но не включает оплату API. API-организация в консоли, в свою очередь, не расширяет лимиты подписки. Оплата API — по факту использования за месяц, в долларах США, картой или по счёту для корпоративных клиентов.

Через API доступны все актуальные модели, а также инструменты: веб-поиск, загрузка страниц, исполнение кода, работа с файлами и PDF, вызов собственных функций, пакетная обработка и кэш промптов. Те же модели продаются через Amazon Bedrock, Google Cloud, Microsoft Foundry и Claude Platform on AWS, но там счёт выставляет облачный провайдер или маркетплейс.

Как получить API-ключ Claude

Ключ создаётся в Claude Console — бывшей console.anthropic.com, которая теперь живёт на platform.claude.com. По официальной инструкции:

1. Войдите на platform.claude.com или создайте аккаунт.
2. Откройте Settings → API keys.
3. Нажмите Create key, задайте имя, срок действия и привязку — к себе или к сервисному аккаунту. При желании ограничьте ключ одним рабочим пространством.
4. Скопируйте ключ: он начинается с sk-ant- и показывается полностью только один раз. Потерянный ключ восстановить нельзя, только выпустить новый.

Типы ключей:

• персональный — действует от вашего имени и перестаёт работать, если вы покидаете организацию; подходит для разработки;
• ключ сервисного аккаунта — для CI, продакшн-сервисов и агентов;
• ключ рабочего пространства — устаревший тип без владельца, Anthropic рекомендует вместо него два первых.

Новым пользователям, по странице цен, на баланс зачисляется небольшая бесплатная сумма для проверки API. Дальше баланс пополняется картой в разделе Billing. Ключ нельзя передавать другим людям: это прямо запрещено условиями Anthropic.

Первый запрос: curl и Python

Сохраните ключ в переменной окружения — официальные SDK читают ANTHROPIC_API_KEY автоматически:

export ANTHROPIC_API_KEY="sk-ant-api03-..."

Запрос через curl к Messages API, пример из быстрого старта:

curl https://api.anthropic.com/v1/messages \
  -H "content-type: application/json" \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "claude-opus-5-5",
    "max_tokens": 1000,
    "messages": [
      {"role": "user", "content": "Привет, Claude! Что ты умеешь?"}
    ]
  }'

То же на Python после pip install anthropic:

import anthropic

client = anthropic.Anthropic()

message = client.messages.create(
    model="claude-opus-5-5",
    max_tokens=1000,
    messages=[{"role": "user", "content": "Привет, Claude! Что ты умеешь?"}],
)

for block in message.content:
    if block.type == "text":
        print(block.text)

Обязательные параметры — model, max_tokens и messages. В ответе API возвращает JSON с текстом и объектом usage, где указано, сколько входных и выходных токенов ушло на запрос: по нему и считается стоимость. Официальные SDK есть для Python, TypeScript, Java, Go, C#, PHP и Ruby, а для терминала — утилита ant.

Если ответ нужен строго на русском, задайте язык в системном промпте, например "system": "Всегда отвечай на русском языке.". Документация советует так делать в продакшне, а не полагаться на автоматическое определение языка.

Цены Claude API по токенам

Цены указаны в долларах за миллион токенов (MTok), отдельно за вход и выход. Актуальные модели по странице тарифов и документации на 3 октября 2026 года:

Модель	ID в API	Вход	Выход	Чтение из кэша	Контекст
Claude Fable 5.1	claude-fable-5-1	10 $	50 $	0,25 $	1 млн
Claude Opus 5.5	claude-opus-5-5	4 $	20 $	0,20 $	1 млн
Claude Sonnet 5.5	claude-sonnet-5-5	2 $	10 $	0,20 $	1 млн
Claude Haiku 4.5	claude-haiku-4-5	1 $	5 $	0,10 $	200 тыс.

Claude Mythos 5.1 стоит как Fable 5.1, но выдаётся только по приглашению. Предыдущие модели остаются в API: Opus 5 и Opus 4.5–4.8 — 5 $ и 25 $, Sonnet 5 — 2 $ и 10 $ (вводная цена стала постоянной, повышения до 3 $ и 15 $ не будет), Sonnet 4.5 и 4.6 — 3 $ и 15 $.

Дополнительные тарифы:

• быстрый режим Opus 5.5 — 8 $ и 40 $ за MTok, исследовательская версия, только в Claude API;
• веб-поиск — 10 $ за 1000 поисков плюс токены найденного контента; загрузка страниц (web fetch) — без доплаты сверх токенов;
• исполнение кода — бесплатно вместе с веб-поиском или web fetch, иначе 1550 бесплатных часов в месяц на организацию и далее 0,05 $ за час на контейнер;
• длинный контекст — у моделей начиная с поколения 4.6 окно в 1 млн токенов идёт по обычной цене: запрос на 900 тыс. токенов тарифицируется по той же ставке, что и на 9 тыс.;
• размещение только в США (inference_geo: "us") — множитель 1,1 ко всем ставкам.

Выход в пять раз дороже входа у всех актуальных моделей, поэтому длинные ответы дорожают быстрее длинных промптов. Ограничивайте ответ параметром max_tokens, если полный текст не нужен.

Токены: что это и сколько стоит запрос

Токен — фрагмент текста, с которым работает модель. По документации, в английском один токен в среднем равен примерно 4 символам или 0,75 слова; для других языков точное соотношение зависит от языка и содержимого. Официального коэффициента для русского Anthropic не публикует.

Важная деталь: Claude Opus 4.7 и более новые модели, включая Opus 5.5, Sonnet 5.5 и Fable 5.1, используют новый токенизатор, который на тот же текст даёт примерно на 30% больше токенов, чем модели до него. Поэтому подсчёты, сделанные на старых моделях, для оценки бюджета не годятся. На текущем токенизаторе 1 млн токенов — это примерно 2,5 млн символов Юникода.

Точное число токенов до отправки даёт эндпоинт /v1/messages/count_tokens: он принимает тот же запрос, что и Messages API, и возвращает input_tokens. Подсчёт бесплатный, у него отдельный лимит запросов в минуту. Если нужно просто задать модели пару вопросов без ключа и кода, проще открыть ИИ онлайн в браузере.

Формула счёта: стоимость = входные токены × цена входа + выходные токены × цена выхода, делённое на миллион. Пример для Sonnet 5.5: запрос на 10 000 входных и 2000 выходных токенов стоит 10 000 × 2 $ / 1 млн + 2000 × 10 $ / 1 млн = 0,02 $ + 0,02 $ = 0,04 $.

Во входные токены идёт всё, что модель читает: системный промпт, история диалога, описания инструментов, файлы и результаты поиска. При использовании инструментов API добавляет служебный системный промпт — у Opus 5.5 и Sonnet 5.5 это 286 токенов. В многоходовом диалоге каждая реплика заново отправляет всю историю, поэтому без кэша стоимость растёт с длиной разговора. Расход по моделям и ключам видно на странице Usage в консоли.

Лимиты API: тиры, rate limits и потолок трат

Лимиты задаются на уровне организации и зависят от тира. Организацию переводят на тир автоматически по истории использования; новые аккаунты могут начинать с ознакомительного уровня с пониженными лимитами. По документации о лимитах:

Тир	Потолок трат в месяц	Opus 5.5 и Sonnet 5.5: запросов в минуту	Входных токенов в минуту	Выходных токенов в минуту
Start	500 $	1000	2 млн	400 тыс.
Build	1000 $	5000	5 млн	1 млн
Scale	200 000 $	10 000	10 млн	2 млн

У Fable 5.x лимиты ниже: на Start — 1000 запросов, 500 тыс. входных и 100 тыс. выходных токенов в минуту. Выше Scale есть индивидуальный тир по договорённости с отделом продаж, без месячного потолка трат.

Как это работает на практике:

• лимит пополняется непрерывно по алгоритму token bucket, а не сбрасывается раз в минуту, поэтому 60 запросов в минуту могут применяться как один в секунду;
• при превышении API отвечает ошибкой 429 с заголовком retry-after — сколько секунд подождать;
• при достижении месячного потолка тира запросы останавливаются до 00:00 UTC первого числа следующего месяца, если не повысить тир раньше;
• токены, прочитанные из кэша, у актуальных моделей не входят в лимит входных токенов в минуту, поэтому кэш фактически поднимает пропускную способность.

Собственный лимит трат ниже потолка тира задаётся в Settings → Billing, лимиты отдельных рабочих пространств — в настройках workspace. Повысить тир можно кнопкой Request rate limit increase на странице Rate limits.

Как снизить стоимость API: кэш, батчи и выбор модели

Anthropic называет четыре рычага: подходящая модель, кэш промптов, пакетная обработка и контроль расхода. Скидки суммируются: кэш и Batch API можно использовать одновременно.

Кэширование промптов. Повторяющийся префикс запроса — системный промпт, документ, описания инструментов — записывается в кэш, а следующие запросы читают его со скидкой. Запись в кэш на 5 минут стоит 1,25 базовой цены входа, на час — 2. Чтение стоит 10% базовой цены, у Opus 5.5 — 5% (0,20 $ за MTok), у Fable 5.1 и Mythos 5.1 — 2,5% (0,25 $). Пятиминутный кэш окупается уже на первом чтении. Включить его можно одним полем cache_control на верхнем уровне запроса — тогда API сам расставляет точки кэша. Подробный расчёт экономии — в разборе кэширования промптов в Claude API.

Batch API. Асинхронная обработка больших наборов запросов со скидкой 50% на вход и выход: Opus 5.5 в батче стоит 2 $ и 10 $, Sonnet 5.5 — 1 $ и 5 $, Haiku 4.5 — 0,50 $ и 2,50 $. Подходит для несрочных задач: разметка данных, классификация, массовая генерация. Быстрый режим с батчами не совмещается.

Выбор модели. Официальная рекомендация — Haiku для простых задач, Sonnet для большинства продакшн-нагрузок, Opus для самых сложных рассуждений. Haiku 4.5 в четыре раза дешевле Opus 5.5 на входе. Пример из документации: 10 000 обращений в поддержку по 3700 токенов на Haiku 4.5 обходятся примерно в 37 $. Сравнение моделей по возможностям — в гайде по моделям Claude.

Контроль расхода. Ограничивайте max_tokens, считайте токены заранее через count_tokens, ставьте лимит трат на организацию и рабочие пространства. Для крупных объёмов Anthropic обсуждает индивидуальные скидки через отдел продаж.

Сравнение API с подписками Pro и Max по деньгам и сценариям — в разборе цен и лимитов Claude.

Частые вопросы

Есть ли у Claude API бесплатный доступ?

Постоянного бесплатного тарифа нет, оплата идёт по токенам. Новым пользователям на баланс зачисляется небольшая бесплатная сумма для проверки API, а подсчёт токенов через count_tokens бесплатен.

Даёт ли подписка Claude Pro доступ к API?

Нет. Подписка на claude.ai и API-организация в консоли — отдельные продукты с отдельной оплатой. Подписка не оплачивает запросы к API, а API не расширяет лимиты подписки.

Сколько токенов помещается в контекст Claude?

У Fable 5.1, Opus 5.5 и Sonnet 5.5 окно 1 млн токенов, у Haiku 4.5 — 200 тыс. Максимальный ответ — 128 тыс. токенов у старших моделей и 64 тыс. у Haiku 4.5.

Что делать при ошибке 429?

Это превышение лимита запросов или токенов в минуту. Подождите столько секунд, сколько указано в заголовке retry-after, и наращивайте нагрузку плавно. Если 429 пришёл без retry-after, исчерпан месячный потолок трат тира.

Какую модель брать для старта?

Anthropic рекомендует начинать с Claude Opus 5.5 для большинства задач и переходить на Fable 5.1, когда нужны предельно глубокие рассуждения. Для массовых простых запросов дешевле Haiku 4.5.