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.

Ces fonctionnalités sont sujettes à modification 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 la requête :

from anthropic import Anthropic

client = Anthropic()

response = client.messages.create(
    model="claude-3-5-sonnet-20241022",
    max_tokens=1024,
    messages=[
        {"role": "user", "content": "Hello, Claude"}
    ],
    extra_headers={
        "anthropic-beta": "beta-feature-name"
    }
)

​

Fonctionnalités bêta multiples

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

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

N’oubliez pas que les fonctionnalités bêta sont fournies “telles quelles” et peuvent ne pas avoir les mêmes garanties de SLA que les fonctionnalités API stables.