Бета-заголовки позволяют вам получить доступ к экспериментальным функциям и новым возможностям моделей до того, как они станут частью стандартного 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.