Бета-заголовки
Получайте доступ к экспериментальным функциям до того, как они станут частью стандартного API, с помощью заголовка anthropic-beta или параметра betas в SDK.
Бета-заголовки (beta headers) позволяют вам получить доступ к экспериментальным функциям и новым возможностям моделей до того, как они станут частью стандартного API.
Как использовать бета-заголовки
Чтобы получить доступ к бета-функциям, включите заголовок anthropic-beta в ваши запросы к API:
POST /v1/messages
Authorization: Bearer YOUR_API_KEY
anthropic-version: 2026-10-21
anthropic-beta: BETA_FEATURE_NAME
content-type: application/jsonВ документации каждой функции указано точное бета-имя, которое нужно отправлять. В обзоре API перечислены API, находящиеся в бета-версии.
В следующем примере отправляется запрос с бета-функцией редактирования контекста. 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, Claude Models on Google Cloud (Anthropic managed), Microsoft Foundry и Claude Models on Google Cloud (Google managed) принимают бета-имена в заголовке anthropic-beta, как и Claude API. Чтобы отправить несколько бета-функций, укажите их имена в одном заголовке через запятую: Claude Models on Google Cloud (Google managed) считывает только один заголовок 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/environments | managed-agents-2026-04-01 |
/v1/tunnels | mcp-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:
{
"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"
}Получение помощи
Обновления бета-функций см. в примечаниях к выпуску. Для помощи с проблемами в продакшене обратитесь в службу поддержки.
Следующие шаги
Эта страница была полезной?