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

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

Эти функции могут быть изменены, модифицированы или удалены в будущих выпусках.



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

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

POST /v1/messages
Content-Type: application/json
X-API-Key: YOUR_API_KEY
anthropic-beta: BETA_FEATURE_NAME

При использовании SDK вы можете указать бета-заголовки в параметрах запроса:

client = Anthropic()

response = client.beta.messages.create(
    model="claude-opus-4-8",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hello, Claude"}],
    betas=["files-api-2025-04-14"],
)



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

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

anthropic-beta: feature1,feature2,feature3



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

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

Подробности см. в обзоре Managed Agents.



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

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



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

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

{
  "type": "error",
  "error": {
    "type": "invalid_request_error",
    "message": "Unsupported beta header: invalid-beta-name"
  }
}



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

По вопросам о бета-функциях:

1. Ознакомьтесь с документацией по конкретной функции
2. Просмотрите журнал изменений API на предмет обновлений
3. Обратитесь в службу поддержки за помощью с использованием в продакшене

Помните, что бета-функции предоставляются «как есть» и могут не иметь тех же гарантий SLA, что и стабильные функции API.