Wie wird die Base URL eingetragen?

Die Base URL korrekt einzutragen ist der erste Schritt für eine funktionierende MoleAPI-Integration

Die Base URL ist die Basisadresse, die ein Client oder SDK verwendet, um API-Anfragen zu senden.

Du kannst sie als „Wohin soll die Anfrage gesendet werden?“ verstehen. Wenn diese Adresse falsch eingetragen ist, schlägt die Anfrage auch dann fehl, wenn dein API Key korrekt ist.

Beispiel für die Konfiguration der API-Adresse: die Base URL im Eingabefeld und die vollständige Anfrageadresse in der Vorschau darunter

Die gebräuchlichste Eingabe für MoleAPI

Für die meisten Tools und SDKs, die OpenAI-kompatible Schnittstellen unterstützen, empfiehlt sich direkt folgende Eingabe:

https://api.moleapi.com/v1

Das ist die wichtigste Konfiguration, die sich Einsteiger zuerst merken sollten.

Warum in vielen Szenarien `/v1` enthalten sein muss

Weil viele SDKs oder Clients nach der von dir eingetragenen Base URL automatisch noch Pfade wie die folgenden anhängen:

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

Wenn du also Folgendes einträgst:

https://api.moleapi.com/v1

kann die daraus zusammengesetzte vollständige Adresse am Ende so aussehen:

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

Das ist in der Regel korrekt.

Wann kann `/v1` weggelassen werden?

Einige wenige Tools erwarten, dass du die „Root-Adresse der Website“ einträgst, und ergänzen intern selbst noch /v1.

In diesem Fall kannst du Folgendes versuchen:

https://api.moleapi.com

Wenn du dir aber nicht sicher bist, probiere zuerst https://api.moleapi.com/v1.

Einfache Faustregel für Einsteiger

Wenn du nicht sicher bist, was du eintragen sollst, verwende zuerst: https://api.moleapi.com/v1

Die häufigsten falschen Schreibweisen

Fehler 1: Die offizielle OpenAI-Adresse eintragen

Zum Beispiel:

https://api.openai.com/v1

Dann wird die Anfrage nicht an MoleAPI weitergeleitet, sondern direkt an die offizielle OpenAI-Adresse gesendet.

Fehler 2: `/v1` weglassen

Bei manchen Anwendungen muss zwingend bis /v1 eingetragen werden. Wenn du nur Folgendes angibst:

https://api.moleapi.com

kann es zu Folgendem kommen:

404
Invalid URL
Schnittstelle existiert nicht
Fehler beim Zusammensetzen des Anfragepfads

Fehler 3: Den vollständigen API-Pfad als Base URL verwenden

Zum Beispiel, wenn du Folgendes einträgst:

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

Das ist in der Regel falsch, weil viele SDKs danach noch weitere Pfade anhängen und die URL dadurch falsch zusammengesetzt wird.

Sofern ein Tool nicht ausdrücklich verlangt, dass du die vollständige API-Adresse einträgst, sollte die Base URL normalerweise nur bis hier eingetragen werden:

https://api.moleapi.com/v1

Fehler 4: Beim Kopieren zusätzliche Leerzeichen, chinesische Satzzeichen oder ein falsches Protokoll übernehmen

Zum Beispiel:

https//api.moleapi.com/v1
http://api.moleapi.com/v1
zusätzliche Leerzeichen vor oder nach der Adresse
versehentlich Fullwidth-Zeichen mitkopiert

Solche Probleme kommen sehr häufig vor und sind auf den ersten Blick nicht immer sofort erkennbar.

So prüfst du schnell, ob die Eingabe korrekt ist

Du kannst die folgenden Punkte der Reihe nach überprüfen:

Ist die Base URL https://api.moleapi.com/v1?
Ist der API Key ein sk-..., den du in der MoleAPI-Konsole erstellt hast?
Ist der Modellname ein Modell, das in der aktuellen Gruppe verfügbar ist?
Unterstützt der Client OpenAI-kompatible Schnittstellen?

Wenn du all das bereits geprüft hast und es trotzdem noch fehlschlägt, solltest du dir anschließend detailliertere Logs und Fehlercodes ansehen.

Empfehlungen für häufige Szenarien

Szenario 1: Integration in Drittanbieter-Clients

Zum Beispiel bei Tools wie Chatbox, NextChat, 沉浸式翻译 oder Cherry Studio:

Trage bevorzugt https://api.moleapi.com/v1 ein
Trage als API Key dein sk-... ein

Szenario 2: Integration mit dem OpenAI SDK

Egal ob Node.js, Python oder ein anderes OpenAI-kompatibles SDK: In der Regel solltest du ebenfalls bevorzugt Folgendes eintragen:

https://api.moleapi.com/v1

Szenario 3: In der Fehlermeldung erscheint `api.openai.com`

Das bedeutet in der Regel, dass deine Anfrage MoleAPI gar nicht erreicht hat, sondern weiterhin an die offizielle OpenAI-Adresse gesendet wird. Prüfe zuerst, ob die Base URL korrekt geändert wurde.