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 de modèles avant qu’elles ne deviennent partie intégrante de l’API standard.

Ces fonctionnalités sont sujettes à changement 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

Lors de l’utilisation du SDK, vous pouvez spécifier les en-têtes bêta dans les options de requête :

from anthropic import Anthropic

client = Anthropic()

response = client.beta.messages.create(
    model="claude-sonnet-4-20250514",
    max_tokens=1024,
    messages=[
        {"role": "user", "content": "Hello, Claude"}
    ],
    betas=["beta-feature-name"]
)

​

Multiples 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

​

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 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 des questions sur les fonctionnalités bêta :

1. Vérifiez la documentation pour 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 avec l’utilisation en production

Rappelez-vous que les fonctionnalités bêta sont fournies “en l’état” et peuvent ne pas avoir les mêmes garanties de SLA que les fonctionnalités stables de l’API.