Compatibilidad con SDK oficiales

MoleAPI es compatible con los principales SDK con estilo OpenAI. Normalmente solo necesitas sustituir dos elementos:

apiKey
baseURL

Cuándo conviene usar directamente el SDK

Si encajas en cualquiera de los siguientes escenarios, normalmente deberías dar prioridad al SDK oficial en lugar de construir manualmente las solicitudes HTTP:

Ya estás desarrollando tu negocio con Python / Node.js
Más adelante vas a conectar salida en streaming, imágenes, audio o tool calling
Quieres manejar menos detalles de bajo nivel de las solicitudes y poner la funcionalidad en marcha primero

Una forma sencilla de decidir

Si solo quieres verificar que la cuenta funciona, usa primero cURL; si vas a integrar la capacidad en tu proyecto, prioriza directamente el SDK.

Ejemplo en 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 todavía no has configurado la variable de entorno, puedes ejecutar primero en la terminal actual:

$env:MOLEAPI_KEY="sk-xxxxxxxxxxxxxxxx"

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

En Node.js también se recomienda leer la Key mediante variables de entorno, en lugar de escribir la clave real en el código fuente o subirla al repositorio.

Problemas de compatibilidad más frecuentes

baseURL apunta a la dirección de otra plataforma o falta /v1
La variable de entorno no se ha inyectado correctamente y la solicitud recibe en realidad un valor vacío
Al copiar el ejemplo, se ha arrastrado por error un nombre de modelo o un parámetro incompatible
Funciona en local, pero en el entorno de despliegue no se ha sincronizado la misma Key ni la misma Base URL

Orden de integración recomendado

Ejecuta primero el ejemplo más corto y verifica que funciona
Después, sustitúyelo por el modelo real que vas a usar en tu negocio
Por último, conecta salida en streaming, Retry, timeouts y logs

Así es más sencillo localizar el problema, porque podrás saber claramente si se trata de que “la integración con la plataforma no funciona” o de que “la lógica compleja del negocio ha introducido un problema nuevo”.

Solución de problemas habitual

Error 401: comprueba primero la API Key y las variables de entorno
Error 404: comprueba primero si baseURL incluye /v1
Error de modelo no disponible: comprueba el Group y los permisos del modelo