MiniMax M3 已可透過 Novita AI 使用，模型 ID 為 minimax/minimax-m3，並提供與 OpenAI 相容的基礎 URL、1,000,000 token 的上下文視窗，以及針對長提示的階梯式定價。本快速入門將設定步驟精簡為實作導向：複製模型 ID、設定 API 金鑰、執行一個小型請求，待基本功能驗證通過後再擴展至更長的提示。
何時使用此快速入門
若您希望透過無伺服器 API 路徑測試 MiniMax M3，而非自行搭建原始模型託管環境，請使用此快速入門。本指南適合已有明確提示或工作負載的開發者，他們需要先取得端點、模型 ID、Token 限制與定價細節，再撰寫小型概念驗證程式。
當您的請求需要較大的上下文預算、結構化輸出、工具導向任務或長篇程式碼輔助時，MiniMax M3 是非常合適的選擇。在 Novita AI 上，目前的模型頁面列出支援的輸入模態為 text、image 與 video，輸出模態為 text，並支援無伺服器存取、函式呼叫、結構化輸出、推理以及 Anthropic API 相容性。
本指南並非深入的效能評測或產品發布公告。目標更單純：完成一次乾淨的請求，然後判斷 MiniMax M3 是否適合您的應用。
步驟 1：取得您的 Novita API 金鑰
建立或選取您的 Novita AI 帳戶，開啟 API 金鑰設定頁面，產生一個僅供伺服器端使用的金鑰。請勿將金鑰放在客戶端程式碼、前端打包檔案、公開儲存庫或可能與團隊外分享的筆記本中。
執行範例前請先將金鑰設定為環境變數：
export NOVITA_API_KEY="your_api_key_here"
若您在團隊環境中測試，請使用限定範圍的專案金鑰；若您的帳戶設定支援，也可使用臨時金鑰。在公開展示、共享實驗或任何意外曝光後，請輪換金鑰。
步驟 2：確認模型 ID 與端點
在撰寫程式碼之前，請將 MiniMax M3 連線資訊整理如下：
| 欄位 | 值 |
| 模型 ID | minimax/minimax-m3 |
| 基礎 URL | https://api.novita.ai/openai |
| 聊天完成 URL | https://api.novita.ai/openai/v1/chat/completions |
| 上下文視窗 | 1,000,000 token |
| 最大輸出 | 131,072 token |
| 輸入 | 文字、圖片、影片 |
| 輸出 | 文字 |
| 無伺服器支援 | 支援 |
| 函式呼叫 | 支援 |
| 結構化輸出 | 支援 |
| 推理 | 支援 |
| Anthropic API 相容性 | 支援 |
在上線前請查閱 MiniMax M3 模型文件，因為可用性、定價與限制可能會變動。
步驟 3：發送您的第一個請求
先從簡短的純文字聊天請求開始。在加入大型提示之前，偵錯驗證、路由與回應解析會容易許多。
第一個提示請要求一個確定性高且容易檢查的輸出。例如：Summarize the main implementation risks in a long-context code review process.
首次呼叫時請將 max_tokens 設定在適中的數值。MiniMax M3 支援更長的輸出，但第一步是確認整合是否正常運作。
步驟 4：讀取回應
一個與 OpenAI 相容的聊天完成回應通常會將助理回答放在 choices[0].message.content。
同時請記錄請求 ID 或您執行環境所暴露的回應後設資料。當請求失敗或回應緩慢時，這些資訊會很有用。進行成本追蹤時，請記錄提示大小、輸出大小、若您的工作負載使用快取上下文則記錄快取讀取用量，以及請求是否進入長上下文定價區段。
不要將第一次輸出視為提示已可給使用者使用的證明。一旦整合正常，請使用與您真實工作負載相似的提示進行測試：長篇程式碼庫、多檔案指令、工具綱要、結構化 JSON 輸出，或若您的應用需要則包含多模態輸入。
步驟 5：檢查定價、限制與常見錯誤
MiniMax M3 在 Novita AI 上採用階梯式定價。當提示進入長上下文區段時價格會改變：
| 提示大小區段 | 輸入 | 輸出 | 快取讀取 |
| 少於 524,288 token | 每 1M token $0.30 | 每 1M token $1.20 | 每 1M token $0.06 |
| 524,288 至 1,000,000 token | 每 1M token $1.20 | 每 1M token $4.80 | 每 1M token $0.24 |
這個區分很重要。一個 50,000 token 的測試與一個接近 1M token 的請求，定價方式不同。估算成本時，請納入提示長度、預期輸出長度、快取行為、重試次數以及使用者可能發送非常大請求的頻率。
MiniMax M3 目前提供 1,000,000 token 的上下文視窗與 131,072 token 的最大輸出。上線前請重新查閱 MiniMax M3 模型文件 以取得最新價格表以及附加在您帳戶上的任何速率限制指引。
常見的設定錯誤包括：
Authorization標頭遺失或格式錯誤。- 使用錯誤的模型 ID，例如顯示名稱而非
minimax/minimax-m3。 - 將請求發送至錯誤的基礎 URL。
- 將
max_tokens設定得高於您的應用程式能安全承受的數值。 - 測試長上下文提示時未考慮較高的定價區段。
- 以您的客戶端函式庫不支援的格式傳遞多模態內容。
Python 範例
此範例使用 OpenAI Python SDK，搭配 Novita AI 與 OpenAI 相容的基礎 URL。
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["NOVITA_API_KEY"],
base_url="https://api.novita.ai/openai/v1",
)
response = client.chat.completions.create(
model="minimax/minimax-m3",
messages=[
{
"role": "system",
"content": "You are a concise API assistant for software teams.",
},
{
"role": "user",
"content": "Summarize the main implementation risks in a long-context code review process.",
},
],
temperature=0.2,
max_tokens=600,
)
answer = response.choices[0].message.content
print(answer)
使用 cURL 發送請求
若您偏好 cURL，請將 JSON 內容存放在 payload 變數中。這讓請求更容易閱讀，也避免將完整 JSON 塞進單一指令。
payload='{
"model": "minimax/minimax-m3",
"messages": [
{
"role": "system",
"content": "You are a concise API assistant for software teams."
},
{
"role": "user",
"content": "Summarize the main implementation risks in a long-context code review process."
}
],
"temperature": 0.2,
"max_tokens": 600
}'
curl --request POST "https://api.novita.ai/openai/v1/chat/completions" \
--header "Authorization: Bearer $NOVITA_API_KEY" \
--header "Content-Type: application/json" \
--data "$payload"
關鍵參數
| 參數 | 用途 | 建議起始值 |
model |
決定由哪個託管模型回答請求 | minimax/minimax-m3 |
messages |
系統與使用者指示 | 簡短的純文字提示 |
temperature |
輸出變異性 | 0.2 以便可重複測試 |
max_tokens |
最大生成輸出 | 設為較小值，之後再拉高 |
stream |
是否逐步串流回傳 token | 待基本呼叫成功後啟用 |
tools |
函式/工具定義 | 一次加入一個工具 |
response_format |
結構化回應的形狀 | 使用前先驗證輸出 |
針對多模態輸入，請在依賴圖片或影片提示之前，確認您的 SDK 或 API 文件中的確切請求格式。模型頁面會列出模態支援，但請求格式取決於您使用的客戶端路徑。
疑難排解
身分驗證失敗
檢查 NOVITA_API_KEY 是否設定在執行請求的同一 shell 或執行階段中。授權標頭必須使用 Bearer token 格式。
API 找不到模型
確認請求使用的是 minimax/minimax-m3，而非 MiniMax M3、minimax-m3 或文章標題。模型顯示名稱與模型 ID 不可互換。
短提示可正常運作，但長提示失敗
請測量序列化後的輸入大小，而不僅僅是可見的字數。工具綱要、檢索文件、圖片參考與對話歷史都會計入。若您接近 1,000,000 token，請嘗試較小的提示，並在重試前加入截斷或檢索邏輯。
帳單高於預期
檢查提示是否進入了 524,288 至 1,000,000 token 的定價區段。MiniMax M3 在長上下文層級有較高的輸入、輸出與快取讀取價格。
結構化輸出不一致
從較小的綱要、較低的溫度以及明確的驗證開始。若您的應用需要嚴格的 JSON，請以驗證與重試邏輯處理格式異常的回應，而非假設每個回應都能成功解析。
工具呼叫與您的函式綱要不符
一次測試一個工具。保持函式名稱、描述與參數綱要清晰，並在執行任何工具呼叫前加入伺服器端驗證。
常見問題
MiniMax M3 可以透過 Novita AI API 使用嗎？
可以。目前的 Novita AI 模型頁面列出 MiniMax M3 可透過無伺服器 API 存取，模型 ID 為 minimax/minimax-m3。
MiniMax M3 的模型 ID 是什麼？
請使用 minimax/minimax-m3。
應使用哪個基礎 URL？
請使用 https://api.novita.ai/openai 作為與 OpenAI 相容的基礎 URL。在 OpenAI SDK 中，請將 SDK 的基礎 URL 設為 https://api.novita.ai/openai/v1。
MiniMax M3 在 Novita AI 上的費用為何？
MiniMax M3 採用階梯式定價。提示少於 524,288 token 時，輸入每 1M token $0.30，輸出每 1M token $1.20，快取讀取每 1M token $0.06。提示在 524,288 至 1,000,000 token 時，輸入每 1M token $1.20，輸出每 1M token $4.80，快取讀取每 1M token $0.24。
MiniMax M3 是否支援串流或多模態輸入？
目前的模型頁面列出文字、圖片與影片輸入，並輸出文字。串流行為應先透過與 OpenAI 相容的聊天完成路徑進行測試，再投入正式環境。
最大上下文視窗是多少？
MiniMax M3 目前提供 1,000,000 token 的上下文視窗，最大輸出為 131,072 token。
