Prise en charge officielle des SDK

MoleAPI est compatible avec les principaux SDK de style OpenAI. En général, il suffit de remplacer deux éléments :

apiKey
baseURL

Quand utiliser directement un SDK

Si vous êtes dans l’un des cas suivants, il est généralement préférable d’utiliser en priorité le SDK officiel plutôt que de construire vous-même des requêtes HTTP :

Vous développez déjà votre application en Python / Node.js
Vous prévoyez ensuite d’ajouter le streaming, les images, l’audio ou les appels d’outils
Vous souhaitez gérer moins de détails de bas niveau liés aux requêtes et faire fonctionner la fonctionnalité rapidement

Un critère simple

Si vous voulez simplement vérifier que votre compte fonctionne, commencez par utiliser cURL ; si vous préparez une intégration dans votre projet, privilégiez directement le SDK.

Exemple Python

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)

Si vous n’avez pas encore défini de variable d’environnement, vous pouvez d’abord exécuter dans le terminal actuel :

$env:MOLEAPI_KEY="sk-xxxxxxxxxxxxxxxx"

Exemple Node.js

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);

Dans Node.js également, il est recommandé de lire la Key depuis une variable d’environnement plutôt que d’écrire la clé réelle dans le code source ou de la soumettre au dépôt.

Problèmes de compatibilité les plus courants

baseURL pointe vers l’adresse d’une autre plateforme, ou /v1 a été omis
La variable d’environnement n’a pas été injectée correctement, ce qui fait que la requête reçoit en réalité une valeur vide
Lors de la copie d’un exemple, un nom de modèle ou un paramètre incompatible a été repris par erreur
Cela fonctionne en local, mais l’environnement de déploiement n’utilise pas la même Key ni le même Base URL

Ordre d’intégration recommandé

Exécutez d’abord l’exemple le plus court pour valider une première fois le fonctionnement
Remplacez ensuite par le modèle réellement utilisé par votre application
Ajoutez enfin le streaming, le Retry, les timeouts et les logs

De cette manière, il est plus simple d’identifier le problème, car vous pouvez clairement savoir s’il s’agit d’un “problème d’intégration à la plateforme” ou si une “logique métier plus complexe a introduit un nouveau problème”.

Dépannage courant

Erreur 401 : vérifiez d’abord l’API Key et la variable d’environnement
Erreur 404 : vérifiez en priorité si baseURL contient bien /v1
Modèle indisponible : vérifiez le Group et les autorisations du modèle