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

Начальный

API позволяет вашей программе общаться с Claude. К концу этого урока вы выполните настоящий запрос и будете точно понимать, что делает каждая его часть.

What you'll learn

Создать API-ключ и безопасно сохранить его как переменную окружения
Установить официальный SDK для Python или TypeScript (или использовать обычный cURL)
Отправить свой первый запрос messages и прочитать ответ Claude
Понять четыре основных поля: model, max_tokens, messages и system

Весь путь в три шага

Всё описанное ниже укладывается в одну простую последовательность. Держите эту карту в голове по ходу дела.

Guided walkthrough1 of 3

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

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

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

Экспортируйте свой API-ключ

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

Watch out

Никогда не коммитьте свой ключ. Храните ключи в переменных окружения или в менеджере секретов, никогда в системе контроля версий. См. страницу Безопасность (/docs/security).

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

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

Python
TypeScript
cURL

Установка (Python)

pip install anthropic

Установка (TypeScript)

npm install @anthropic-ai/sdk

Устанавливать ничего не нужно — вам понадобится только curl.

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

Каждый запрос — это список messages. Модель отвечает полем content. Запустите фрагмент кода для своего языка, и вы увидите, как Claude отвечает на вопрос.

Python
TypeScript
cURL

import anthropic

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

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

print(message.content[0].text)

import Anthropic from "@anthropic-ai/sdk";

const client = new Anthropic(); // reads ANTHROPIC_API_KEY from the environment

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

console.log(message.content[0].text);

curl https://api.anthropic.com/v1/messages \
  --header "x-api-key: $ANTHROPIC_API_KEY" \
  --header "anthropic-version: 2023-06-01" \
  --header "content-type: application/json" \
  --data '{
    "model": "claude-sonnet-5",
    "max_tokens": 1024,
    "messages": [
      {"role": "user", "content": "In one sentence, what is an API?"}
    ]
  }'

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

Вы отправили четыре фрагмента информации. Вот что контролирует каждый из них:

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

Четыре основных поля

Нажмите Enter или пробел, чтобы перевернуть карточку. Используйте стрелки влево и вправо для перехода между карточками.Показан термин.

1 / 4

Pro tip

Поскольку API не сохраняет состояние, многоходовой чат — это просто растущий массив messages: добавляйте каждый ответ и заново отправляйте полный список при следующем вызове.

Проверьте себя

0/3

Что контролирует max_tokens?
Как продолжить многоходовой диалог через API?
Где должен храниться ваш API-ключ?

Key takeaways

Три шага: получить ключ, установить SDK, отправить запрос messages.
Храните ключ в ANTHROPIC_API_KEY, чтобы SDK считывал его автоматически и он никогда не попадал в ваш код.
Запрос — это список messages; ответ возвращается в content.
API не сохраняет состояние: отправляйте всю историю диалога заново, чтобы продолжить чат.
model, max_tokens, messages и system — это поля, к которым вы обратитесь в первую очередь.

Выберите подходящую модель и оцените стоимость → Выбор модели · Токены и стоимость
Стримьте ответы и ведите диалог → Стриминг и многоходовые диалоги
Позвольте Claude вызывать ваши функции → Использование инструментов
Готовые к продакшену сниппеты → Сниппеты API

Весь путь в три шага​

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

Экспортируйте свой API-ключ

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

Установка (Python)

Установка (TypeScript)

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

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