En-têtes bêta

Les en-têtes bêta vous permettent d'accéder aux fonctionnalités expérimentales et aux nouvelles capacités des modèles 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 bêta exact à envoyer. La vue d'ensemble 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. Les SDK prennent les noms 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=["files-api-2025-04-14"],
)

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 aux points 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. Ajoutez-les vous-même uniquement lorsque vous effectuez des requêtes HTTP brutes. Consultez la vue d'ensemble des Managed Agents, Utilisation de la mémoire d'agent 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 de magasin 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 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.



Prochaines étapes