MiniMax API：五分鐘內發出第一個請求

安裝 OpenAI SDK

首先安裝您偏愛語言的官方 OpenAI SDK。該函式庫會自動處理請求格式化和串流。請確保已安裝 Python 3.8+ 或 Node.js 18+。執行 pip install openai（Python）或 npm install openai（Node）。SDK 簡化了與 /v1/chat/completions 端點的互動。它管理標頭、重試和 SSE 解析，讓你能專注於提示詞。這是因為我們的 API 遵循 OpenAI 聊天完成標準。你不需要自訂的客戶端函式庫。標準 SDK 方法直接對應我們的端點。這能減少整合時間並利用現有的開發者知識。

設定基礎 URL 與金鑰

將您的 API 金鑰與基礎 URL 設定至環境變數。我們的基礎 URL 為 https://api.minimaxapikey.com/v1。這讓您可以直接使用標準的 OpenAI 客戶端，無需修改。建立帳戶即可產生金鑰。金鑰會在註冊後立即顯示。試用無需綁定信用卡。請安全儲存金鑰。可透過標頭或環境變數傳遞。SDK 預設使用 OPENAI_API_KEY。您可以覆寫基礎 URL 以指向我們的伺服器。這可確保所有請求都發送至無審查模型。透過簡單的 ping 測試金鑰是否運作。此步驟可避免後續的驗證錯誤。

發送基本聊天完成請求

發出第一個請求以產生文字。在 /v1/chat/completions 上使用 POST 方法。將模型指定為 uncensored。傳遞包含使用者提示詞的訊息陣列。API 會回傳完成 token。這是核心的文字生成功能。它支援 100k 上下文視窗。你可以發送長提示詞或對話歷史。回應包含生成的文字和 token 使用量。這非常適合創意寫作或無限制的對話。確保內容合法。該模型不會拒絕成人主題。它僅阻止涉及未成年人的性內容。從簡單開始以驗證連線。

啟用串流輸出 (SSE)

對於即時輸出，請啟用串流。將 stream 參數設為 true。API 會回傳伺服器發送事件（SSE）。每個區塊包含回應的一部分。這降低了感知延遲。使用者會看到文字隨著生成而出現。SDK 會自動處理區塊解析。你可以在 UI 中增量顯示文字。這對於聊天介面至關重要。串流適用於所有模型回應。它不影響 token 計數。每個區塊在結尾都包含使用資料。使用此功能以獲得更好的使用者體驗。它感覺比等待完整回應更具回應性。配置你的客戶端以正確緩衝區塊。

使用工具/函式呼叫

支援使用函式呼叫的結構化輸出。在請求主體中定義工具。模型可以根據提示詞呼叫函式。這允許與外部系統整合。傳遞工具定義和使用者訊息。回應包含一個工具呼叫物件。執行函式並將結果回傳。這與標準 OpenAI SDK 相容。它允許複雜的工作流程。你可以建構代理程式或助手。模型在呼叫之間保持上下文。這對於自動化非常強大。確保你的工具定義精確。API 處理工具輸出的路由。它保持對話連貫。使用此功能進行動態內容生成。

檢查可用模型

透過 GET /v1/models 驗證模型列表。此端點回傳可用模型。我們的 API 提供一個模型：uncensored。它是一個開放權重模型。它不是 GPT、Claude 或 Gemini。回應確認模型 ID。使用此功能除錯用戶端配置。確保你的程式碼針對正確的模型。該端點快速且可靠。它回傳 JSON 資料。你可以解析此資料以顯示在 UI 中。它確認你的 API 金鑰有效。使用此功能進行自動化健康檢查。這是標準 OpenAI 規格的一部分。不需要額外的配置。這確保與現有工具的相容性。

cURL

Copycurl https://api.minimaxapikey.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
  }'

Python

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.minimaxapikey.com/v1", api_key="YOUR_KEY")

resp = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)

Node.js

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.minimaxapikey.com/v1", apiKey: process.env.API_KEY });

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);

串流輸出

Copystream = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Tell the story in second person."}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)