|

3 chemins pour configurer l’URL de base d’APIYI : /v1 pour le général, domaine racine pour Claude, et /v1beta pour Gemini

ParAPIYI - Stable and affordable AI API

Note de l'auteur : Voici une explication détaillée des 3 chemins d'URL de base et des 3 nœuds de domaine de la plateforme APIYI. Apprenez à les configurer correctement pour éviter les erreurs dès la première tentative.

Lors de la configuration de l'API d'un modèle d'IA, une URL de base mal renseignée est l'un des problèmes les plus fréquents rencontrés par les développeurs. Les différents fournisseurs de modèles utilisent des normes de chemin distinctes — OpenAI utilise /v1, Anthropic Claude utilise le domaine racine, et Google Gemini utilise /v1beta — et si vous ignorez ces différences, l'invocation du modèle échouera inévitablement.

La plateforme APIYI est entièrement compatible avec ces trois normes de chemin et propose 3 nœuds de domaine (principal domestique, secours domestique, exclusif outre-mer) pour garantir une connexion stable dans le monde entier. Cet article vous aidera à configurer tous vos scénarios du premier coup grâce à des tableaux clairs et des exemples de code.

Valeur ajoutée : Après avoir lu cet article, vous maîtriserez parfaitement la configuration de l'URL de base sur APIYI et ne perdrez plus de temps à déboguer des erreurs de chemin.

apiyi-base-url-v1-claude-gemini-endpoint-config-guide-fr 图示

Points clés de l'URL de base (Base URL) d'APIYI

Point clé Description Valeur
3 spécifications de chemin /v1 générique, domaine racine pour Claude, /v1beta pour Gemini Une plateforme compatible avec tous les SDK majeurs
3 nœuds de domaine Principal (Chine), secours (Chine), exclusif (étranger) Faible latence mondiale + haute disponibilité
Format compatible OpenAI Utilisez le chemin /v1 pour appeler GPT, DeepSeek, Llama, etc. Migration en changeant une seule ligne de base_url
Connexion directe SDK natif Claude et Gemini utilisent les SDK officiels sans conversion Intégration sans coût de modification

Explication détaillée des chemins de l'URL de base d'APIYI

Les différents fournisseurs d'IA ont choisi des styles de chemin distincts lors de la conception de leurs API. Ce n'est pas arbitraire, mais une convention rigide au sein de leurs SDK respectifs :

Famille OpenAI (/v1) : OpenAI a utilisé le préfixe de version /v1 dans l'URL dès le début. Son SDK Python concatène directement le base_url que vous définissez (incluant /v1) avec le chemin de la ressource (comme /chat/completions). Tous les modèles compatibles OpenAI — série GPT, DeepSeek, Llama, Qwen, MiniMax, etc. — suivent cette convention.

Famille Anthropic (domaine racine) : Anthropic a choisi une approche différente : le SDK concatène lui-même le chemin /v1/messages en interne. Par conséquent, le base_url doit uniquement contenir le domaine racine, sans /v1. Si vous ajoutez /v1 par erreur, le SDK générera /v1/v1/messages, provoquant une erreur 404.

Famille Google Gemini (/v1beta) : Google a l'habitude d'utiliser /v1beta pour identifier les API qui ne sont pas encore en GA (General Availability). Le format de point de terminaison de Gemini est /v1beta/models/{model}:generateContent, et le SDK gère également automatiquement la concaténation du chemin.

Sélection des nœuds de domaine pour l'URL de base d'APIYI

APIYI propose 3 nœuds de domaine pour couvrir différents environnements réseau :

Nœud Domaine Scénario d'utilisation Description
Principal (Chine) api.apiyi.com Serveurs en Chine, développement local Premier choix recommandé, latence minimale
Secours (Chine) b.apiyi.com Bascule en cas d'anomalie du nœud principal Sauvegarde pour garantir la continuité du service
Exclusif (Étranger) vip.apiyi.com Déploiement sur serveurs étrangers Optimisation des lignes étrangères, connexion directe

🎯 Conseil de sélection : Les utilisateurs en Chine doivent privilégier api.apiyi.com et configurer b.apiyi.com comme solution de repli (fallback) dans leur code. Pour les services déployés à l'étranger, utilisez directement vip.apiyi.com. Toutes les fonctionnalités des nœuds sont identiques, seules les lignes réseau diffèrent.

Configuration rapide de l'URL de base d'APIYI

Scénario 1 : Appel d'un modèle compatible OpenAI (GPT / DeepSeek / Llama, etc.)

Règle de chemin : Domaine + /v1

import openai

client = openai.OpenAI(
    api_key="VOTRE_CLE_API",
    base_url="https://api.apiyi.com/v1"  # Principal + /v1
)

response = client.chat.completions.create(
    model="gpt-4o",
    messages=[{"role": "user", "content": "Bonjour !"}]
)
print(response.choices[0].message.content)

Scénario 2 : Appel d'un modèle Claude (SDK Anthropic)

Règle de chemin : Domaine (domaine racine, sans /v1)

import anthropic

client = anthropic.Anthropic(
    api_key="VOTRE_CLE_API",
    base_url="https://api.apiyi.com"  # Domaine racine, sans suffixe
)

message = client.messages.create(
    model="claude-sonnet-4-20250514",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Bonjour !"}]
)
print(message.content[0].text)

Scénario 3 : Appel d'un modèle Gemini (SDK Google GenAI)

Règle de chemin : Domaine + /v1beta

from google import genai

client = genai.Client(
    api_key="VOTRE_CLE_API",
    http_options={"api_version": "v1beta", "base_url": "https://api.apiyi.com"}
)

response = client.models.generate_content(
    model="gemini-2.5-pro",
    contents="Bonjour !"
)
print(response.text)

Conseil : Obtenez un crédit de test gratuit via APIYI apiyi.com. La configuration et la vérification de ces trois scénarios peuvent être effectuées en moins de 5 minutes.

apiyi-base-url-v1-claude-gemini-endpoint-config-guide-fr 图示

Guide de configuration rapide de l'URL de base APIYI

Voici la combinaison complète des domaines et des chemins d'accès. Vous pouvez les copier et les utiliser directement :

Configuration de l'URL de base APIYI : Modèles compatibles OpenAI

Nœud de domaine URL de base Modèles compatibles SDK compatible
Principal (Chine) https://api.apiyi.com/v1 GPT, DeepSeek, Llama, Qwen, MiniMax, etc. OpenAI Python/Node SDK
Secondaire (Chine) https://b.apiyi.com/v1 Idem Idem
Exclusif (International) https://vip.apiyi.com/v1 Idem Idem

Configuration de l'URL de base APIYI : Modèles Claude

Nœud de domaine URL de base Modèles compatibles SDK compatible
Principal (Chine) https://api.apiyi.com Claude Opus 4.6, Sonnet 4.6, Haiku, etc. Anthropic Python/TS SDK
Secondaire (Chine) https://b.apiyi.com Idem Idem
Exclusif (International) https://vip.apiyi.com Idem Idem

Configuration de l'URL de base APIYI : Modèles Gemini

Nœud de domaine URL de base Modèles compatibles SDK compatible
Principal (Chine) https://api.apiyi.com/v1beta Gemini 2.5 Pro, 2.5 Flash, etc. Google GenAI SDK
Secondaire (Chine) https://b.apiyi.com/v1beta Idem Idem
Exclusif (International) https://vip.apiyi.com/v1beta Idem Idem

🎯 Conseil de configuration : Les différences entre ces trois chemins sont dictées par l'implémentation interne de chaque SDK, et non par une exigence spécifique d'APIYI. Retenez simplement cette règle : OpenAI nécessite /v1, Claude ne l'utilise pas, et Gemini nécessite /v1beta — vous ne pourrez pas vous tromper.

Erreurs courantes et dépannage de l'URL de base APIYI

apiyi-base-url-v1-claude-gemini-endpoint-config-guide-fr 图示

Dépannage rapide des erreurs courantes :

Phénomène d'erreur Cause probable Solution
404 Not Found Le SDK OpenAI manque de /v1, ou le SDK Anthropic en a un en trop Vérifiez si le chemin correspond à la spécification du SDK
400 Bad Request Version de chemin Gemini non correspondante Confirmez l'utilisation de /v1beta
Connection Timeout Mauvais choix du nœud de domaine Utilisez api.apiyi.com en Chine, vip.apiyi.com à l'international
SSL Error Préfixe https:// manquant Tous les nœuds doivent utiliser HTTPS
Erreur double slash // Slash / en trop à la fin de base_url Supprimez le slash final

FAQ

Q1 : Quelle Base URL dois-je renseigner pour appeler un modèle Claude avec le SDK OpenAI ?

Si vous utilisez le SDK OpenAI pour appeler Claude (via l'interface compatible OpenAI d'APIYI), la Base URL à renseigner est https://api.apiyi.com/v1, exactement comme pour GPT. L'utilisation de la racine du domaine n'est nécessaire que si vous utilisez le SDK officiel d'Anthropic. La distinction clé réside dans le SDK que vous utilisez, et non dans le modèle que vous appelez.

Q2 : Y a-t-il une différence de fonctionnalité entre les trois nœuds de domaine ?

Les fonctionnalités sont strictement identiques, la seule différence réside dans l'optimisation du routage réseau. api.apiyi.com offre la latence la plus faible depuis la Chine, vip.apiyi.com est optimisé pour l'international, et b.apiyi.com sert de nœud de secours en cas de panne. Il est recommandé de configurer un mécanisme de repli (fallback) dans votre code pour basculer automatiquement vers un nœud de secours en cas de dépassement de délai sur le nœud principal.

Q3 : Comment vérifier rapidement si la configuration de la Base URL est correcte ?

Nous vous recommandons d'utiliser la plateforme APIYI pour effectuer cette vérification :

  1. Rendez-vous sur apiyi.com pour créer un compte et obtenir votre clé API.
  2. Utilisez l'exemple de code fourni dans cet article, remplacez YOUR_API_KEY par votre clé, puis exécutez-le.
  3. Si vous recevez une réponse valide, la configuration est correcte. Si vous obtenez une erreur 404 ou 400, vérifiez que le chemin correspond bien aux spécifications du SDK utilisé.

Résumé

Les points clés pour configurer la Base URL sur APIYI :

  1. Règles de chemin : Utilisez /v1 pour le SDK OpenAI, la racine du domaine (sans suffixe) pour le SDK Anthropic, et /v1beta pour le SDK Google GenAI.
  2. Choix du domaine : Privilégiez api.apiyi.com en Chine, vip.apiyi.com à l'international, et b.apiyi.com en secours.
  3. Erreurs courantes : N'ajoutez pas /v1 au SDK Anthropic, n'oubliez pas /v1 pour le SDK OpenAI, et ne mettez pas de barre oblique (slash) à la fin.

Gardez cette règle en tête : OpenAI avec /v1, Claude sans, et Gemini avec /v1beta — et vous ne ferez plus d'erreurs de configuration.

N'hésitez pas à consulter apiyi.com pour obtenir des crédits gratuits et tester rapidement. La plateforme est compatible avec ces trois normes de chemin et prend en charge l'invocation du modèle pour tous les modèles populaires.

📚 Références

  1. Documentation de l'API OpenAI : Instructions pour l'accès à l'API et l'utilisation du SDK

    • Lien : platform.openai.com/docs/api-reference
    • Description : Référence officielle de l'API OpenAI, pour comprendre la spécification du chemin /v1.

  2. Documentation de l'API Anthropic : Guide d'accès aux modèles Claude

    • Lien : docs.anthropic.com/en/api/getting-started
    • Description : Pour comprendre la spécification base_url du SDK Anthropic.

  3. Google AI for Developers : Instructions d'accès à l'API Gemini

    • Lien : ai.google.dev/gemini-api/docs
    • Description : Pour comprendre le chemin /v1beta et la configuration du SDK GenAI.

  4. Documentation de la plateforme APIYI : Guide de démarrage rapide et de configuration

    • Lien : docs.apiyi.com
    • Description : Obtention de la clé API, liste des modèles et configuration multi-nœuds.

Auteur : Équipe technique APIYI
Échanges techniques : N'hésitez pas à discuter dans la section des commentaires. Pour plus d'informations, visitez le centre de documentation APIYI sur docs.apiyi.com.

Try AI Large Model https://api.apiyi.com for free
Stable and reliable AI LM API aggregation service, Get 300 Millions Tokens for Free~

Publications similaires