Skip to main content
GET
/
v1
/
models
curl --request GET \
  --url https://api.mixroute.ai/v1/models \
  --header 'Authorization: Bearer sk-xxxxxxxxxx'

{
  "object": "list",
  "data": [
    {
      "id": "gpt-4o",
      "object": "model",
      "created": 1715232000,
      "owned_by": "openai"
    },
    {
      "id": "claude-sonnet-4-20250514",
      "object": "model",
      "created": 1743465600,
      "owned_by": "anthropic"
    }
  ]
}

​
簡介

取得目前可用的模型清單。本介面支援自動識別回傳格式，無需手動指定。

​
自動格式識別

根據請求標頭自動回傳對應格式：Anthropic、Gemini 或 OpenAI 格式

​
認證

Bearer Token，如 Bearer sk-xxxxxxxxxx

​
請求標頭說明

根據請求標頭自動識別回傳格式：
​
x-anthropic-version
string
回傳 Anthropic 格式回應
​
x-goog-api-key
string
回傳 Gemini 格式回應
預設回傳 OpenAI 格式回應

​
程式碼範例

curl https://api.mixroute.ai/v1/models \
  -H "Authorization: Bearer sk-xxxxxxxxxx"

​
回應欄位說明

欄位類型說明
objectstring固定為 list
dataarray模型列表
data[].idstring模型唯一識別碼
data[].objectstring固定為 model
data[].createdinteger模型建立時間戳記（Unix 時間戳記）
data[].owned_bystring模型提供商（如：openai、anthropic、google）

​
回應範例

{
  "object": "list",
  "data": [
    {
      "id": "gpt-4o",
      "object": "model",
      "created": 1715232000,
      "owned_by": "openai"
    },
    {
      "id": "claude-sonnet-4-20250514",
      "object": "model",
      "created": 1743465600,
      "owned_by": "anthropic"
    },
    {
      "id": "gemini-2.5-pro",
      "object": "model",
      "created": 1746057600,
      "owned_by": "google"
    }
  ]
}

​
HTTP 狀態碼

狀態碼說明
200請求成功
401API Key 無效或已過期
429請求頻率過高
500伺服器內部錯誤

​
錯誤回應範例

{
  "error": {
    "message": "Invalid API key",
    "type": "invalid_request_error",
    "code": "invalid_api_key"
  }
}

​
注意事項

  • 建議快取模型清單，避免頻繁請求（建議快取 1 小時）
  • 回傳的模型清單會根據您的 API Key 權限動態變化
  • 可在應用程式啟動時呼叫此介面進行可用性檢查
  • 不同模型的 created 時間戳記可能差異較大，僅代表模型發布時間
  • Python 範例依賴 openai 函式庫：pip install openai
  • Node.js 範例依賴 axios 函式庫：npm install axios
curl --request GET \
  --url https://api.mixroute.ai/v1/models \
  --header 'Authorization: Bearer sk-xxxxxxxxxx'

{
  "object": "list",
  "data": [
    {
      "id": "gpt-4o",
      "object": "model",
      "created": 1715232000,
      "owned_by": "openai"
    },
    {
      "id": "claude-sonnet-4-20250514",
      "object": "model",
      "created": 1743465600,
      "owned_by": "anthropic"
    }
  ]
}