開發者快速接入

如果你準備自己寫程式碼接入 MoleAPI，先記住這兩項：

Base URL：https://api.moleapi.com/v1
驗證方式：Authorization: Bearer <YOUR_API_KEY>

最常見的第一個介面是：

POST /chat/completions

第 0 步：先把兩個參數放到環境裡

建議不要把 API Key 直接寫死在程式碼裡，而是先放到環境變數。

PowerShell

$env:MOLEAPI_KEY="sk-xxxxxxxxxxxxxxxx"

Bash / zsh

export MOLEAPI_KEY="sk-xxxxxxxxxxxxxxxx"

為什麼先用環境變數

這樣你在切換本機測試、CI 和正式環境時，只需要替換環境設定，不用反覆修改原始碼。

cURL 範例

Bash / zsh

curl https://api.moleapi.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $MOLEAPI_KEY" \
  -d '{
    "model": "gpt-4o-mini",
    "messages": [
      {"role": "user", "content": "你好，请用一句话介绍 MoleAPI。"}
    ]
  }'

PowerShell

$headers = @{
  "Content-Type" = "application/json"
  "Authorization" = "Bearer $env:MOLEAPI_KEY"
}

$body = @{
  model = "gpt-4o-mini"
  messages = @(
    @{
      role = "user"
      content = "你好，请用一句话介绍 MoleAPI。"
    }
  )
} | ConvertTo-Json -Depth 5

Invoke-RestMethod -Method Post `
  -Uri "https://api.moleapi.com/v1/chat/completions" `
  -Headers $headers `
  -Body $body

如果請求成功，你通常會拿到一個 JSON 回應，裡面至少會包含：

id
model
choices[0].message.content

你只要能看到模型正常回傳文字，就表示最小接入鏈路已經跑通了。

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": "你好，请返回一句接入成功提示。"}],
)

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

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 resp = await client.chat.completions.create({
    model: "gpt-4o-mini",
    messages: [{ role: "user", content: "你好，请返回一句接入成功提示。" }],
  });

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

main().catch(console.error);

第一次跑通時，建議只驗證這 3 件事

請求能收到正常的 JSON 回應
回傳內容不是錯誤訊息
你使用的模型名稱和分組是目前可用的

等這一步穩定後，再逐步加上：

串流輸出
更長的上下文
工具呼叫
圖片、音訊等多模態能力

最小排錯順序

先確認 Base URL 和路徑正確
再確認 API Key 有效，且有目標模型權限
最後核對模型名稱和目前分組

建議先小後大

先用最短請求跑通，再逐步加入長上下文、串流輸出和更複雜的參數。

如果 cURL 能通，但你的專案程式碼不通

這通常表示平台本身沒問題，更可能卡在專案接入層。優先檢查：

程式碼裡是否真的讀取到了 MOLEAPI_KEY
SDK 設定中的 baseURL / base_url 是否仍指向其他平台
業務程式碼有沒有對請求位址做二次拼接
代理、Gateway 或伺服器端環境變數是否和本機不一致

下一步建議看什麼

除了傳統的 OpenAI chat/completions 介面外，MoleAPI 的部分模型還支援 OpenAI 最新的 responses 介面、Gemini 介面，以及 Anthropic 的請求介面。具體支援情況和呼叫方式可以前往 API 參考查看。

本頁目錄