Claude Platform Docs
Справочник APIИспользование API

Бета-заголовки

Получите доступ к экспериментальным функциям до того, как они станут частью стандартного API, с помощью заголовка anthropic-beta или параметра betas в SDK.

Бета-заголовки (beta headers) позволяют вам получить доступ к экспериментальным функциям и новым возможностям моделей до того, как они станут частью стандартного API.

Как использовать бета-заголовки

Чтобы получить доступ к бета-функциям, включите заголовок anthropic-beta в ваши запросы к API:

POST /v1/messages
x-api-key: YOUR_API_KEY
anthropic-version: 2023-06-01
anthropic-beta: BETA_FEATURE_NAME
content-type: application/json

В документации каждой функции указано точное имя бета-версии, которое нужно отправить. В обзоре API перечислены API, которые в настоящее время находятся в бета-версии.

Следующие примеры показывают один и тот же запрос с использованием cURL, CLI ant и SDK, на примере бета-версии редактирования контекста. SDK принимают имена бета-версий в параметре betas и отправляют заголовок anthropic-beta за вас:

client = Anthropic()

response = client.beta.messages.create(
    model="claude-opus-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hello, Claude"}],
    betas=["context-management-2025-06-27"],
)

print(response.content)

Несколько бета-функций

Чтобы использовать несколько бета-функций в одном запросе, включите все имена функций в заголовок, разделив их запятыми:

anthropic-beta: feature1,feature2,feature3

При использовании SDK перечислите каждую функцию в параметре betas (например, betas=["feature1", "feature2"]). В CLI передайте один флаг --beta с именами функций, разделёнными запятыми (например, --beta feature1,feature2). Избегайте повторения флага: в настоящее время действует только значение первого флага.

Заголовки для конкретных конечных точек

Некоторые бета-API ограничены конкретными конечными точками и требуют специфичного для функции бета-заголовка в каждом запросе:

Конечные точкиБета-заголовок
/v1/agents, /v1/sessions, /v1/environmentsmanaged-agents-2026-04-01
/v1/tunnelsmcp-tunnels-2026-06-22
/v1/memory_stores и вложенные ресурсыagent-memory-2026-07-22

Пространства имён beta в SDK добавляют эти заголовки автоматически. Добавляйте их самостоятельно только при выполнении прямых HTTP-запросов. Подробности см. в обзоре Managed Agents, разделе Использование памяти агента и справочнике по туннелям MCP.

Заголовки для конкретных конечных точек, применяемые к одной и той же конечной точке, не всегда можно комбинировать. На конечных точках хранилищ памяти agent-memory-2026-07-22 заменяет managed-agents-2026-04-01: отправка обоих в одном запросе возвращает ошибку 400. Клиентские SDK автоматически отправляют правильный заголовок для каждой конечной точки.

Соглашения об именовании версий

Имена бета-функций обычно следуют шаблону feature-name-YYYY-MM-DD, где дата указывает, когда была выпущена бета-версия. Всегда используйте точное имя бета-функции, как указано в документации.

Обработка ошибок

Если вы используете недопустимое имя бета-версии или бета-версию, к которой у вашей организации нет доступа, вы получите ответ с ошибкой 400:

Output
{
  "type": "error",
  "error": {
    "type": "invalid_request_error",
    "message": "Unexpected value(s) `invalid-beta-name` for the `anthropic-beta` header. Please consult our documentation at platform.claude.com/docs or try again without the header."
  },
  "request_id": "req_011CcnGfC9fELffo2EALu4Wd"
}

Получение помощи

Обновления бета-функций см. в примечаниях к выпуску. Для помощи с проблемами в продакшене обратитесь в службу поддержки.

Следующие шаги

Ошибки

Разберитесь в кодах состояния HTTP, структуре ответов с ошибками и идентификаторах запросов, которые возвращает Claude API, и обрабатывайте ошибки с помощью типизированных исключений SDK.

Обзор API

Изучите возможности Claude API, включая API, которые в настоящее время находятся в бета-версии.

Was this page helpful?