# 供應商

Provider 實作位於外部模組 **[`go-llm-router`](https://github.com/pardnchiu/go-llm-router)**（v0.8.2），由 Agenvoy 抽出獨立維護。Agenvoy 一律透過 `router.New(cfg)` 建立 agent，並只呼叫單一 `Agent.Send()` 介面——本 repo 內已無任何 per-vendor 實作。

## 支援清單

共 11 家廠商。v1.0.22 起 TUI `/model add` 選單分三個分頁（←/→ 切換），每條認證路徑各佔一列：**OAuth** —— Claude Code（`claude-code`，v1.1.0 起）、OpenAI Codex（`codex`）、Grok (xAI)（`grok-oauth`）、GitHub Copilot（`copilot`）；**API Key** —— OpenAI、Claude、Gemini、Grok、DeepSeek、Mistral、NVIDIA NIM、Ollama Cloud、OpenRouter；**Custom** —— Cloudflare、Local/Custom（`compat`），以及在預設 port 偵測到的本機 Ollama / llama.cpp 端點。固定列共 15 列（v1.0.22 為 14 列）。v1.0.22 之前是單一 12 列清單，選 OpenAI 或 Grok 後會再跳出 *method* 選單決定 API key 或訂閱。在某列按 `o` 會開啟該供應商的 console（API key 頁面；訂閱制則為方案頁面）。`GET /v1/providers` 則把同一組攤平為 14 個條目，讓 `claude-code`、`codex` 與 `grok-oauth` 各有自己的 ID，API client 可直接指定某一條認證路徑；`compat` 併列其後為第 15 筆。每筆另帶 `logged_in`，僅對四條訂閱路徑（`claude-code`、`codex`、`grok-oauth`、`copilot`）有意義；`console` 列出 `GET /v1/provider/:provider/console` 可轉址的 console 頁面；`hidden` 在 `claude-code` 未啟用時為 true。

| 供應商 | ID | 認證 | 說明 |
|---|---|---|---|
| OpenAI | `openai` · `codex` | API key **或** OAuth | API key 走 Chat Completions / Responses；OAuth 路徑使用 ChatGPT / Codex 訂閱，不需 API key，以 SSE 串流 |
| Anthropic Claude | `claude` · `claude-code` | API key **或** OAuth（Claude Code） | API key 走 Messages API，預設啟用平行 tool use。`claude-code` 透過本機 `claude` CLI 使用 Claude 訂閱——見 [Claude Code](#claude-code) |
| Google Gemini | `gemini` | API key | gemini-2.x / 3.x 系列 |
| xAI Grok | `grok` · `grok-oauth` | API key **或** OAuth | API key 為按量計費；OAuth 路徑使用 xAI 訂閱 |
| GitHub Copilot | `copilot` | OAuth | Device-code 登入流程，使用 GitHub 訂閱。v1.0.25 起 context window 取自 Copilot models API（`max_context_window_tokens`，快取 24 小時），不再套用一般的 128K 預設 |
| DeepSeek | `deepseek` | API key | Flash 與 Pro 系列（例如 `deepseek-v4-pro`），清單即時取自 `api.deepseek.com/v1/models`；`deepseek-chat` / `deepseek-reasoner` 已下架 |
| Mistral | `mistral` | API key | Mistral 自家託管模型 |
| NVIDIA NIM | `nvidia` | API key | Nemotron、Llama、Mistral 等託管開源權重模型；免費額度不需綁定付款方式 |
| Ollama Cloud | `ollama-cloud` | API key | Ollama 託管模型；額度以百分比顯示 |
| OpenRouter | `openrouter` | API key | 聚合器——單一 key 路由到多家供應商的模型 |
| Cloudflare | `cloudflare` | API token + account ID | Workers AI；可選填 gateway ID |