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-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hello, Claude"}],
    betas=["context-management-2025-06-27"],
)

print(response.content)

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

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

anthropic-beta: feature1,feature2,feature3

Вы также можете отправить заголовок anthropic-beta более одного раза в одном запросе. Claude API считывает каждый заголовок anthropic-beta, поэтому следующий пример эквивалентен предыдущему:

anthropic-beta: feature1
anthropic-beta: feature2
anthropic-beta: feature3

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

Бета-функции на других платформах

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

В Amazon Bedrock то, где указываются имена бета-версий, зависит от вызываемого API:

  • Claude в Amazon Bedrock (конечные точки bedrock-mantle) принимает их в заголовке anthropic-beta.
  • InvokeModel API считывает их из тела запроса, а не из заголовка. Перечислите их в массиве anthropic_beta в теле запроса, по одному имени на элемент, например "anthropic_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

Пространство имён client.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?