Famille Claude
Les modèles Claude d’Anthropic, qui comprennent les séries Opus, Sonnet, Haiku et Fable. Nous recommandons de les appeler via l’API native Anthropic : l’extended thinking, la mise en cache des prompts, l’entrée PDF et les autres fonctionnalités s’y comportent comme dans l’API officielle. L’API compatible OpenAI est également disponible et convient aux projets qui utilisent déjà le SDK OpenAI.
Tâches courantes
Modèles
Tous les modèles acceptent le texte, les images et les PDF en entrée, et prennent en charge l’appel d’outils. La liste complète des modèles et les prix en vigueur figurent sur la page des modèles ; vous pouvez aussi les interroger via la Models API.
anthropic/claude-opus-5.5anthropic/claude-sonnet-5.5anthropic/claude-haiku-5.5anthropic/claude-fable-5.1Le préfixe anthropic/ de l’ID de modèle est facultatif, et l’écriture officielle d’Anthropic est également acceptée. Les écritures suivantes désignent toutes le même modèle :
Les alias disponibles pour chaque modèle figurent dans le champ aliases renvoyé par la Models API. Le champ model de la réponse utilise toujours l’écriture standard.
Choix de l’endpoint
Les paramètres de requête complets sont décrits dans Anthropic Messages API et Chat Completions API.
Fournisseurs
Les modèles Claude sont servis par deux fournisseurs, et un même modèle ne prend pas en charge les mêmes fonctionnalités selon le fournisseur :
Avec l’API native Anthropic, vous pouvez sélectionner le fournisseur par un en-tête de requête :
-H "X-OfoxAI-Provider-Type: anthropic"Si le fournisseur sélectionné ne sert pas ce modèle, la requête renvoie 400 et le message d’erreur liste les fournisseurs disponibles, par exemple :
No available channel for platform 'anthropic' on model 'anthropic/claude-sonnet-4.6'. Available platforms for this model: aws_bedrock.Les autres façons de sélectionner un fournisseur sont décrites dans Routage des fournisseurs.
Exemples d’appel
Python (SDK Anthropic)
import os
import anthropic
client = anthropic.Anthropic(
base_url="https://api.ofox.io/anthropic",
api_key=os.environ["OFOX_API_KEY"],
)
message = client.messages.create(
model="anthropic/claude-sonnet-4.6",
max_tokens=1024,
system="Tu es un ingénieur backend expérimenté ; réponds de façon concise.",
messages=[{"role": "user", "content": "Explique en une phrase ce qu’est l’idempotence."}],
)
print(message.content[0].text)max_tokens est obligatoire avec l’API native Anthropic, et sa valeur ne doit pas dépasser la sortie maximale du modèle.
Utiliser avec Claude Code
Claude Code passe par l’API native Anthropic, avec l’adresse de base https://api.ofox.io/anthropic. Les étapes de configuration sont décrites dans Configuration de Claude Code.
https://api.ofox.io/anthropicErreurs courantes
Les autres erreurs générales sont décrites dans Gestion des erreurs.
Documentation officielle
- Anthropic · Présentation des modèles
- Anthropic · Extended thinking
- Anthropic · Mise en cache des prompts
- Anthropic · Prise en charge des PDF
La documentation officielle décrit le comportement en appel direct à Anthropic. Via OfoxAI, les ID de modèle et les adresses d’endpoint de cette page font foi.
FAQ
Comment écrire l'ID de modèle de Claude ?
L'écriture standard est anthropic/claude-sonnet-4.6. Vous pouvez aussi omettre le préfixe anthropic/, ou utiliser les écritures officielles claude-sonnet-4-6 et claude-sonnet-4-6-20260217 : toutes désignent le même modèle.
Peut-on appeler Claude avec le SDK OpenAI ?
Oui. Réglez base_url sur https://api.ofox.io/v1 et indiquez un ID de modèle comme anthropic/claude-sonnet-4.6. Si vous avez besoin de l'extended thinking ou des informations complètes d'usage du cache, nous recommandons l'API native Anthropic.
Comment activer le mode thinking de Claude ?
Avec l’API native, passez thinking: {"type": "enabled", "budget_tokens": 2000}, où budget_tokens vaut au moins 1024 et reste inférieur à max_tokens ; ou passez {"type": "adaptive"} pour laisser le modèle décider. Avec l’API compatible OpenAI, passez reasoning: {"max_tokens": 2000}. Ne réglez pas temperature lorsque le thinking est activé.
Que faire si la mise en cache des prompts de Claude ne fonctionne pas ?
Vérifiez dans l'ordre : que cache_control est bien posé sur un bloc de contenu fixe (aucun des deux endpoints ne met en cache automatiquement) ; que le contenu atteint la longueur minimale pouvant être mise en cache ; que le préfixe des deux requêtes est strictement identique ; que les deux requêtes ne sont pas espacées de plus de 5 minutes.
Que faire face à l'erreur prompt is too long ?
L'entrée dépasse le contexte du modèle. Haiku 4.5 a un contexte de 200K tokens, les autres modèles Claude de 1M tokens ; passez à un autre modèle ou raccourcissez l'entrée.
Claude prend-il en charge un contexte de 1M ? Faut-il ajouter un en-tête beta ?
Tous les modèles sauf Haiku 4.5 prennent en charge un contexte de 1M ; sur OfoxAI, aucun en-tête beta n'est nécessaire.
Que faire si la réponse de Claude est tronquée ?
Regardez stop_reason dans la réponse : s'il vaut max_tokens, la sortie a atteint la limite ; augmentez max_tokens. Lorsque le thinking est activé, son contenu consomme aussi le quota max_tokens.
Quel fournisseur sert Claude sur OfoxAI ?
Tous les modèles sont servis par Amazon Bedrock, le fournisseur par défaut. Fable 5, Opus 4.8, Opus 4.7 et Sonnet 5 sont aussi disponibles chez le fournisseur Anthropic, uniquement via l'API native Anthropic et en le sélectionnant avec l'en-tête X-OfoxAI-Provider-Type: anthropic.
Claude peut-il faire des recherches sur le web ?
Oui, mais il faut sélectionner le fournisseur Anthropic ; seuls Fable 5, Opus 4.8, Opus 4.7 et Sonnet 5 sont concernés, et uniquement via l’API native Anthropic. Ajoutez {"type": "web_search_20250305", "name": "web_search"} dans tools.
Claude peut-il lire des PDF ?
Oui. Avec l'API native, transmettez le PDF encodé en base64 dans un bloc de contenu document ; avec l'API compatible OpenAI, utilisez un bloc de contenu file dont file_data est au format data:application/pdf;base64,...