--- title: Бета-заголовки url: https://platform.claude.com/docs/ru/api/beta-headers description: Получайте доступ к экспериментальным функциям до того, как они станут частью стандартного API, с помощью заголовка `anthropic-beta` или параметра `betas` в SDK. --- Бета-заголовки (beta headers) позволяют вам получить доступ к экспериментальным функциям и новым возможностям моделей до того, как они станут частью стандартного API. [Клиентский SDK](https://platform.claude.com/docs/ru/cli-sdks-libraries/overview) предоставляет пространство имён `client.beta` (csharp, go: `client.Beta`; java: `client.beta()`; php: `$client->beta`) для вызова API с включёнными бета-функциями. ## Как использовать бета-заголовки Чтобы получить доступ к бета-функциям, включите заголовок `anthropic-beta` в ваши запросы к API: ```http POST /v1/messages x-api-key: YOUR_API_KEY anthropic-version: 2023-06-01 anthropic-beta: BETA_FEATURE_NAME content-type: application/json ``` В документации каждой функции указано точное имя бета-версии, которое нужно отправить. В [обзоре API](https://platform.claude.com/docs/ru/api/overview) перечислены API, которые в настоящее время находятся в бета-версии. В следующих примерах показан один и тот же запрос с использованием cURL, CLI `ant` и SDK; в качестве примера используется бета-функция [редактирования контекста](https://platform.claude.com/docs/ru/build-with-claude/context-editing). SDK принимает имена бета-версий через `betas` (csharp, go: `Betas`; java: `.addBeta()`) и отправляет заголовок `anthropic-beta` за вас: ```bash cURL curl https://api.anthropic.com/v1/messages \ -H "x-api-key: $ANTHROPIC_API_KEY" \ -H "anthropic-version: 2023-06-01" \ -H "anthropic-beta: context-management-2025-06-27" \ -H "content-type: application/json" \ -d '{ "model": "claude-opus-5-5", "max_tokens": 1024, "messages": [ {"role": "user", "content": "Hello, Claude"} ] }' ``` ```bash CLI ant beta:messages create \ --beta context-management-2025-06-27 \ --model claude-opus-5-5 \ --max-tokens 1024 \ --message '{role: user, content: "Hello, Claude"}' ``` ```python Python client = Anthropic() response = client.beta.messages.create( model="claude-opus-5-5", max_tokens=1024, messages=[{"role": "user", "content": "Hello, Claude"}], betas=["context-management-2025-06-27"], ) print(response.content) ``` ```typescript TypeScript const client = new Anthropic(); const msg = await client.beta.messages.create({ model: "claude-opus-5-5", max_tokens: 1024, messages: [{ role: "user", content: "Hello, Claude" }], betas: ["context-management-2025-06-27"] }); console.log(msg.content); ``` ```csharp C# var client = new AnthropicClient(); var message = await client.Beta.Messages.Create( new MessageCreateParams { Model = Model.ClaudeOpus5_5, MaxTokens = 1024, Messages = [new() { Role = Role.User, Content = "Hello, Claude" }], Betas = ["context-management-2025-06-27"], } ); Console.WriteLine(string.Join("\n", message.Content)); ``` ```go Go client := anthropic.NewClient() message, err := client.Beta.Messages.New(context.TODO(), anthropic.BetaMessageNewParams{ Model: anthropic.ModelClaudeOpus5_5, MaxTokens: 1024, Messages: []anthropic.BetaMessageParam{ anthropic.NewBetaUserMessage(anthropic.NewBetaTextBlock("Hello, Claude")), }, Betas: []anthropic.AnthropicBeta{anthropic.AnthropicBetaContextManagement2025_06_27}, }) if err != nil { panic(err) } fmt.Printf("%+v\n", message.Content) ``` ```java Java AnthropicClient client = AnthropicOkHttpClient.fromEnv(); MessageCreateParams params = MessageCreateParams.builder() .model(Model.CLAUDE_OPUS_5_5) .maxTokens(1024) .addUserMessage("Hello, Claude") .addBeta(AnthropicBeta.CONTEXT_MANAGEMENT_2025_06_27) .build(); BetaMessage message = client.beta().messages().create(params); System.out.println(message.content()); ``` ```php PHP $client = new Client(); $message = $client->beta->messages->create( maxTokens: 1024, messages: [['role' => 'user', 'content' => 'Hello, Claude']], model: 'claude-opus-5-5', betas: ['context-management-2025-06-27'], ); echo $message; ``` ```ruby Ruby client = Anthropic::Client.new message = client.beta.messages.create( model: "claude-opus-5-5", max_tokens: 1024, messages: [{role: "user", content: "Hello, Claude"}], betas: ["context-management-2025-06-27"] ) puts(message.content) ``` Бета-функции являются экспериментальными и могут: * Содержать критические изменения с предварительным уведомлением * Быть объявлены устаревшими или удалены * Иметь другие ограничения скорости (rate limits) или цены * Быть недоступными в некоторых регионах ### Несколько бета-функций Чтобы использовать несколько бета-функций в одном запросе, включите все имена функций в заголовок, разделив их запятыми: ```http anthropic-beta: feature1,feature2,feature3 ``` Вы также можете отправить заголовок `anthropic-beta` более одного раза в одном запросе. Claude API считывает каждый заголовок `anthropic-beta`, поэтому следующий пример эквивалентен предыдущему: ```http anthropic-beta: feature1 anthropic-beta: feature2 anthropic-beta: feature3 ``` В SDK перечислите каждую функцию (например, `betas=["feature1", "feature2"]` (typescript, ruby: `betas: ["feature1", "feature2"]`; php: `betas: ['feature1', 'feature2']`; csharp: `Betas = ["feature1", "feature2"]`; go: `Betas: []anthropic.AnthropicBeta{"feature1", "feature2"}`; java: `.addBeta("feature1").addBeta("feature2")`)). В CLI передайте один флаг `--beta` с именами функций через запятую (например, `--beta feature1,feature2`). Вы также можете повторить флаг (например, `--beta feature1 --beta feature2`). ### Бета-функции на других платформах Имена бета-версий одинаковы на всех платформах, которые их принимают, но не каждая платформа принимает каждую бета-функцию. [Claude Platform on AWS](https://platform.claude.com/docs/ru/build-with-claude/claude-platform-on-aws), [Microsoft Foundry](https://platform.claude.com/docs/ru/build-with-claude/claude-in-microsoft-foundry) и [Google Cloud](https://platform.claude.com/docs/ru/build-with-claude/claude-on-vertex-ai) принимают имена бета-версий в заголовке `anthropic-beta`, как и Claude API. Чтобы отправить несколько бета-функций, укажите их имена в одном заголовке через запятую: Google Cloud считывает только один заголовок `anthropic-beta` и игнорирует остальные, поэтому бета-функции в других заголовках не вступают в силу. В Amazon Bedrock то, где указываются имена бета-версий, зависит от вызываемого API: * [Claude в Amazon Bedrock](https://platform.claude.com/docs/ru/build-with-claude/claude-in-amazon-bedrock) (конечные точки `bedrock-mantle`) принимает их в заголовке `anthropic-beta`. * [InvokeModel API](https://platform.claude.com/docs/ru/build-with-claude/claude-on-amazon-bedrock-legacy) считывает их из тела запроса, а не из заголовка. Перечислите их в массиве `anthropic_beta` в теле запроса, по одному имени на элемент, например `"anthropic_beta": ["feature1", "feature2"]`. ### Заголовки для конкретных конечных точек Некоторые бета-API ограничены конкретными конечными точками и требуют специфичного для функции бета-заголовка в каждом запросе: | Конечные точки | Бета-заголовок | | ------------------------------------------------ | --------------------------- | | `/v1/agents`, `/v1/sessions`, `/v1/environments` | `managed-agents-2026-04-01` | | `/v1/tunnels` | `mcp-tunnels-2026-06-22` | | `/v1/memory_stores` и вложенные ресурсы | `agent-memory-2026-07-22` | Пространство имён `client.beta` (csharp, go: `client.Beta`; java: `client.beta()`; php: `$client->beta`) в SDK добавляет эти заголовки автоматически. Добавляйте их самостоятельно только при выполнении прямых HTTP-запросов. Подробнее см. в [обзоре Managed Agents](https://platform.claude.com/docs/ru/managed-agents/overview), разделе [Использование памяти агента](https://platform.claude.com/docs/ru/managed-agents/memory) и [справочнике по туннелям MCP](https://platform.claude.com/docs/ru/agents-and-tools/mcp-tunnels/reference#tunnels-api). Заголовки для конкретных конечных точек, относящиеся к одной и той же конечной точке, не всегда можно комбинировать. На конечных точках хранилищ памяти `agent-memory-2026-07-22` заменяет `managed-agents-2026-04-01`: отправка обоих заголовков в одном запросе возвращает ошибку `400`. SDK автоматически отправляет правильный заголовок для каждой конечной точки. ### Соглашения об именовании версий Имена бета-функций обычно следуют шаблону `feature-name-YYYY-MM-DD`, где дата указывает, когда была выпущена бета-версия. Всегда используйте точное имя бета-функции, как указано в документации. ## Обработка ошибок Если вы используете недопустимое имя бета-версии или бета-версию, к которой у вашей организации нет доступа, вы получите ответ с ошибкой `400`: ```json Output { "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" } ``` ## Получение помощи Обновления бета-функций см. в [примечаниях к выпуску](https://platform.claude.com/docs/ru/release-notes/overview). Для помощи с проблемами в продакшене обратитесь в [службу поддержки](https://support.claude.com/). ## Следующие шаги Разберитесь в кодах состояния HTTP, структуре ответов с ошибками и идентификаторах запросов, которые возвращает Claude API, и обрабатывайте ошибки с помощью типизированных исключений SDK. Изучите возможности Claude API, включая API, которые в настоящее время находятся в бета-версии.