跳到內容

請求路由

RouteAPI 讓業務系統只調用一個統一的 API 入口,平臺會在後臺完成服務選擇、可用性檢查和請求發送。

大多數業務只需要關注:

  • 請求中使用的 RouteAPI 模型 ID。
  • 是否使用流式輸出。
  • 是否需要工具調用、視覺理解、結構化輸出等可選能力。
  • API Key 與用量限制。

平臺會根據這些信息,把請求發送到合適的模型服務。

  1. RouteAPI 校驗 API Key 和賬戶權限。
  2. RouteAPI 讀取請求中的模型 ID。
  3. RouteAPI 判斷請求是否需要特殊能力。
  4. RouteAPI 通過可用的服務路徑發送請求。
  5. RouteAPI 按客戶端期望的協議返回結果。

你的業務代碼不需要暴露內部服務細節。

  • 在業務代碼中保持模型 ID 穩定。
  • 在控制台的模型列表中確認支持的能力。
  • 重要流程應使用生產環境相同的請求格式提前測試。
  • 需要排查延遲、錯誤或成本時,優先查看用量日誌。