官方 SDK 支援

MoleAPI 相容主流 OpenAI 風格 SDK。通常只需要替換兩項：

apiKey
baseURL

什麼時候適合直接使用 SDK

如果你符合下列任一情境，通常就應該優先使用官方 SDK，而不是自己手動拼 HTTP 請求：

你已經在用 Python / Node.js 開發業務
你之後還會接串流輸出、圖片、音訊或工具呼叫
你希望少處理底層請求細節，先把功能跑通

一個簡單判斷

如果你只是想驗證帳號可用，先用 cURL；如果你準備把能力接進專案，優先直接上 SDK。

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)

如果你還沒有設定環境變數，可以先在目前終端機執行：

$env:MOLEAPI_KEY="sk-xxxxxxxxxxxxxxxx"

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

在 Node.js 中同樣建議透過環境變數讀取 Key，而不是把真實密鑰寫進原始碼或提交到儲存庫。

最常見的相容性問題

baseURL 寫成了別的平台位址，或漏掉 /v1
環境變數沒有成功注入，導致請求時實際拿到的是空值
複製範例時順手帶上了不相容的模型名稱或參數
本機能通，但部署環境沒有同步相同的 Key 和 Base URL

建議的接入順序

先用最短範例跑通一次
再替換成你的業務實際要用的模型
最後再接串流輸出、重試、逾時和日誌

這樣最容易定位問題，因為你能清楚知道是「平台接入沒通」，還是「業務複雜邏輯引入了新問題」。

常見排錯

報 401：先檢查 API Key 和環境變數
報 404：優先檢查 baseURL 是否包含 /v1
報模型不可用：檢查分組和模型權限