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 订阅处于有效状态。