Comment renseigner la Base URL

La Base URL est l’adresse de base utilisée par le client ou le SDK pour envoyer des requêtes à l’API.

Vous pouvez la comprendre comme « l’endroit où la requête doit être envoyée ». Si cette adresse est incorrecte, la requête échouera même si votre API Key est correcte.

La méthode de saisie la plus courante pour MoleAPI

Pour la grande majorité des outils et SDK compatibles avec l’interface OpenAI, il est recommandé de renseigner directement :

https://api.moleapi.com/v1

C’est le paramètre que les débutants devraient retenir en priorité.

Pourquoi /v1 est requis dans de nombreux cas

Parce que de nombreux SDK ou clients ajoutent automatiquement, à la suite de la Base URL que vous renseignez, un chemin semblable à ceux-ci :

• /chat/completions
• /responses
• /embeddings
• /images/generations

Ainsi, si vous renseignez :

https://api.moleapi.com/v1

L’adresse complète générée pourra être :

https://api.moleapi.com/v1/chat/completions

C’est généralement la configuration correcte.

Dans quels cas peut-on ne pas renseigner /v1

Quelques outils exigent que vous saisissiez « l’adresse racine du site », puis ajoutent eux-mêmes /v1 en interne.

Dans ce cas, vous pouvez essayer :

https://api.moleapi.com

Mais si vous avez un doute, essayez d’abord https://api.moleapi.com/v1.

Les erreurs de saisie les plus fréquentes

Erreur 1 : renseigner l’adresse officielle d’OpenAI

Par exemple :

https://api.openai.com/v1

Dans ce cas, la requête ne passera pas par MoleAPI et sera envoyée directement à l’API officielle d’OpenAI.

Erreur 2 : oublier /v1

Certaines applications exigent une adresse allant jusqu’à /v1. Si vous saisissez seulement :

https://api.moleapi.com

vous pouvez rencontrer :

• 404
• Invalid URL
• interface inexistante
• erreur dans la concaténation du chemin de requête

Erreur 3 : utiliser le chemin complet de l’endpoint comme Base URL

Par exemple, si vous saisissez :

https://api.moleapi.com/v1/chat/completions

C’est généralement incorrect, car de nombreux SDK ajoutent encore un chemin après celui-ci, ce qui finit par produire une URL invalide.

Sauf si un outil demande explicitement l’adresse complète de l’endpoint, la Base URL ne doit généralement être renseignée que jusqu’à :

https://api.moleapi.com/v1

Erreur 4 : espaces, ponctuation chinoise ou protocole incorrect lors de la copie

Par exemple :

• https//api.moleapi.com/v1
• http://api.moleapi.com/v1
• des espaces en début ou en fin d’adresse
• présence de caractères pleine largeur après copie

Ce type de problème est très courant, et il n’est pas toujours visible au premier coup d’œil.

Comment vérifier rapidement que la configuration est correcte

Vous pouvez vérifier dans l’ordre suivant :

1. La Base URL est-elle bien https://api.moleapi.com/v1 ?
2. L’API Key est-elle bien le sk-... créé dans la console MoleAPI ?
3. Le nom du modèle est-il disponible dans le Group actuel ?
4. Le client prend-il en charge l’interface OpenAI compatible ?

Si tout cela est correct et que la requête échoue toujours, consultez ensuite les logs détaillés et les codes d’erreur.

Recommandations selon les cas d’usage

Cas 1 : intégration dans un client tiers

Pour des outils comme Chatbox, NextChat, 沉浸式翻译 ou Cherry Studio :

• utilisez en priorité https://api.moleapi.com/v1
• renseignez votre sk-... comme API Key

Cas 2 : intégration via le SDK OpenAI

Que vous utilisiez Node.js, Python ou tout autre SDK compatible OpenAI, il est généralement recommandé de renseigner en priorité :

https://api.moleapi.com/v1

Cas 3 : vous voyez api.openai.com dans le message d’erreur

Cela indique généralement que votre requête n’est pas passée par MoleAPI, mais qu’elle vise toujours l’adresse officielle d’OpenAI. Vérifiez en priorité que la Base URL a bien été modifiée.

Que lire ensuite

• Qu’est-ce qu’une API Key ?
• Comment créer une API Key
• Qu’est-ce qu’un Group ?