Anthropic API: как пользоваться Messages и SDK

Anthropic API — это программный доступ к моделям Claude: ключ в Console, переменная ANTHROPIC_API_KEY, endpoint Messages POST /v1/messages и официальный SDK (pip install anthropic). Фокус-ключ: anthropic api. Канон: Get started. Соседи: OpenAI API, PrivateGPT, LiteLLM, ИИ-автоматизация.

Ниже — маршрут новичка до первого ответа модели. Конкретный model id берите из актуальной доки/Console: линейки обновляются, в статье не закрепляем «вечный» id и рублевый прайс.

Способы вызова: что выбрать

Источник: docs.anthropic.com Get started (ANTHROPIC_API_KEY; POST https://api.anthropic.com/v1/messages; anthropic-version 2023-06-01; pip install anthropic; client.messages.create; max_tokens обязателен в примерах). Сверка: 2026-10-07. Model id и тарифы — Console/pricing, не ₽.

Первый вызов: cURL и Python

1. Создайте API key в Claude Console и экспортируйте ANTHROPIC_API_KEY.
2. Проверьте ключ cURL-запросом к /v1/messages с заголовками x-api-key и anthropic-version: 2023-06-01.
3. Для кода: venv → pip install anthropic → Anthropic().messages.create(...).
4. Укажите max_tokens и актуальный model из Console / доки; ответ разбирайте по блокам content типа text.

export ANTHROPIC_API_KEY="your-api-key-here"

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": "YOUR_MODEL_ID",
    "max_tokens": 1000,
    "messages": [
      {"role": "user", "content": "Дай 3 поисковых запроса про ВИЭ"}
    ]
  }'

# Python
python3 -m venv .venv && source .venv/bin/activate
pip install anthropic

import anthropic
client = anthropic.Anthropic()
message = client.messages.create(
    model="YOUR_MODEL_ID",
    max_tokens=1000,
    messages=[{"role": "user", "content": "Дай 3 поисковых запроса про ВИЭ"}],
)
for block in message.content:
    if block.type == "text":
        print(block.text)

Дальше по доке: multi-turn messages, system prompts, tools, structured outputs. Не смешивайте этот облачный контур с PrivateGPT: там Claude-style API над вашим локальным сервером, здесь — managed Claude у Anthropic.

Типичные ошибки

• Забыть max_tokens в Messages и ловить ошибку валидации.
• Путать подписку claude.ai и billing API Console.
• Хардкодить устаревший model id из блога без сверки с Console.
• Считать PrivateGPT «заменой» Anthropic cloud — это self-host layer, не те же веса моделей.
• Писать фиксированные ₽/1k токенов — только официальный pricing и ваш канал оплаты.

FAQ: Anthropic API

Вывод

Anthropic API — Messages на /v1/messages, ключ в env, официальный SDK. Старт: cURL smoke-test → pip install anthropic → один messages.create с актуальным model id. Когда нужна система обучения под интеграции — форматы на странице обучения.