線路
同一個模型,Rabah 可能通過幾條不同的線路提供。不同線路的價格、穩定性和速度可能不同。
你不用為每條線路單獨申請密鑰:一個密鑰可以使用你能用的所有線路,在請求的模型名裡決定走哪一條。
請求裡只寫模型名,比如 claude-sonnet-4-6,就走這個模型的預設線路。模型廣場裡標著”預設”的就是它。
預設線路由平台設定,不一定是最便宜的那條。在乎價格的話,可以指定線路。
預設線路暫時不可用時
Section titled “預設線路暫時不可用時”只寫模型名時,如果預設線路當前沒有可用的帳號(比如正在限流或維護),請求會自動改走下一條可用的線路,不會直接失敗。
這時價格按實際使用的線路計算,可能和預設線路不同。每次請求的費用可以在 Hub 的 使用記錄 裡查看,鼠標移到費用上還能看到單價。想確保始終按某條線路的價格計費,請指定線路。
模型名後面加上 :線路代號,就固定走這條線路:
claude-sonnet-4-6:pro- 線路代號在模型廣場展開模型後可以看到,點那一行的”複製模型名”就會複製完整的寫法。
- 調用
GET /v1/models時,有多條線路的模型,會額外列出每條線路的模型名:線路代號。 - 代號不區分大小寫,
:PRO和:pro一樣。
指定了線路的請求不會自動換線路。這條線路暫時不可用時,請求會直接錯誤,方便你確定每次都是按這條線路的價格計費。
除了所有人都能用的公開線路,平台還可以給特定用戶開通專屬線路,在模型廣場裡標著”專屬”。
- 專屬線路只有登入後才能在模型廣場看到,而且只對開通了的帳號顯示。
- 用法和公開線路一樣:只寫模型名時可能走到它,也可以用
模型名:線路代號指定。
限制密鑰能用哪些線路
Section titled “限制密鑰能用哪些線路”建立或編輯密鑰時,線路與模型 選項可以限制這個密鑰的使用範圍:
- 全部線路和模型(預設):你能用的所有線路和模型,以後新增的也包括在內。
- 指定線路和模型:只能用勾選的。整條線路勾選時,這條線路以後新增的模型也能用。
只寫模型名時,被限制掉的線路會被跳過,自動走下一條允許的線路。
| 狀態碼 | 錯誤資訊 | 原因 |
|---|---|---|
| 404 | Model <模型名> is not available | 沒有任何線路提供這個模型;或者線路代號寫錯了;或者指定了你沒開通的專屬線路。檢查模型名是否和模型廣場裡的完全一致。 |
| 403 | Model <模型名> is not allowed for this API key | 模型存在,但這個密鑰的”線路與模型”設定不允許用它。到 Hub 編輯密鑰即可。 |
| 503 | No available accounts 或 Service temporarily unavailable | 線路的帳號暫時都忙或受限。只寫模型名的請求會盡量避開這種線路,但仍可能遇到;指定了線路的請求更容易遇到。稍後重試,或者換一條線路。 |