En-têtes bêta

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.

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 :

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 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 comme exemple. Le SDK accepte les noms de bêta via betas et envoie l'en-tête anthropic-beta pour vous :

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)

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 :

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 :

anthropic-beta: feature1
anthropic-beta: feature2
anthropic-beta: feature3

Avec le SDK, listez chaque fonctionnalité (par exemple, betas=["feature1", "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, Microsoft Foundry et Google Cloud 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 (points de terminaison bedrock-mantle) les accepte dans l'en-tête anthropic-beta.
• L'API InvokeModel 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 :

L'espace de noms 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, Utiliser la mémoire des agents et la référence des tunnels MCP 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 :

{
  "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. Pour obtenir de l'aide concernant des problèmes en production, contactez le support.

Étapes suivantes