如何取得 Mimo API 金鑰？

使用 Google 或電子郵件與密碼註冊，然後開啟 API 金鑰頁面並複製你的金鑰。你可以在此一鍵領取 $0.50 試用額度，無需綁定信用卡。

API 金鑰是免費的嗎？

金鑰本身免費。新用戶可獲得 $0.50 的試用額度，有效期為 7 天，每人限領一次。之後需從預付額度按 token 付費，最低儲值金額為 $20。

試用額度有效期多久？

自領取之日起算七天。金額為 $0.50，無需信用卡，每人限領一次。之後的請求需使用儲值額度。

在請求中應如何放置金鑰？

放在 Authorization 標頭中，格式為 Bearer 後接金鑰。當你將金鑰作為 api_key 傳遞時，OpenAI SDK 會自動處理此動作。

Mimo API 金鑰：建立金鑰並發送請求

五個步驟建立金鑰

若要取得此服務的 Mimo API 金鑰，請按照以下步驟操作。此處不需要信用卡或撥打電話。

註冊。 使用 Google，或使用電子郵件地址與密碼註冊。
開啟金鑰頁面。 註冊後，前往 API 金鑰頁面。你的金鑰將顯示在該頁面。
領取試用額度。 新用戶可以在該頁面一鍵領取 $0.50 的試用額度。該額度有效期為 7 天，無需信用卡，每人限領一次。
複製金鑰 並將其儲存在安全的地方，例如密碼管理器或環境變數中。
發送測試請求 使用下一節中的 curl 命令。

此服務為託管的 OpenAI 相容文字 API。它運行來自獨立供應商的單一開放權重模型，針對合法成人用途進行微調，以無內容拒絕的方式回答問題。它並非任何模型供應商的官方 API。你的金鑰適用於該單一模型，其 ID 為 uncensored，基礎 URL 為 https://api.mimoapi.top/v1。

使用一個請求測試金鑰

在將金鑰接入應用程式之前，請在終端機中進行測試。如果在此處失敗，問題出在金鑰或帳戶上，你無需在自己的程式碼中搜尋。

export LLM_API_KEY="paste-your-key-here"

curl -i 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": "Write one sentence about keys."}],
    "max_tokens": 60
  }'

良好的結果是 200 狀態碼以及包含 choices 陣列的 JSON 主體。標頭包含 X-Request-Id、X-Balance-USD、X-RateLimit-Limit-Requests 和 X-RateLimit-Limit-Concurrency。餘額標頭是快速查看請求成本的捷徑：執行兩次並進行比較。如果你只想確認金鑰而不想花費任何金額，請使用相同的標頭呼叫 GET /v1/models。

使用官方 OpenAI 套件在 Python 中的相同請求：

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.mimoapi.top/v1",
    api_key=os.environ["LLM_API_KEY"],
)
resp = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Write one sentence about keys."}],
    max_tokens=60,
)
print(resp.choices[0].message.content)

試用金鑰能做什麼、不能做什麼

試用旨在測試，而非用於生產環境。試用金鑰允許 2 個並行請求和每分鐘 60 個請求，有效期為 7 天。完整金鑰（在儲值後取得）允許 8 個並行請求和每分鐘 300 個請求。兩者共用相同的模型、相同的 100,000 token 上下文視窗以及相同的功能：SSE 串流輸出、函式呼叫、JSON 模式和一般的採樣參數。

$0.50 能跑多少次請求？每 1M 輸入 token 價格為 $0.15，每 1M 輸出 token 價格為 $0.50。一個包含 1,000 個輸入 token 和 300 個輸出 token 的請求，輸入成本為 1,000 x $0.15 / 1,000,000 = $0.00015，輸出成本為 300 x $0.50 / 1,000,000 = $0.00015，總計 $0.0003。試用額度可覆蓋約 1,666 次此類請求（$0.50 / $0.0003）。這足以測試提示詞、建立原型以及嘗試串流或工具。

使用試用額度進行測量。選擇你的應用程式最常使用的五個提示詞，執行幾次，並記錄餘額變化。你將獲得每次請求的實際成本，並了解模型在你的資料上的表現。失敗或被拒絕的請求不會計費。

保持金鑰私密

API 金鑰也是一種密碼，且會消耗資金。任何擁有它的人都可以對你的餘額發送請求。幾條規則可防止大多數洩漏：

環境變數，而非原始碼檔案。 使用 os.environ 或 process.env 讀取金鑰。對於本地工作，列在 .gitignore 中的 .env 檔案即可。
僅限伺服器端。 不要從瀏覽器 JavaScript 或行動應用程式呼叫 API，因為任何人都可以從網頁或應用程式套件中讀取金鑰。在你的前端與 API 之間放置一個小型伺服器。
每支金鑰一個存放處。 將金鑰保存在一個金鑰庫中，並從中複製到每個部署環境，這樣你就能隨時知道它的位置。
不要在聊天、工單或截圖中包含金鑰。 當尋求協助時，請分享回應中的 X-Request-Id，而不是金鑰。
懷疑洩漏時立即更換。 如果你認為金鑰已洩露，請停止使用它並聯繫支援人員進行更換。

同時監控 X-Balance-USD 標頭。如果應用程式處於閒置狀態時餘額下降，這是其他人正在使用你金鑰的第一個跡象。

超越試用：儲值並付費

當試用額度耗盡時，請增加額度。$20 到 $500 之間的任意整數金額皆可。獎金會自動加入：$50 加贈 5%，$100 加贈 10%，$200 加贈 15%。因此，$100 儲值會獲得 $110 的預付額度，$200 則獲得 $230。你可以使用加密貨幣（TRC20 上的 USDT、Base 上的 USDC）付款。

沒有訂閱制。你根據餘額按 token 付費，且額度永不過期，這適合流量不均勻的專案。完整價目表位於定價頁面。透過 API 發送的提示詞不會用於訓練。

合理的初次儲值金額為 $20。以本頁前面使用的聊天大小請求為例（每次 $0.0003），這可覆蓋約 66,000 次請求。在幾天後檢查你自己的平均成本並進行調整。

金鑰無法運作時的故障排除

大多數金鑰問題都有簡單的原因。

立即出現身份驗證錯誤。 複製時遺失或添加了字元。查找前導或尾隨空格，或換行符。檢查標頭是否為 Authorization: Bearer 後接金鑰。
curl 正常，但應用程式不行。 應用程式可能沒有讀取環境變數。列印它所見值的前四個字元，而不是整個金鑰。
未找到。 基礎 URL 錯誤。必須是 https://api.mimoapi.top/v1，位於 api 子網域。快速入門指南提供了依客戶區分的列表。
HTTP 429。 程式碼 concurrency 表示同時請求過多；rate_limited 表示每分鐘請求過多。試用金鑰較早達到此限制（同時 2 個，每分鐘 60 個）。帶有 Retry-After: 5 的 429 表示短暫過載；等待五秒鐘。
試用額度遺失。 試用額度需在金鑰頁面點擊領取，每人限領一次。7 天後過期。

如果以上方法無法解決問題，請從失敗的回應中收集 X-Request-Id 值，並附上該 ID 聯繫支援人員。該 ID 允許追蹤問題，而無需你發送金鑰。

優先建構什麼

擁有有效的金鑰後，選擇一個使用你未來所需功能的小型專案。命令列聊天迴圈可教導訊息歷史。返回帶有 response_format 的 JSON 物件的腳本可教導結構化輸出。模型可呼叫的函式可教導工具使用。每個專案耗時不到一小時，且均可在試用額度上運行。如果你正在將此服務與其他託管模型進行比較，Mistral API 替代方案列出了在承諾之前值得詢問的問題。

保持使用合法且為成人用途。該模型經過調整，可無內容審查地回答問題，這是小說、角色扮演和研究的功能，但這並非允許違反規則：涉及未成年人的性內容永遠不被允許。