Migrer depuis Anthropic
Si votre code appelle déjà api.anthropic.com, toute la migration tient en une variable d’environnement. Requêtes et réponses restent identiques octet pour octet.
Ce qui change (et ce qui ne change pas)
Rien ne change dans le schéma des requêtes, le format des réponses, les événements de streaming ni le SDK que vous utilisez déjà. La seule différence, c’est la destination des octets :
| Aspect | Anthropic | API-AI |
|---|---|---|
| URL de base | https://api.anthropic.com | https://api-ai.fr |
| En-tête d’authentification | x-api-key | x-api-key ou Authorization: Bearer |
| En-tête de version | anthropic-version: 2023-06-01 | anthropic-version: 2023-06-01 |
| Schéma de requête | API Messages d’Anthropic | Identique |
| Schéma de réponse | API Messages d’Anthropic | Identique |
| Événements de streaming | SSE : message_start, content_block_delta... | Identiques, sans mise en tampon |
Cache de prompts (cache_control) | Natif | Natif — transmis tel quel |
| Modèles | ~15 alias historiques | Liste Claude autorisée générée — voir Modèles |
| Facturation | Carte, post-payé, mensuel | Recharge prépayée (carte, Apple Pay, crypto), sans abonnement |
Migration par variables d’environnement uniquement
Si votre code lit ses identifiants depuis des variables d’environnement (c’est recommandé), voici tout le changement :
# Before
export ANTHROPIC_API_KEY=sk-ant-...
# After
export ANTHROPIC_API_KEY=mdf-... # API-AI key
export ANTHROPIC_BASE_URL=https://api-ai.frLes SDK officiels Anthropic Python et Node lisent ANTHROPIC_BASE_URL sans aucune autre modification de code.
Python — forme explicite
# Before
from anthropic import Anthropic
client = Anthropic()
# After
from anthropic import Anthropic
client = Anthropic(
api_key=os.environ["ANTHROPIC_API_KEY"],
base_url="https://api-ai.fr",
)Node — forme explicite
// Before
import Anthropic from "@anthropic-ai/sdk";
const client = new Anthropic();
// After
import Anthropic from "@anthropic-ai/sdk";
const client = new Anthropic({
apiKey: process.env.ANTHROPIC_API_KEY,
baseURL: "https://api-ai.fr",
});Changer d’identifiant de modèle
La surface native Anthropic expose 16 identifiants Claude actuels. Si votre code fait référence à un ancien alias Anthropic (claude-3-5-sonnet, claude-3-opus-20240229, etc.), vous recevrez une 400 invalid_request_error — remplacez-le par l’identifiant officiel actuel :
| Ancien alias | À utiliser |
|---|---|
claude-3-5-sonnet*, claude-sonnet-3-5 | claude-sonnet-5-5 |
claude-3-opus*, claude-opus-3 | claude-opus-4-8 |
claude-3-haiku*, claude-haiku-3-5 | claude-haiku-4-5 |
Vérifier le changement
# Should print the current Claude model ids
curl -s https://api-ai.fr/v1/models \
-H "x-api-key: $ANTHROPIC_API_KEY" | jq '.data[].id'
# Should return HTTP 200 and a short text message
curl -s https://api-ai.fr/v1/messages \
-H "x-api-key: $ANTHROPIC_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "content-type: application/json" \
-d '{"model":"claude-haiku-4-5","max_tokens":32,"messages":[{"role":"user","content":"hi"}]}'