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

Бета-заголовки позволяют вам получить доступ к экспериментальным функциям и новым возможностям моделей до того, как они станут частью стандартного 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=["files-api-2025-04-14"],
)

print(response.content)



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

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

anthropic-beta: feature1,feature2,feature3

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



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

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

Пространства имён 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"
}



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

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



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