Models

模型 ID 是調用 RouteAPI 時最重要的參數之一。請求中的 model 必須是當前賬戶可用的模型。

Endpoint

GET /v1/models

示例：

curl https://www.routeapi.ai/v1/models \
  -H "Authorization: Bearer $ROUTEAPI_KEY"

模型 ID

調用接口時使用模型 ID，而不是控制台中的展示名稱。

{
  "model": "gpt-4o"
}

如果 RouteAPI 配置了模型映射，請以控制台或模型列表接口返回的 ID 為準。

建議展示的模型字段

字段	說明
id	調用時使用的模型 ID
name	展示名稱
context_length	最大上下文長度
input_price	輸入價格
output_price	輸出價格
supports_stream	是否支持流式輸出
supports_tools	是否支持工具調用
supports_vision	是否支持圖像輸入
supports_json_schema	是否支持結構化輸出

模型不可用排查

當請求返回模型不可用、無權限或服務側錯誤時，按以下順序排查：

1. 模型 ID 是否拼寫正確。
2. 請求參數是否包含當前模型不支持的可選參數。

最佳實踐

• 為生產應用固定模型 ID，不要依賴展示名稱。
• 為關鍵業務準備可替代的模型方案。
• 對需要工具調用或結構化輸出的場景，提前確認模型能力。
• 在上線前使用同一個 Token 做模型列表和一次真實調用驗證。