En-têtes bêta

Les 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.

Ces fonctionnalités sont susceptibles d'évoluer et peuvent être modifiées ou supprimées dans les versions futures.



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
Content-Type: application/json
X-API-Key: YOUR_API_KEY
anthropic-beta: BETA_FEATURE_NAME

Lorsque vous utilisez le SDK, vous pouvez spécifier les en-têtes bêta dans les options de requête :

client = Anthropic()

response = client.beta.messages.create(
    model="claude-opus-4-8",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hello, Claude"}],
    betas=["files-api-2025-04-14"],
)



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



En-têtes spécifiques à un point de terminaison

Certaines fonctionnalités bêta sont limitées à des points de terminaison spécifiques plutôt qu'à des paramètres de requête individuels et nécessitent un en-tête bêta propre à la fonctionnalité sur chaque requête :

Consultez la présentation des agents gérés pour plus de détails.



Conventions de nommage des versions

Les noms de fonctionnalités bêta suivent généralement le modèle : feature-name-YYYY-MM-DD, où la date indique quand la version 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 en-tête bêta invalide ou indisponible, vous recevrez une réponse d'erreur :

{
  "type": "error",
  "error": {
    "type": "invalid_request_error",
    "message": "Unsupported beta header: invalid-beta-name"
  }
}



Obtenir de l'aide

Pour toute question concernant les fonctionnalités bêta :

1. Consultez la documentation de la fonctionnalité spécifique
2. Consultez le journal des modifications de l'API pour les mises à jour
3. Contactez le support pour obtenir de l'aide concernant l'utilisation en production

N'oubliez pas que les fonctionnalités bêta sont fournies « en l'état » et peuvent ne pas bénéficier des mêmes garanties de SLA que les fonctionnalités stables de l'API.