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

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

Бета-заголовки часто используются в сочетании с бета-пространством имен в клиентских SDK

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

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

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

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

from anthropic import Anthropic

client = Anthropic()

response = client.beta.messages.create(
    model="claude-sonnet-4-20250514",
    max_tokens=1024,
    messages=[
        {"role": "user", "content": "Hello, Claude"}
    ],
    betas=["beta-feature-name"]
)

Бета-функции являются экспериментальными и могут:

  • Иметь критические изменения без предупреждения
  • Быть устаревшими или удаленными
  • Иметь различные ограничения скорости или цены
  • Быть недоступными во всех регионах

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

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

anthropic-beta: feature1,feature2,feature3

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

Названия бета-функций обычно следуют шаблону: 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.