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

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

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

Для доступа к бета-функциям включите заголовок 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.messages.create(
    model="claude-3-5-sonnet-20241022",
    max_tokens=1024,
    messages=[
        {"role": "user", "content": "Hello, Claude"}
    ],
    extra_headers={
        "anthropic-beta": "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.