Oh My Pi

在 ~/.omp/agent/models.yml 中設定供應商區塊 — baseUrl、api、apiKey — 將 Oh My Pi 指向 Kunavo，並透過 GET /v1/models 自動填入模型清單。

providers:
  kunavo:
    baseUrl: https://api.kunavo.com/v1
    api: openai-completions
    apiKey: KUNAVO_API_KEY       # an env-var name; literal text also works
    discovery:
      type: openai-models-list   # reads GET /v1/models

# Prefer a fixed list to a discovered one? Drop the discovery block and
# declare ids instead. Omitted metadata defaults to a 128,000-token context
# window and a 16,384-token output limit, so set the real numbers from
# /models when they differ.
#
#     models:
#       - id: claude-sonnet-5
#         name: Claude Sonnet 5
#         contextWindow: ...
#         maxTokens: ...

逐步操作

1. 在 /app/keys 建立金鑰並複製——金鑰只會顯示一次。
2. 在啟動 omp 的 Shell 中將它匯出為 KUNAVO_API_KEY。omp 會先將 apiKey 解析為環境變數名稱，若找不到才會將文字視為實際金鑰，因此環境變數名稱打錯時不會有提示，直到第一次請求才會失敗。若值以 ! 開頭，則會被當作 Shell 命令執行 — 這是 1Password 風格的設定方式。
3. 將上方區塊放入 ~/.omp/agent/models.yml。此處的供應商 ID — kunavo — 由您自行選擇，並會成為每個選擇器的前半部分。
4. 執行 omp models kunavo 載入檔案，並只列出此供應商。如果 YAML 或結構描述有問題，輸出會指出 models.yml validation failed 及發生錯誤的欄位；omp models refresh kunavo 則會強制重新探索，不使用快取的型錄。
5. 使用完整選擇器進行測試：omp -p --model kunavo/claude-sonnet-5 "Reply with only OK"。接著啟動 omp，輸入 /model，並將您要的 ID 指定為 Default — 模型中心會在開啟時重新載入 models.yml。/switch 只會變更目前的工作階段。

已於 2026年9月21日 根據 omp 的 Providers 頁面 進行確認。第三方設定會變動；如果這裡的欄位名稱不再與你看到的內容相符，應以該頁面為準，而不是本頁。

除錯用戶端前先驗證

一個請求就能判斷失敗原因是端點、金鑰還是設定檔。如果這裡回傳 JSON，則相同的基礎 URL 與金鑰在 Oh My Pi 中也能運作。

# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

欄位中應填入哪個模型 ID

每個文字模型都能以模型 ID 存取——即時清單位於 GET /v1/models，帶有價格的目錄位於模型頁面。費率是每 1M 權杖的美元價格，輸入／輸出。

探索：使用哪種類型，以及哪些模型會出現在選擇器中

omp 提供六種 discovery.type 值，其中兩種看起來都適用於閘道，但實際上只有一種。文件指出，proxy 適用於「模型列以 supported_endpoint_types 標示的 OpenAI/Anthropic 混合代理」，而且會依該欄位決定各模型的傳輸格式。Kunavo 的 GET /v1/models 不會發布此欄位，因此在 proxy 下，每一列都會退回使用提供者層級的 api——若未設定任何值，則會被略過。文件將 openai-models-list 說明為「通用的 OpenAI 相容 GET /v1/models 端點」，這才是應使用的選項，也因此上方的區塊保留了 api: openai-completions：omp 的規則是「除了 proxy 之外，探索功能都需要提供者層級的 api」。

在開啟選擇器前，有一項後果值得先了解。Kunavo 的模型清單包含所有已啟用的型錄，因此探索到的供應商會同時列出圖片、影片和音樂 ID，以及聊天模型；但聊天傳輸方式無法呼叫這些媒體模型。Kunavo 會在聊天模型列中提供 context_length — 根據 omp 的模型文件，這是其通用探索在 max_model_len 之後讀取的欄位 — 但媒體模型列不會提供此欄位，因此 omp 會為它們使用預設的 128,000 token，而非實際數值。如果您想要一份精簡且正確的選擇器清單，請移除探索區塊，並明確宣告您實際使用的三、四個 ID。

omp 也支援 anthropic-messages，而 Kunavo 會回應 /v1/messages。本頁不會為這種搭配提供設定區塊：此處引用的兩份文件只確定了 OpenAI 相容路由的基礎 URL 格式，並未說明 Anthropic 路由如何處理結尾的 /v1；而設定區塊的目的，就是讓讀者能直接貼上使用。如果您選擇這種方式，Anthropic 相容端點上的工具呼叫遇到 400 錯誤時，文件建議的處理方式是 disableStrictTools: true。