Перейти к основному содержимому

Ваш первый вызов API

Начальный

API позволяет вашей программе общаться с Claude. Три шага: получить ключ, установить SDK, отправить сообщение.

1. Получите API-ключ

Создайте его в консоли Anthropic. Затем задайте его как переменную окружения, чтобы он никогда не оказывался в вашем коде:

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

:::warning Никогда не коммитьте свой ключ Храните ключи в переменных окружения или в менеджере секретов — никогда в системе контроля версий. См. Безопасность. :::

2. Установите SDK

pip install anthropic

3. Сделайте вызов

Каждый запрос — это список messages. Модель отвечает полем content.

import anthropic

client = anthropic.Anthropic() # reads ANTHROPIC_API_KEY from the environment

message = client.messages.create(
model="claude-sonnet-4-6",
max_tokens=1024,
messages=[
{"role": "user", "content": "In one sentence, what is an API?"}
],
)

print(message.content[0].text)

Что только что произошло

  • model — какой Claude использовать. Не прописывайте жёстко вслепую; см. Выбор модели.
  • max_tokens — ограничение длины ответа (в токенах). Оно не задаёт контекстное окно.
  • messages — диалог на текущий момент. API не сохраняет состояние: чтобы продолжить чат, отправляйте всю историю заново каждый раз.
  • system (необязательно) — инструкция верхнего уровня, задающая роль Claude для этого вызова.

Далее