要複製的值
任何尋找 mimo api base url的人都需要三個值，其餘都是你所設定工具的細節。
| 設定 | 說明 |
|---|---|
| Base URL | https://api.mimoapi.top/v1 |
| 模型 ID | uncensored |
| Auth 標頭 | Authorization: Bearer YOUR_KEY |
| 聊天端點 | POST /v1/chat/completions |
| 模型列表 | GET /v1/models |
該服務與 OpenAI 相容，因此任何允許你變更 OpenAI base URL 和金鑰的客戶端都能運作。這是一個託管文字 API，由獨立供應商運行單一開放權重模型；它並非任何模型供應商的官方 API。僅支援文字：沒有影像、音訊或影片生成、沒有嵌入向量也沒有微調，因此預期這些端點的客戶端將找不到它們。如果你還沒有金鑰，金鑰頁面只需一分鐘即可完成。
Base URL 與完整端點
最常見的混淆在於 base URL 與端點 URL 之間。base URL 停在 /v1。端點是 base 加上路徑。官方 OpenAI SDK 和大多數基於它們建構的工具會自動將兩者結合。
- Base URL：
https://api.mimoapi.top/v1 - 聊天端點：
https://api.mimoapi.top/v1/chat/completions - 模型端點：
https://api.mimoapi.top/v1/models
當設定畫面要求「base URL」、「API base」、「endpoint」或「host」時，請閱讀其佔位符。如果佔位符以 /v1 結尾，請貼上 base URL。如果它以 /chat/completions 結尾，請貼上完整的聊天端點。將完整的端點貼入預期 base 的欄位會產生 /chat/completions/chat/completions，該路徑不存在。將裸網域貼入預期 base 的欄位會產生 /chat/completions 而缺少 /v1，同樣會失敗。
也要注意主機。API 位於 api 子網域上。一般網站網域用於提供網頁，因此對其發出帶有 API 路徑的請求將無法到達模型。
Python 與 Node
使用官方 SDK 時，你在建立客戶端時設定一次 base URL。使用 pip install openai 或 npm install openai 進行安裝。
from openai import OpenAI
client = OpenAI(
base_url="https://api.mimoapi.top/v1",
api_key="YOUR_KEY",
)
resp = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Name three uses for a base URL."}],
max_tokens=150,
)
print(resp.choices[0].message.content)import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.mimoapi.top/v1",
apiKey: process.env.LLM_API_KEY,
});
const resp = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Name three uses for a base URL." }],
max_tokens: 150,
});
console.log(resp.choices[0].message.content);Python 和 Node OpenAI SDK 也會讀取環境變數 OPENAI_BASE_URL 和 OPENAI_API_KEY，前提是你未在程式碼中傳遞值。這使得在不編輯腳本的情況下重新指向現有腳本成為可能：匯出這兩個變數，腳本就會連接到此 API。檢查腳本是否硬編碼了模型（例如 GPT 名稱）；將其替換為 uncensored。
使用 curl 進行快速測試
純 HTTP 呼叫消除了其他變數，因此是最好的初步檢查。第一個命令列出模型並確認金鑰。第二個發送聊天請求。
export LLM_API_KEY="YOUR_KEY"
curl -s https://api.mimoapi.top/v1/models \
-H "Authorization: Bearer $LLM_API_KEY"
curl -s https://api.mimoapi.top/v1/chat/completions \
-H "Authorization: Bearer $LLM_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"uncensored","messages":[{"role":"user","content":"ping"}],"max_tokens":20}' -i-i 旗標會印出回應標頭。請留意 X-Request-Id（若聯繫客服請引用此值）、X-Balance-USD（你的剩餘額度）以及兩個速率限制標頭 X-RateLimit-Limit-Requests 和 X-RateLimit-Limit-Concurrency。若要啟用串流輸出，請在請求主體中加入 "stream": true，並在 curl 指令中加入 -N 以避免緩衝輸出。五分鐘快速入門 將引導你完成串流輸出與函式呼叫的操作。
LangChain、聊天前端及其他工具
第三方工具使用自己的標籤，但它們都需要相同的三個值。你會看到的一些模式：
- LangChain (Python)：
ChatOpenAI(model="uncensored", base_url="https://api.mimoapi.top/v1", api_key="YOUR_KEY")。該類別適用於任何與 OpenAI 相容的伺服器。 - SillyTavern 和類似角色扮演前端： 選擇自訂或通用的 OpenAI 相容聊天來源，貼上 base URL，新增金鑰，如果列表未自動填充，請輸入
uncensored作為模型名稱。 - Open WebUI 和其他自託管聊天 UI： 在設定中新增與 OpenAI 相容的連線，使用相同的 base URL 和金鑰。
- 編輯器外掛和腳本： 在外掛設定中尋找「custom OpenAI endpoint」或「override base URL」。
每個工具的選單名稱會隨版本變化，因此請依賴欄位的用途而非確切的標籤。如果工具堅持向固定供應商檢查金鑰，則它不與自訂端點相容，此時應改用其他工具。
當工具提供模型下拉選單時，它通常透過呼叫 GET /v1/models 來填充。如果下拉選單保持空白，請手動輸入模型 ID。如果工具拒絕未知的模型名稱，請尋找標示為「custom model」的選項。
修正常見的設定錯誤
當請求失敗時，狀態碼和確切的 URL 能快速縮小原因。請依此清單逐步檢查。
- 驗證錯誤。 金鑰遺失、被截斷或在末尾有空白或換行符。重新貼上，並確保標頭讀取
Bearer、一個空白字元，然後是金鑰。 - 找不到。 路徑有誤。列印客戶端建構的最終 URL。它應該完全等於
https://api.mimoapi.top/v1/chat/completions。尋找缺少的/v1、重複的路徑或錯誤的主機。 - 未知模型。 來自其他供應商的殘留模型名稱。將模型設定為
uncensored。 - HTTP 429 帶有
rate_limited或concurrency。 你超過每分鐘 300 次請求或同時 8 次請求（試用金鑰為 60 次和 2 次）。減慢速度或排隊請求。帶有Retry-After: 5標頭的 429 表示暫時過載；等待五秒後重試。 - 請求過大。 請求主體限制為 8 MB，上下文視窗為提示詞加上補全共 100,000 token。精簡歷史記錄。
- curl 正常，但在瀏覽器中失敗。 從前端 JavaScript 直接呼叫 API 會向每位訪客暴露你的金鑰。請透過你自己的伺服器路由請求。
切勿將金鑰放在公開儲存庫或客戶端套件中。將其儲存在環境變數中，並避免出現在螢幕截圖和支援票證中。
首次成功呼叫後的後續步驟
一旦 base URL 運作正常，以下設定值得了解。透過 SSE 的串流輸出使用 stream: true 開啟。工具呼叫使用 tools 和 tool_choice，結果以 role: "tool" 訊息傳回。JSON 模式為 response_format: {"type": "json_object"}。採樣控制（如 temperature、top_p、stop、seed）和懲罰機制會直接傳遞。
費用方面，你需從預付額度中支付每 1M 輸入 token $0.15 以及每 1M 輸出 token $0.50；定價頁面 列出了儲值方案與贈額。該模型經過調整，能以無審查方式回答以符合合法成人用途，但絕不允許涉及未成年人的性內容。提示詞不會用於模型訓練。
