Migrer du SDK officiel vers une passerelle unifiée : cinq étapes sans coût de refonte

1. Extraire l'URL de base dans la configuration

Si votre code contient encore https://api.openai.com/v1 en dur, la première étape n'est pas de changer d'adresse, mais de la déplacer dans une variable d'environnement. Cela détermine votre capacité à revenir en arrière à tout moment.

URL de base et points de terminaison →

2. Remplacer par l'adresse de la passerelle et la clé

Admesh n'expose que deux informations à retenir : l'URL de base est https://api.admesh.ai/v1, et la clé se crée dans la console. La clé en clair n'est affichée qu'une seule fois à la création ; ensuite, seuls le préfixe et les quatre derniers caractères sont conservés.

3. Remplacer le nom du modèle par namespace/model

La passerelle utilise des noms de modèles publics au format namespace/model (par exemple anthropic/…, openai/…, deepseek/…, qwen/…). La liste complète fait référence à /v1/models ou au catalogue de modèles de la console ; le site de documentation propose également une [liste des modèles](https://docs.admesh.ai/zh/docs/api-reference/models).

Ne codez pas les noms de modèles en dur dans le code : placez-les dans la configuration, changer de modèle revient alors à modifier la configuration.

4. Comparaison en double écriture

1. Avec le même lot de requêtes réelles, appelez séparément l'API officielle et la passerelle.
2. Comparez trois éléments : la structure de réponse (les champs sont-ils identiques), le champ usage (mode de comptage des tokens), le comportement de fragmentation en streaming.
3. Vérifiez la réponse d'erreur : envoyez volontairement une requête avec un paramètre erroné pour confirmer que le format du code d'erreur est conforme aux attentes.
4. Enregistrez les écarts de latence et de coût entre les deux côtés comme base de référence pour les optimisations ultérieures.

5. Déploiement progressif et rollback

• Basculez d'abord le trafic non critique (outils internes, tâches à faible risque) et observez pendant une semaine.
• Surveillez trois indicateurs : taux d'erreur, latence P95, coût par requête.
• Gardez le rollback simple : il suffit de remettre la variable d'environnement sur l'adresse officielle, sans modifier le code.
• Après confirmation de la stabilité, migrez l'activité principale et mettez à jour en parallèle la documentation et la configuration des alertes de l'équipe.

Que faire du protocole natif Anthropic

Certains codes utilisent directement la forme de l'API Messages d'Anthropic (/v1/messages, max_tokens obligatoire, champ system séparé). Admesh fournit également un [point de terminaison compatible Anthropic](https://docs.admesh.ai/zh/docs/api-reference/anthropic-compatible) ; ces projets n'ont pas besoin d'être réécrits au style OpenAI, il suffit de changer l'URL de base et la clé.