Compatibilité avec le SDK OpenAI



Démarrer avec le SDK OpenAI

Pour utiliser la fonctionnalité de compatibilité avec le SDK OpenAI, vous devrez :

1. Utiliser un SDK OpenAI officiel
2. Modifier les éléments suivants
   • Mettre à jour votre URL de base pour qu'elle pointe vers l'API Claude
   • Remplacer votre clé API par une clé API Claude
   • Mettre à jour le nom de votre modèle pour utiliser un modèle Claude
3. Consulter les sections suivantes pour connaître les fonctionnalités prises en charge



Exemple de démarrage rapide

import os

from openai import OpenAI

client = OpenAI(
    api_key=os.environ.get("ANTHROPIC_API_KEY"),  # Your Claude API key
    base_url="https://api.anthropic.com/v1/",  # the Claude API endpoint
)

response = client.chat.completions.create(
    model="claude-opus-5",  # Claude model name
    messages=[
        {"role": "system", "content": "You are a helpful assistant."},
        {"role": "user", "content": "Who are you?"},
    ],
)

print(response.choices[0].message.content)



Limitations importantes de compatibilité avec OpenAI



Comportement de l'API

Voici les différences les plus importantes par rapport à l'utilisation d'OpenAI :

• Le paramètre strict pour l'appel de fonctions est ignoré, ce qui signifie que le JSON d'utilisation d'outils n'est pas garanti de suivre le schéma fourni. Pour une conformité garantie au schéma, utilisez l'API Claude native avec les Structured Outputs.
• L'entrée audio n'est pas prise en charge ; elle sera ignorée et supprimée de l'entrée
• La mise en cache des prompts n'est pas prise en charge, mais elle l'est dans les SDK Anthropic
• Les messages system/developer sont remontés et concaténés au début de la conversation, car Anthropic ne prend en charge qu'un seul message système initial.

La plupart des champs non pris en charge sont ignorés silencieusement plutôt que de produire des erreurs. Tout cela est documenté dans les sections suivantes.



Considérations sur la qualité de sortie

Si vous avez beaucoup affiné votre prompt, il est probablement bien ajusté spécifiquement pour OpenAI. Envisagez de le retravailler pour Claude en utilisant le guide des bonnes pratiques de prompting.



Remontée des messages system / developer

La plupart des entrées du SDK OpenAI correspondent clairement et directement aux paramètres de l'API d'Anthropic, mais une différence notable est la gestion des prompts system / developer. Ces deux prompts peuvent être placés tout au long d'une conversation de chat via OpenAI. Comme Anthropic ne prend en charge qu'un message système initial, l'API prend tous les messages system/developer et les concatène ensemble avec un seul saut de ligne (\n) entre eux. Cette chaîne complète est ensuite fournie comme un unique message système au début des messages.



Prise en charge de la réflexion

Vous pouvez activer la réflexion en ajoutant le paramètre thinking. Sur les modèles actuels, la réflexion est adaptative, Claude décidant quand et avec quelle profondeur réfléchir, et sur les modèles Claude 5, elle est activée par défaut ; la réflexion étendue configurée manuellement est un mode hérité. Bien que la réflexion améliore le raisonnement de Claude pour les tâches complexes, le SDK OpenAI ne renvoie pas le processus de pensée détaillé de Claude. Pour les fonctionnalités complètes de réflexion, y compris l'accès à la sortie du raisonnement étape par étape de Claude, utilisez l'API Claude native.

response = client.chat.completions.create(
    model="claude-sonnet-4-6",
    messages=[{"role": "user", "content": "Who are you?"}],
    extra_body={"thinking": {"type": "enabled", "budget_tokens": 2000}},
)



Limites de débit

Les limites de débit suivent les limites standard d'Anthropic pour le point de terminaison /v1/messages.



Prise en charge détaillée de l'API compatible OpenAI



Champs de requête



Champs simples



Champs tools / functions



Champs du tableau messages



Champs de réponse



Compatibilité des messages d'erreur

La couche de compatibilité maintient des formats d'erreur cohérents avec l'API OpenAI. Cependant, les messages d'erreur détaillés ne seront pas équivalents. N'utilisez les messages d'erreur que pour la journalisation et le débogage.



Compatibilité des en-têtes

Bien que le SDK OpenAI gère automatiquement les en-têtes, voici la liste complète des en-têtes pris en charge par l'API Claude pour les développeurs qui ont besoin de travailler directement avec eux.