--- title: En-têtes bêta url: https://platform.claude.com/docs/fr/api/beta-headers description: Accédez aux fonctionnalités expérimentales avant qu'elles ne fassent partie de l'API standard grâce à l'en-tête `anthropic-beta` ou au paramètre `betas` du SDK. --- Les « beta headers » (en-têtes bêta) vous permettent d'accéder à des fonctionnalités expérimentales et à de nouvelles capacités de modèle avant qu'elles ne fassent partie de l'API standard. Le [SDK client](https://platform.claude.com/docs/fr/cli-sdks-libraries/overview) expose un espace de noms `client.beta` (csharp, go: `client.Beta`; java: `client.beta()`; php: `$client->beta`) permettant d'appeler l'API avec les fonctionnalités bêta activées. ## Comment utiliser les en-têtes bêta Pour accéder aux fonctionnalités bêta, incluez l'en-tête `anthropic-beta` dans vos requêtes 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 ``` La documentation de chaque fonctionnalité indique le nom exact de la bêta à envoyer. La [présentation de l'API](https://platform.claude.com/docs/fr/api/overview) répertorie les API actuellement en bêta. Les exemples suivants montrent la même requête avec cURL, la CLI `ant` et le SDK, en utilisant la bêta d'[édition du contexte](https://platform.claude.com/docs/fr/build-with-claude/context-editing) comme exemple. Le SDK accepte les noms de bêta via `betas` (csharp, go: `Betas`; java: `.addBeta()`) et envoie l'en-tête `anthropic-beta` pour vous : ```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) ``` Les fonctionnalités bêta sont expérimentales et peuvent : * Subir des modifications incompatibles avec préavis * Être dépréciées ou supprimées * Avoir des limites de débit ou une tarification différentes * Ne pas être disponibles dans toutes les régions ### Plusieurs fonctionnalités bêta Pour utiliser plusieurs fonctionnalités bêta dans une seule requête, incluez tous les noms de fonctionnalités dans l'en-tête, séparés par des virgules : ```http anthropic-beta: feature1,feature2,feature3 ``` Vous pouvez également envoyer l'en-tête `anthropic-beta` plusieurs fois dans la même requête. L'API Claude lit chaque en-tête `anthropic-beta`, de sorte que l'exemple suivant est équivalent au précédent : ```http anthropic-beta: feature1 anthropic-beta: feature2 anthropic-beta: feature3 ``` Avec le SDK, listez chaque fonctionnalité (par exemple, `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")`)). Avec la CLI, passez un seul indicateur `--beta` avec les noms de fonctionnalités séparés par des virgules (par exemple, `--beta feature1,feature2`). Vous pouvez également répéter l'indicateur (par exemple, `--beta feature1 --beta feature2`). ### Fonctionnalités bêta sur d'autres plateformes Les noms de bêta sont les mêmes sur toutes les plateformes qui les acceptent, mais toutes les plateformes n'acceptent pas toutes les bêtas. [Claude Platform on AWS](https://platform.claude.com/docs/fr/build-with-claude/claude-platform-on-aws), [Microsoft Foundry](https://platform.claude.com/docs/fr/build-with-claude/claude-in-microsoft-foundry) et [Google Cloud](https://platform.claude.com/docs/fr/build-with-claude/claude-on-vertex-ai) acceptent les noms de bêta dans l'en-tête `anthropic-beta`, comme le fait l'API Claude. Pour envoyer plusieurs bêtas, placez leurs noms dans un seul en-tête, séparés par des virgules : Google Cloud ne lit qu'un seul en-tête `anthropic-beta` et ignore les autres, de sorte que les bêtas figurant dans ces derniers ne prennent pas effet. Sur Amazon Bedrock, l'emplacement des noms de bêta dépend de l'API que vous appelez : * [Claude dans Amazon Bedrock](https://platform.claude.com/docs/fr/build-with-claude/claude-in-amazon-bedrock) (points de terminaison `bedrock-mantle`) les accepte dans l'en-tête `anthropic-beta`. * L'[API InvokeModel](https://platform.claude.com/docs/fr/build-with-claude/claude-on-amazon-bedrock-legacy) les lit dans le corps de la requête, et non dans un en-tête. Listez-les dans le tableau `anthropic_beta` du corps, un nom par élément, par exemple `"anthropic_beta": ["feature1", "feature2"]`. ### En-têtes spécifiques à un point de terminaison Certaines API bêta sont limitées à des points de terminaison spécifiques et nécessitent un en-tête bêta propre à la fonctionnalité sur chaque requête : | Points de terminaison | En-tête bêta | | ------------------------------------------------ | --------------------------- | | `/v1/agents`, `/v1/sessions`, `/v1/environments` | `managed-agents-2026-04-01` | | `/v1/tunnels` | `mcp-tunnels-2026-06-22` | | `/v1/memory_stores` et sous-ressources | `agent-memory-2026-07-22` | L'espace de noms `client.beta` (csharp, go: `client.Beta`; java: `client.beta()`; php: `$client->beta`) du SDK ajoute ces en-têtes automatiquement. Ajoutez-les vous-même uniquement lorsque vous effectuez des requêtes HTTP brutes. Consultez la [présentation de Managed Agents](https://platform.claude.com/docs/fr/managed-agents/overview), [Utiliser la mémoire des agents](https://platform.claude.com/docs/fr/managed-agents/memory) et la [référence des tunnels MCP](https://platform.claude.com/docs/fr/agents-and-tools/mcp-tunnels/reference#tunnels-api) pour plus de détails. Les en-têtes spécifiques aux points de terminaison qui s'appliquent au même point de terminaison ne sont pas toujours combinables. Sur les points de terminaison des magasins de mémoire, `agent-memory-2026-07-22` remplace `managed-agents-2026-04-01` : envoyer les deux dans la même requête renvoie une erreur `400`. Le SDK envoie automatiquement l'en-tête correct pour chaque point de terminaison. ### Conventions de nommage des versions Les noms des fonctionnalités bêta suivent généralement le modèle `feature-name-YYYY-MM-DD`, où la date indique quand la bêta a été publiée. Utilisez toujours le nom exact de la fonctionnalité bêta tel que documenté. ## Gestion des erreurs Si vous utilisez un nom de bêta invalide, ou une bêta à laquelle votre organisation n'a pas accès, vous recevrez une réponse d'erreur `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" } ``` ## Obtenir de l'aide Pour les mises à jour des fonctionnalités bêta, consultez les [notes de version](https://platform.claude.com/docs/fr/release-notes/overview). Pour obtenir de l'aide concernant des problèmes en production, contactez le [support](https://support.claude.com/). ## Étapes suivantes Comprenez les codes de statut HTTP, la structure des réponses d'erreur et les identifiants de requête renvoyés par l'API Claude, et gérez les erreurs avec les exceptions typées du SDK. Explorez les fonctionnalités de l'API Claude, y compris les API actuellement en bêta.