MINARALLM 提供商
Minara 支持的七個模型提供商，以及 Minara 目錄上的 Auto：API key 與 OAuth 路徑、計費風險和選擇建議。
Minara 需要一個 LLM 提供商來進行推理。一共有七個提供商家族。多數家族提供兩種登錄方式：API key（按 token 付費）或 OAuth（複用你已經付費的訂閱）；少數是單一方式：Kimi 與 Ollama Cloud 僅支持 API key，Minara 是內置平臺賬戶，僅支持 OAuth。本頁講清楚其中的取捨、計費風險，以及如何選擇。實際的登錄命令見 安裝；變量名見 環境變量。
一覽
| 提供商 | API key 路徑 | OAuth 路徑 | OAuth 運行在 | OAuth 可用模型 | 計費 |
|---|---|---|---|---|---|
| Minara | ： （無） | minara-oauth | 你的 Minara 賬戶 | Auto，以及 Minara 網關提供的模型 | 通過你的 Minara 賬戶計費。 |
| Anthropic | anthropic-api-key | anthropic-oauth | Claude Max 加額外用量積分 | Claude 模型 | API key：按 token 付費。OAuth：消耗你購買的額外用量積分。 |
| OpenAI | openai-api-key | openai-oauth（Codex） | ChatGPT 訂閱，經由 Codex 後端 | 僅 Codex 支持的模型 | API key：按 token 付費。OAuth：包含在你的 ChatGPT 套餐內。 |
| OpenRouter | openrouter-api-key | openrouter-pkce | OpenRouter 賬戶餘額 | 300+ 模型，覆蓋各家廠商 | 兩種路徑都從 OpenRouter 餘額扣費。 |
| Kimi | kimi-api-key | （無） | （無） | （無） | 通過你的 Kimi API 賬戶按 token 付費。 |
| xAI（Grok） | xai-api-key | xai-oauth | SuperGrok 或 X Premium+ 訂閱 | Grok 模型 | API key：按 token 付費。OAuth：包含在你的 X 訂閱內。 |
| Ollama Cloud | ollama | ： （無） | — | ： | 免費額度（有上限），另有付費 Turbo。Minara 不按 token 計費。 |
怎麼選：API key 還是 OAuth
API key 是一個用量計量器。你用多少付多少，提供商的全部模型都可用。這條路徑人人可用。
OAuth 複用你已經買好的訂閱。你不會另外收到一份按 token 計的賬單。代價是隻有部分模型可用，也有套餐限額。每家提供商的 OAuth 路徑都有自己的坑，下面分別說明。
選擇模型和推理強度
使用對話輸入框中的模型控件選擇模型和推理強度。模型與推理強度均在對應的二級選單中選擇，選單位置和交互方式保持一致。
選擇結果屬於當前對話會話。Minara 會在下一條消息中使用該設置，並在該對話的後續輪次繼續沿用。它不會替換正在生成的回覆，也不會修改部署級默認模型。
在 Minara 提供商上，從 Auto 開始。它會為每則訊息評分，再為這一輪挑選目錄模型。下一節說明策略。你仍可在輸入框裡釘住某個具名模型。目前工作階段的選擇會優先用於該對話的後續訊息。
Minara
Minara 是內建平台帳戶。用 minara-oauth 登入。用量透過你的 Minara 帳戶計費。目錄就是 Minara 閘道目前提供的模型。
Auto
Auto 是 Minara 上的建議模型。在對話輸入框裡選一次即可。Minara 會為下一則訊息評分，再路由到符合這一輪的目錄模型。
查行情會走又快又便宜的模型。寫市場備忘、跑自動化、走實盤下單路徑、改程式時，Auto 會升檔。小事保持敏捷，動資金或交程式的工作保持精度。
這正是 Minara 的本職：金融分析、排程與 Agent 工作流程、交易執行、程式設計。保持 Auto 開啟，同一段對話就能覆蓋這些。路由只在這一輪值得時才多花錢。
選中 Auto 後，設定（提供商與模型）裡會出現三個策略。使用者已儲存的設定優先於 MINARA_AUTO_MODEL_STRATEGY。背景標題與壓縮模型仍在「背景任務模型」頁，不屬於 Auto。
| 策略 | 適用情境 | 預設對應 |
|---|---|---|
| balanced（預設） | 想用一個設定：輕任務保持快，分數升高時再加碼。 | SIMPLE/MEDIUM 用 DeepSeek V4 Flash（需要視覺或 PDF 時用 Claude Sonnet 5）。COMPLEX 用 GPT-5.6 Terra。REASONING 用 GPT-5.6 Sol。 |
| economy | 想把額度用得更久。 | 輕任務仍走 Flash。COMPLEX 用 GLM 5.2。REASONING 用 Kimi K3。 |
| quality | 每個難度都想用目錄裡最強的那一檔。 | 輕任務用 Claude Sonnet 5。COMPLEX 用 GPT-5.6 Terra。REASONING 用 Claude Opus 5。 |
想讓本工作階段後半段固定用某一個目錄模型時，直接釘住它。下一場對話裡 Auto 仍在選擇器裡。
Anthropic（Claude）
Anthropic 提供 Claude。
anthropic-api-key 把請求發送到 api.anthropic.com。從 console.anthropic.com 獲取一個 key，按 token 付費。全部 Claude 模型都可用。
anthropic-oauth 複用你的 Claude Max 訂閱。Minara 以 Claude Code 工具的方式登錄，所以 Anthropic 會把你的請求當作 Claude Code 活動來處理。
Anthropic OAuth 需要 Claude Max 加額外用量積分
minara auth login anthropic 以 Claude Code 的方式登錄。Anthropic 把這些請求當作 Claude Code 活動計費。這條路徑只在 Claude Max 套餐下可用。它消耗你在 Max 之上購買的“額外用量”積分。它不會動用你的 Max 基礎額度。沒有額外積分時，請求會失敗。有效的 Max 套餐也是如此。Claude Pro 無法使用這條路徑。如果你是 Pro，或者想按 token 付費，請改設 ANTHROPIC_API_KEY。
OpenAI
OpenAI 有兩種登錄方式，也兩者非常不同。
openai-api-key 把請求發送到 api.openai.com。從 platform.openai.com 獲取一個 key，按 token 付費。OpenAI 的完整陣容都可用，包括 gpt-5.5-pro、gpt-4.1 和 o3。
openai-oauth 是 Codex OAuth。Minara 通過 OpenAI Codex CLI 的設備流登錄，並以 Codex CLI 的身份出現。你的請求會發往 OpenAI 的第一方 Codex 後端 chatgpt.com/backend-api/codex，而不是 api.openai.com，並運行在你的 ChatGPT 訂閱上。
OpenAI OAuth 是 Codex OAuth，不是 OpenAI 平臺 API
minara auth login openai 以 OpenAI Codex CLI 的身份登錄。你的請求運行在你的 ChatGPT 訂閱上，經由 OpenAI 的 Codex 後端。這條路徑只支持 Codex 支持的模型。像 gpt-5.5-pro、gpt-4.1 和 o3 這樣的模型在這裡不可用。要使用 OpenAI 的完整陣容，請改用 OpenAI API key 登錄。
ChatGPT Codex 後端提供一份會輪換的允許列表。設置裡的 live catalog 是準繩。當前代模型包括：
gpt-5.6-terra（默認）gpt-5.6-solgpt-5.6-luna
更早的 *-codex slug（例如 gpt-5.3-codex）在後端下架後會返回 HTTP 400。
在設置裡，模型選擇器始終顯示 OpenAI 的完整陣容。你已連接的賬戶跑不了的模型會變灰，並附上簡短原因。在 ChatGPT 登錄下，非 Codex 模型會一直變灰，直到你連接一個 OpenAI API key。如果你同時連接了 ChatGPT 登錄和一個 API key，你可以任選模型。選中一個需要另一個賬戶的模型時，系統會自動為你切換當前連接。
OpenRouter
OpenRouter 是通往 300+ 模型的單一入口，覆蓋眾多廠商（Anthropic、OpenAI、Google、Meta 等等）。兩種登錄路徑都從同一個 OpenRouter 餘額扣費。
openrouter-api-key 使用來自 openrouter.ai 的 key。openrouter-pkce 通過瀏覽器登錄，無需複製 key。無論哪種方式，Minara 都會附上歸屬請求頭，使你的用量在 OpenRouter 控制台裡被記到 Minara 名下。
OpenRouter 始終從你的 OpenRouter 餘額扣費
這裡沒有訂閱路徑。API key 和瀏覽器登錄都消耗你在 OpenRouter 賬戶裡充值的餘額。長會話前請先充值。餘額歸零時，請求會停止，直到你再次充值。
Kimi
Kimi 是僅支持 API key 的提供商，直連 Kimi 官方 API 平臺。在 platform.kimi.ai 創建 key，然後運行 minara auth login kimi --api-key <key>，或設置 KIMI_API_KEY。
kimi-api-key 通過 OpenAI 兼容的 Chat Completions 接口向 https://api.moonshot.ai/v1 發送請求。模型列表來自 Kimi 官方 /v1/models 端點；冷啟動默認模型為 kimi-k2.6。流式輸出、工具調用、結構化輸出和 K2.6 推理內容回傳均受支持。某一輪必須指定單個工具時，Minara 會為該次請求關閉 K2.6 thinking，因為 Kimi API 在 thinking 開啟時只接受自動或禁用工具選擇。
xAI（Grok）
xAI 提供 Grok。
xai-api-key 使用來自 xAI 控制台的 key，在 api.x.ai 按 token 計費。xai-oauth 通過瀏覽器登錄，複用你的 SuperGrok 或 X Premium+ 訂閱。
xAI OAuth 需要 SuperGrok 或 X Premium+ 訂閱
這條路徑複用這些套餐附帶的 Grok 訪問權限。免費的 X 賬戶無法使用。沒有這些訂閱時，請改用 xAI API key。
Ollama Cloud
Ollama Cloud 在 Ollama 的託管服務器上運行開源模型（gpt-oss、DeepSeek、Qwen3-Coder、Kimi K2 等），所以你不需要本地 GPU。它只有一種登錄方式：API key。
ollama 通過 OpenAI 兼容端點把請求發送到 https://ollama.com。在 ollama.com/settings/keys 創建一把 key，然後運行 minara auth login ollama --api-key <key>（或設置 OLLAMA_API_KEY）。要指向自託管或本地的 Ollama，設置 OLLAMA_BASE_URL（例如 http://localhost:11434）或傳 --base-url。
Ollama Cloud 有免費額度上限和付費 Turbo 套餐
免費額度對運行量有上限。重度使用需要付費的 Turbo 套餐。觸及上限時，請求會失敗，直到額度窗口重置或你升級。Minara 不按 token 計費，所以這家提供商的成本面板顯示為零。
工具調用、視覺和 JSON 輸出取決於你選的具體雲端模型。較大的指令微調模型（例如 gpt-oss:120b）對工具支持良好；較小的模型可能不行。
我該選哪個？
| 你的情況 | 選這個 | 原因 |
|---|---|---|
| 你已用 Minara 登入，想要一個隨任務升級的模型 | Minara 提供商上的 Auto | 按訊息路由。輕任務快，分析、自動化、交易或程式時更強。 |
| 你付費用 Claude Max 並買了額外用量積分 | Anthropic OAuth（anthropic-oauth） | 複用你已擁有的積分，不產生新賬單。 |
| 你想用 Claude 但只有 Pro，或沒有訂閱 | Anthropic API key（anthropic-api-key） | Pro 無法用 OAuth 路徑。改為按 token 付費。 |
| 你付費用 ChatGPT，只需要編程級別的模型 | OpenAI OAuth（openai-oauth） | 運行在你的 ChatGPT 套餐上，無額外賬單。僅 Codex 模型。 |
你需要 gpt-5.5-pro、gpt-4.1、o3 或完整陣容 | OpenAI API key（openai-api-key） | OAuth 觸及不到這些。API key 可以。 |
| 你想試用來自不同廠商的多個模型 | OpenRouter | 一個賬戶，300+ 模型。 |
| 你已有 Kimi API 賬戶，想直連 Kimi 模型 | Kimi（kimi-api-key） | 官方直連、實時 Kimi 模型目錄，不經過聚合服務。 |
| 你想用 Grok 且付費用 SuperGrok 或 Premium+ | xAI OAuth（xai-oauth） | 複用你的訂閱。 |
| 你想用開源權重模型、只用一把託管 key、無需本地 GPU | Ollama Cloud（ollama） | 一把 key，不按 token 計費，可跑 gpt-oss / DeepSeek / Qwen。 |
| 你拿不準，想要最簡單的起步方式 | 任意 API key | 人人可用，全部模型可用，用多少付多少。 |
排錯
錯誤：out_of_credits 或餘額不足
你的提供商餘額用完了。OpenRouter 請到 openrouter.ai 充值。Anthropic OAuth 請在 Claude Max 套餐裡購買更多額外用量積分。API key 路徑請在提供商控制台里加錢或提高消費上限。
OpenAI OAuth 下某個模型返回 404 或 model not found
你請求了一個 Codex 後端不提供的模型。請從 live Codex 列表裡換一個，比如 gpt-5.6-terra，或者用 OpenAI API key 登錄以觸及完整陣容。
登錄被拒絕，或會話已過期
你保存的憑據無效或已過期。重新運行對應的 minara auth login <provider> 命令以刷新它。Anthropic OAuth 請確認你是 Claude Max 而非 Pro。OpenAI OAuth 請確認你的 ChatGPT 訂閱處於有效狀態。