MiniMax API 設定:金鑰、Base URL 與首次請求
這是 minimaxapikey.com 上 OpenAI 相容 API 的分步設定:帳戶、金鑰、Base URL、首次請求。這是獨立服務,並非任何模型供應商的官方 API。
更新

重點
- 使用 Google 或電子郵件註冊,然後在金鑰頁面領取 $0.50 的試用額度。不需要信用卡。
- Base URL 是 https://api.minimaxapikey.com/v1 ,模型 ID 是 uncensored,驗證方式是 Bearer 金鑰。
- 有兩種方法:POST /v1/chat/completions 和 GET /v1/models。
- 401 表示金鑰錯誤,429 表示達到速率限制,因此請檢查回應主體中的錯誤代碼。
你正在設定的內容
人們搜尋 minimax api setup 通常期待兩種結果:官方的 MiniMax 開發人員平台,或即插即用的 OpenAI 風格端點。本頁涵蓋第二種。minimaxapikey.com 背後的服務是由獨立供應商運營的託管式 OpenAI 相容文字 API,運行單一開放權重模型。它不是 MiniMax 或其他任何模型供應商的官方 API,也不跨供應商路由請求。如果你需要供應商自己的平台,請使用他們的網站。
你獲得的很簡單。只要更改 Base URL 和金鑰,任何 OpenAI SDK 或客戶端均可運作。有兩種方法,POST /v1/chat/completions 和 GET /v1/models,一個模型 ID uncensored,以及由提示詞和補全共享的 100,000-token 上下文視窗。它僅處理文字,因此沒有影像、音訊或影片生成、沒有嵌入向量也沒有微調。支援串流輸出、函式呼叫和 JSON 模式。
整個設定只需幾分鐘。以下步驟依序進行,每個步驟都有檢查點,讓你在繼續之前確認運作正常。
步驟 1 和 2:建立帳戶並領取試用
- 開啟金鑰頁面。 前往 API 金鑰頁面 並登入。你可以使用 Google,或電子郵件地址和密碼。
- 領取試用額度。 完成註冊後,金鑰頁面有一個按鈕可領取 $0.50的試用額度。只需一鍵點擊,無需綁定信用卡,有效期為 7 天,每人限領一次。
試用額度較小是故意的。每 1M 輸入 token 價格為 $0.15,每 1M 輸出 token 價格為 $0.50,$0.50 足以覆蓋許多測試請求。1,000 token 的提示詞搭配 500 token 的回答,輸入成本為 $0.00015,輸出成本為 $0.00025,總計 $0.0004。將 $0.50 除以該金額可得 1,250 次此類請求,因此你有足夠空間進行實驗。
注意試用金鑰的限制:2 個並行請求和每分鐘 60 個請求。完整金鑰(在你儲值後獲得)允許 8 個並行請求和每分鐘 300 個請求。如果你的測試迴圈並行執行並看到 429 錯誤,這是首先要檢查的。
步驟 3:建立金鑰並安全儲存
在同一頁面上建立 API 金鑰並複製它。將其視為密碼。將其放入環境變數或金鑰管理員中,不要放在儲存庫、前端套件或截圖中。如果金鑰洩漏,請移除它並建立新的金鑰。
# macOS / Linux
export UNCENSORED_KEY="paste-your-key-here"
# Windows PowerShell
$env:UNCENSORED_KEY = "paste-your-key-here"
伺服器端程式碼應在執行時讀取變數。瀏覽器程式碼應完全不持有金鑰:改為從後端發送請求,因為任何傳送到瀏覽器的內容對所有訪客都是可見的。
步驟 4:列出模型以確認金鑰
最便宜的測試是端點 models。它不會生成文字,因此是金鑰、URL 和網路的乾淨檢查。
curl -s https://api.minimaxapikey.com/v1/models \
-H "Authorization: Bearer $UNCENSORED_KEY"
你應該獲得包含 uncensored 的 JSON 列表。如果收到 401,表示金鑰錯誤或周圍有雜亂的空格或引號。如果連線失敗,請檢查 URL 是否以 /v1 結尾,以及你是否使用了 https。
步驟 5:發送首次聊天請求
現在進行真正的補全。主體是標準的聊天補全格式。
curl -s https://api.minimaxapikey.com/v1/chat/completions \
-H "Authorization: Bearer $UNCENSORED_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [
{"role": "user", "content": "Explain what an API key is in two sentences."}
],
"temperature": 0.7
}'
回覆包含 choices[0].message.content 和一個包含提示詞和補全 token 計數的 usage 區塊。也請查看回應標頭,使用 curl -i。你會看到 X-Request-Id,支援團隊可用它來查找你的請求,X-Balance-USD 是你的剩餘額度,以及速率限制標頭 X-RateLimit-Limit-Requests 和 X-RateLimit-Limit-Concurrency。
temperature、top_p、stop、seed 和懲罰參數會直接傳遞。max_tokens 是可選的。如果你省略它,補全可以使用視窗中剩餘的任何內容。
步驟 6:透過 SDK 進行相同呼叫
一旦 curl 運作正常,請轉向你實際使用的語言。從標準 OpenAI 設定中,只有兩個參數會變更。
from openai import OpenAI
import os
client = OpenAI(
base_url="https://api.minimaxapikey.com/v1",
api_key=os.environ["UNCENSORED_KEY"],
)
reply = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Give me three names for a hiking app."}],
)
print(reply.choices[0].message.content)
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.minimaxapikey.com/v1",
apiKey: process.env.UNCENSORED_KEY,
});
const reply = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Give me three names for a hiking app." }],
});
console.log(reply.choices[0].message.content);
進行串流輸出時,請加入 stream: true 並讀取伺服器發送的事件。用量數據會在串流結束時提供。文件頁面涵蓋了串流輸出、函式呼叫以及使用 response_format: {"type":"json_object"} 的 JSON 模式。
將現有的 OpenAI 專案遷移
大多數情況下,你想要連接的專案已經可以使用 OpenAI 的客戶端庫運作。在這種情況下,你幾乎不需要編輯程式碼。當你未傳遞參數時,官方 SDK 會讀取環境變數 OPENAI_API_KEY 和 OPENAI_BASE_URL,因此部署變更可能就足夠了。
export OPENAI_BASE_URL="https://api.minimaxapikey.com/v1"
export OPENAI_API_KEY="paste-your-key-here"
# then in your code, request model "uncensored"
剩下的唯一編輯是模型名稱。此處不會存在類似 OpenAI 模型 ID 的字串,因此請將其替換為 uncensored,最好透過設定值進行,以便你可以切換回去。然後閱讀程式碼,查看該服務未提供的功能。影像生成、音訊、嵌入向量和微調不可用,因為這是僅限文字聊天的 API。如果你的應用程式為了搜尋而呼叫嵌入向量,你需要另一家供應商處理該部分,並可以在此保留聊天功能。
了解模型也有幫助。它是單一開放權重模型,針對合法成人用途調整為無審查回答,且有一個硬性限制適用於所有設定:禁止涉及未成年人的性內容。為其他模型撰寫的提示詞可能需要小幅調整,因為每個模型對相同系統提示詞的反應不同。在切換真實流量之前,請並行運行你自己的測試提示詞。
第一天值得選擇的設定
在設定時做出的決定比在發布後更容易。這些決定都不難,但每個都能避免日後的意外。
- 系統提示詞。 將你關於語氣、格式和角色的指示放入
system訊息中。保持簡短具體,因為每個請求都會將其作為輸入 token 重複。 - Token 上限。
max_tokens為可選參數,但設定上限是一種廉價的防護機制。若未設定,單一回覆可能會耗盡 100,000 token 上下文視窗的剩餘空間。 - 互動使用的串流輸出。 如果有人正在等待回覆,請設定
stream: true。對於批次作業,普通請求更簡單。 - 429 的重試規則。 將 429 視為等待的信號,而非失敗。當回應包含
Retry-After: 5時,等待該時間長度並重試是正確的作法。 - 請求大小。 主體限制為 8 MB。這遠超過正常提示詞的需求,但貼上的日誌或文件可能會達到此限制。
提示詞不會用於訓練,這對於你計劃發送內部文件或使用者訊息很重要。你仍對發送內容負責,因此避免將模型不需要的機密放入提示詞中。
試用後儲值
試用用於檢查一切是否正常運作。當你準備好建構時,請增加預付額度。沒有訂閱制:你按使用的 token 付費,每 1M 輸入 token $0.15,每 1M 輸出 token $0.50,且額度永不過期,因此未使用的餘額不會在月底消失。
$20至 $500之間的整數金額皆可。儲值 $50可獲得 5% 的額外額度,儲值 $100可獲得 10%,儲值 $200可獲得 15%。以快速計算為例,$100儲值加上 10% 的額外額度後,總計為 $110額度。根據步驟二的 1,000 token 提示詞與 500 token 回答,每次請求成本為 $0.0004,因此 $110可支援 275,000 次請求。實際提示詞通常更長,請根據你的平均長度調整此數值。
修正常見設定錯誤
| 症狀 | 可能原因 | 修復方法 |
|---|---|---|
| 每次呼叫都出現 401 | 遺失、輸入錯誤或撤銷的金鑰 | 發送 Authorization: Bearer <key>,不要有多餘的引號 |
| 404 或 HTML 回應 | 路徑錯誤,通常是缺少 /v1 | 使用以 /v1 結尾的完整 Base URL |
| 找不到模型 | 從其他供應商複製的模型名稱 | 使用 uncensored |
429 錯誤且rate_limited | 超過每分鐘請求上限 | 減慢速度,或儲值以從試用限制移至完整限制 |
429 錯誤與 concurrency 相關 | 同時請求過多 | 將並行呼叫限制在 8 個(試用金鑰為 2 個) |
429 帶有 Retry-After: 5 | 暫時過載 | 等待 5 秒後重試 |
| 413 或拒絕請求主體 | 請求超過 8 MB | 精簡提示詞或拆分任務 |
當你準備好使用超過試用額度的服務時,定價頁面列出了儲值選項:$20 到 $500 之間的任意整數金額,可透過加密貨幣(TRC20 上的 USDT、Base 上的 USDC)支付,$50 起贈 5%、$100 起贈 10%、$200 起贈 15%。失敗或被拒絕的請求不會收費,且提示詞不會用於訓練。
更多指南
問答
這是 MiniMax 官方 API 嗎?
否。這是一個獨立託管的 OpenAI 相容 API,提供單一開放權重模型,針對合法成人用途進行微調,以無審查方式回應。它並非任何模型供應商的官方 API,也不是跨供應商的轉發路由。
試用需要信用卡嗎?
否。註冊後,你可以在 API 金鑰頁面一鍵領取 $0.50 的試用額度。有效期為 7 天,每人限領一次。
請求中應使用的模型名稱是什麼?
使用 uncensored。該服務僅提供此單一模型 ID,GET /v1/models 將顯示該模型。
稍後如何增加額度?
儲值任意整數金額,範圍從 $20 到 $500。贈額從 $50 起算(+5%)、$100(+10%)及 $200(+15%),額度永不過期。
我可以使用 OpenAI SDK 嗎?
可以。將 base_url 設定為 https://api.minimaxapikey.com/v1 ,使用你的金鑰,並發送模型 uncensored。你的程式碼中其他部分無需更改。
只差一張表單,即可取得金鑰
建立帳號、複製金鑰、更改Base URL。這就是整個設定過程。