Unterstützung für offizielle SDKs

MoleAPI ist mit gängigen SDKs im OpenAI-Stil kompatibel. In der Regel müssen nur zwei Dinge ersetzt werden:

apiKey
baseURL

Wann sich die direkte Verwendung eines SDKs eignet

Wenn einer der folgenden Fälle auf dich zutrifft, solltest du in der Regel das offizielle SDK bevorzugen, statt HTTP-Requests manuell zusammenzubauen:

Du entwickelst bereits mit Python oder Node.js
Du möchtest später noch Streaming-Ausgabe, Bilder, Audio oder Tool-Aufrufe anbinden
Du möchtest dich möglichst wenig mit Details auf Request-Ebene beschäftigen und die Funktion zunächst zum Laufen bringen

Eine einfache Einschätzung

Wenn du nur prüfen willst, ob dein Konto funktioniert, verwende zuerst cURL. Wenn du die Funktionalität in ein Projekt integrieren möchtest, greife direkt zum SDK.

Python-Beispiel

from openai import OpenAI
import os

client = OpenAI(
    api_key=os.environ["MOLEAPI_KEY"],
    base_url="https://api.moleapi.com/v1",
)

resp = client.chat.completions.create(
    model="gpt-4o-mini",
    messages=[{"role": "user", "content": "用一句话说明 SDK 接入要点"}],
)

print(resp.choices[0].message.content)

Falls du die Umgebungsvariable noch nicht gesetzt hast, kannst du sie im aktuellen Terminal zuerst ausführen:

$env:MOLEAPI_KEY="sk-xxxxxxxxxxxxxxxx"

Node.js-Beispiel

import OpenAI from "openai";

async function main() {
  const client = new OpenAI({
    apiKey: process.env.MOLEAPI_KEY,
    baseURL: "https://api.moleapi.com/v1",
  });

  const res = await client.chat.completions.create({
    model: "gpt-4o-mini",
    messages: [{ role: "user", content: "Hello MoleAPI" }],
  });

  console.log(res.choices[0]?.message?.content);
}

main().catch(console.error);

Auch in Node.js wird empfohlen, den Key über Umgebungsvariablen zu lesen, statt den echten Schlüssel in den Quellcode zu schreiben oder ins Repository zu committen.

Die häufigsten Kompatibilitätsprobleme

baseURL wurde als Adresse einer anderen Plattform eingetragen oder /v1 fehlt
Die Umgebungsvariable wurde nicht korrekt injiziert, sodass beim Request tatsächlich ein leerer Wert verwendet wird
Beim Kopieren des Beispiels wurden versehentlich inkompatible Modellnamen oder Parameter übernommen
Lokal funktioniert es, aber in der Deployment-Umgebung wurden derselbe Key und dieselbe Base URL nicht synchronisiert

Empfohlene Integrationsreihenfolge

Zuerst das kürzeste Beispiel einmal erfolgreich ausführen
Dann durch das Modell ersetzen, das dein Anwendungsfall tatsächlich benötigt
Erst danach Streaming-Ausgabe, Retry, Timeout und Logging anbinden

So lassen sich Probleme am einfachsten eingrenzen, weil du klar erkennen kannst, ob „die Plattformintegration nicht funktioniert“ oder „die komplexere Business-Logik neue Probleme eingeführt hat“.

Häufige Fehlerbehebung

Bei 401: zuerst API Key und Umgebungsvariablen prüfen
Bei 404: vorrangig prüfen, ob baseURL /v1 enthält
Bei „Modell nicht verfügbar“: Group und Modellberechtigungen prüfen