設置首選提供商(熱切換)
PUT /v1/auth/preferred-provider:設置或清除首選提供商覆蓋項;保存前會實時探測所選憑據。
PUT /v1/auth/preferred-provider
設置或清除首選提供商覆蓋項。保存前會實時探測所選憑據;配置已存在但憑據過期時,返回 400 reauth_required。
成功後還會在進程內完成熱切換:通過 selectProvider + createLLMClient 為新提供商重建 LLM 客戶端,並原子更新唯一真相來源 LLMRouter。長駐組件(Minara、ScenarioClassifier、ChartBuilder 等)通過實時 Proxy 在下一次 createMessage 時使用新客戶端。Minara 會在每輪開始時快照客戶端,因此切換髮生時正在執行的一輪仍會使用舊提供商完成,不會拆分對話;下一輪使用新提供商。
模型會自動選擇 defaultModelForProvider(newKind),因為模型 ID 受提供商範圍限制(grok-4 僅適用於 xAI,gpt-5 僅適用於 OpenAI)。新模型會保存到以新提供商為鍵的 defaultModel 槽位,下次網關啟動時仍使用相同組合。
響應為 { ok, preferredProvider, activeModel, swapped, inflightOnOldProvider }。swapped: false 表示已保存偏好,但進程內重建失敗(例如探測和重建之間憑據消失);下次網關啟動仍會讀取保存的偏好。
| 方法 | PUT |
| 路徑 | /v1/auth/preferred-provider |
| 認證 | 需要 Authorization: Bearer <token> |
| 類別 | auth |
請求體
{ "provider": ProviderKind | null }