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 les SDK, en utilisant la bêta d'édition du contexte comme exemple. Les SDK acceptent les noms de bêta dans le paramètre betas et envoient l'en-tête anthropic-beta pour vous :

client = Anthropic()

response = client.beta.messages.create(
    model="claude-opus-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

Lorsque vous utilisez un SDK, listez chaque fonctionnalité dans le paramètre betas (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). Évitez de répéter l'indicateur : actuellement, seule la valeur du premier indicateur est prise en compte.

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 :

Les espaces de noms beta des SDK ajoutent ces en-têtes automatiquement. Ne les ajoutez vous-même que lorsque vous effectuez des requêtes HTTP brutes. Consultez la présentation de Managed Agents, Utiliser la mémoire d'agent et la référence des tunnels MCP pour plus de détails.

Les en-têtes spécifiques à un point de terminaison qui s'appliquent au même point de terminaison ne sont pas toujours combinables. Sur les points de terminaison de 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. Les SDK clients envoient 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