繁中 ▾

MiniMax API 設定:金鑰、Base URL 與首次請求

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

更新

六個發光步驟從金鑰連接到伺服器機架,代表 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:建立帳戶並領取試用

  1. 開啟金鑰頁面。 前往 API 金鑰頁面 並登入。你可以使用 Google,或電子郵件地址和密碼。
  2. 領取試用額度。 完成註冊後,金鑰頁面有一個按鈕可領取 $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。這就是整個設定過程。

取得 API 金鑰