文件

文件

Amp

Amp 會在伺服器端路由模型,因此你的電腦上不需要設定基底 URL 變數——你只需在 Model Routing 中新增 Custom URL 連線,由 Amp 雲端呼叫該端點。此功能僅開放給付費方案,請先確認你的方案。

在 Amp 的 Model Routing 中新增 Custom URL 連線 — API format 設為 chat-completions,base URL 為 https://api.kunavo.com/v1,金鑰作為 bearer token — 在支援該選項的層級上,將已對應的模型切換至同一個金鑰。

設定 → Model Routing → Add → Custom URL
Connection type    Custom URL            (Model Routing → Add)
API format         chat-completions      OpenAI Chat Completions API, the default
Base URL           https://api.kunavo.com/v1
Key                sk-kn-...             sent as Authorization: Bearer <key>
Headers            —                     nothing extra is needed
Query Parameters   —                     nothing extra is needed
Model mapping      anthropic/claude-opus-4-6 -> claude-opus-4-6
                   anthropic/claude-fable-5  -> claude-fable-5
                   openai/gpt-5.6-sol        -> gpt-5-6-sol
請先確認您的 Amp 方案級別。 Amp 的 Model Routing 頁面於 2026-09-21 說明:「AI 模型路由器和閘道目前仍屬實驗性質,僅開放給 Megawatt、Gigawatt 和 Enterprise 客戶搶先使用。我們很快會向所有人推出。」Custom URL 連線屬於此類功能,因此 Hobby 帳戶的 新增 選單不會提供此選項。Amp 未公布推出日期,本頁也不推測日期。
Kunavo 尚未使用此端點執行 Amp。上述欄位均取自 Amp 自己的說明文件,並非來自我們實際完成的工作階段——此功能僅對付費 Amp 方案開放。請將此內容視為對 Amp 規格的轉述,並以檢查存取權確認功能是否可用。
chat-completions 會在基礎 URL 保留 /v1 後綴,因為 Amp 只會附加路由。該頁的實例說明足以釐清這點:「基礎 URL 為 https://api.example.com/v1,搭配 chat-completions 時,請求會送至 https://api.example.com/v1/chat/completions。」同一頁也補充,結尾已含 /v1 的基礎 URL「會被接受,且不會重複附加」,而且連線表單會隨您輸入內容顯示請求 URL — 因此儲存前可以確認組合後的 URL。
Amp 的 Dictation 和 Realtime Voice 系統模型屬於語音功能,而 Kunavo 不提供任何語音轉文字或文字轉語音模型。此處的 Custom URL 連線無法支援這兩類功能;請保留 Amp 原有的對應設定。
還沒有金鑰?建立 Kunavo 帳戶,建立金鑰(以 sk-kn- 開頭),並從 $10 起新增額度——呼叫會從該餘額扣款,失敗的呼叫不會計費。之後儀表板會開啟 Amp 設定。

逐步操作

  1. 在 /app/keys 建立金鑰並複製——金鑰只會顯示一次。
  2. 在個人設定中開啟 Model Routing(工作區管理員可使用 Workspace Model Routing,與所有成員共用一個連線),開啟 Add 選單,並選擇 Custom URL。
  3. 將 API 格式設為 chat-completions,將 https://api.kunavo.com/v1 貼到 Base URL 欄位,並將您的 sk-kn- 金鑰填入金鑰欄位。Amp 會在所有格式中將它作為 Authorization: Bearer <key> 傳送,而 Kunavo 會驗證這個標頭,因此 標頭和查詢參數都留空。
  4. 逐行撰寫模型對應,每行一個模式。左側是 Amp 的標準模型 ID,-> 右側是 Kunavo 收到的 ID——兩者的拼法不同(Amp 使用 openai/gpt-5.6-sol,Kunavo 則接受 gpt-5-6-sol),因此這裡不能省略箭頭。使用 模型選擇器插入標準 ID,不要憑記憶輸入。
  5. 按下 檢查存取權。若對應範圍較廣,Amp 會列出端點的模型;若對應只指定一個模型,Amp 會傳送一個 token 的請求。接著確認連線清單下方的路由圖顯示 Kunavo 正在提供您對應的模型,而所有未對應的模型仍顯示由 Amp 提供。

已於 2026年9月21日 根據 Amp 的模型路由說明文件 進行確認。第三方設定會變動;如果這裡的欄位名稱不再與你看到的內容相符,應以該頁面為準,而不是本頁。

這是簡短版本。完整指南——模型選擇、實際工作階段費用,以及失敗情況——請參閱 Amp 本身的費用,以及連線會或不會改變哪些帳單項目。

除錯用戶端前先驗證

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

# 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 權杖的美元價格,輸入/輸出。

模型 IDKunavo 輸入/輸出它在 Amp 中的位置
gpt-5-6-sol$2.00 / $12.00中等模式的主要代理與 Puck——Amp 的預設工作模型
gpt-6-astra$4.00 / $20.00高模式的主要代理,以及大多數模式中的 Oracle 子代理
claude-fable-5-1$7.00 / $35.00超高模式的主要代理,專為困難且開放式的工作保留
gpt-5-6-terra$0.70 / $4.20Search 子代理——程式碼庫檢索,處理量是主要成本因素
claude-haiku-4-5$0.70 / $3.50檢視媒體,Amp 用於處理圖片、PDF 和影片的模型——Claude 能讀取圖片,不能讀取影片
計費方式是從預付餘額按權杖計費,沒有月費——請參閱 billing。在重複的上下文中——這是編輯器或聊天用戶端傳送內容的大部分——提示快取 對帳單的影響比模型選擇更大。

連線不會改變哪些費用

模型路由只會改變由誰為您的 token 費用買單,其他一概不變。Amp 的 orb 運算會另外按分鐘計費,因此建立連線不會改變這筆費用;無論如何路由模型,網頁搜尋等非模型工具仍會消耗 Amp 點數。解鎖自訂 URL 選項的 Amp 訂閱本身也是固定費用,會在第一個 token 到來之前產生。

Amp 預設執行的兩個模型未列於上表,因為 Kunavo 不提供這兩者:低模式使用的 GLM 模型,以及 Read Thread 子代理。連線無法依目前設定重現 Amp 最便宜的處理路徑,因此若對應為 */*,這兩個模型仍會由 Amp 提供。這是正確結果,不是設定錯誤——Amp 自己的規則是,任何沒有連線提供的模型都由 Amp 提供。

常見問題

Amp 可以使用自訂 API 端點嗎?

可以,透過模型路由中的自訂 URL 連線,但並非所有方案都適用。Amp 的模型路由說明文件指出,AI 模型路由器和閘道(自訂 URL 所屬的類別)仍屬實驗功能,且僅向 Megawatt、Gigawatt 和 Enterprise 客戶提供早期存取;Amp 也表示很快會向所有人推出,但未公布日期。這是截至 2026 年 9 月 21 日的狀況。Hobby 帳戶的「新增」選單完全沒有這個選項,因此應先確認方案等級,而不是基底 URL。

Amp 的 Base URL 結尾需要加上 /v1 嗎?

這取決於您選擇的 API 格式,因此這個欄位經常被誤解。使用 chat-completions 時,Amp 只會附加 /chat/completions,因此 Base URL 必須是 /v1 根路徑——Amp 文件中的範例會將 https://api.example.com/v1 轉為 https://api.example.com/v1/chat/completions。使用 anthropic-messages 時,Amp 會改為附加 /v1/messages,因此只填來源網址即可。Amp 也說明,結尾已含 /v1 的 Base URL 可以接受,而且不會重複附加;連線表單會在您輸入時顯示組合後的請求 URL,因此儲存前可以確認。

Amp 將自訂端點的 API 金鑰存放在哪裡?

存放在 Amp 的伺服器上,而不是您的電腦。Amp 會從自家的雲端代理推論,因此自訂 URL 連線是在帳戶設定的模型路由中設定,而不是放在本機設定檔或環境變數中;您指定的端點必須能從 Amp 的基礎架構連線到。Amp 在其三種 API 格式中都會將憑證放在 Authorization: Bearer 標頭中傳送。Amp 公開的 CLI 設定參考中沒有 Base URL 設定或 API 金鑰設定,這是從用戶端一側看到的同一件事。

為什麼新增連線後,Amp 仍在使用自己的模型?

因為連線只會提供其對應中包含的模型,其餘模型都由 Amp 自行提供。請依序檢查三件事:連線是否已啟用、它在優先順序清單中的位置——依序為個人連線、工作區連線、Amp,且會先嘗試優先級 0——以及模型對應是否確實符合模式正在執行的模型。連線清單下方的路由圖會顯示各模型由哪個連線提供;amp config model-providers check-access --provider-model 則會執行一次簡短推論,並回報實際提供該模型的連線。

Kunavo 是否已使用 Amp 測試其端點?

沒有。Kunavo 尚未在執行階段測試 Amp;本頁是根據 2026 年 9 月 21 日閱讀的 Amp 自家模型路由說明文件轉述而成,並非已完成測試的報告。自訂 URL 功能僅限付費 Amp 方案,因此此處的欄位是依據 Amp 公布的規格核對,而非透過執行中的用戶端確認。Amp 的「Check Access」按鈕會向供應商驗證憑證,是最具權威性的測試;若本頁的欄位名稱與您在 Amp 看到的不一致,應以 Amp 頁面為準。