API 文件

AITier 提供免費的開放 API，用於取得最新的 AI 模型排行榜和基準測試資料。所有介面無需認證（API Key），但有速率限制。基礎 URL 為 https://aitier.net。如遇問題或有建議，歡迎透過 GitHub 回饋。

快速參考

基礎 URL:https://aitier.net

協定:HTTPS

認證:無需

速率限制:60 次/分鐘

介面列表

GET/api/models

取得模型列表，支援分頁和篩選。回傳模型基本資訊、能力評分和提供商。

查詢參數

參數	型別	必填	說明
page	number	否	頁碼，預設 1
limit	number	否	每頁數量，預設 20
provider	string	否	按提供商篩選，如 OpenAI、Anthropic
domain	string	否	按領域篩選: coding、general、multimodal
hasRanking	boolean	否	僅回傳有排名資料的模型

回應範例

{
  "data": [
    {
      "id": "gpt-4o",
      "name": "GPT-4o",
      "provider": "OpenAI",
      "version": "2024-08-06",
      "capabilities": {
        "coding": 92,
        "reasoning": 90,
        "creativity": 88,
        "multilingual": 85,
        "multimodal": 95
      }
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 128,
    "totalPages": 7
  }
}

GET/api/models/:id

透過 ID 取得單個模型的完整資訊，包括能力評分、排名歷史和定價。

回應範例

{
  "id": "gpt-4o",
  "name": "GPT-4o",
  "provider": "OpenAI",
  "version": "2024-08-06",
  "parameters": null,
  "releaseDate": "2024-05-13",
  "pricing": {
    "input": 2.5,
    "output": 10.0,
    "currency": "USD"
  },
  "capabilities": {
    "coding": 92,
    "reasoning": 90,
    "creativity": 88,
    "multilingual": 85,
    "multimodal": 95
  },
  "rankings": [
    {
      "domain": "coding",
      "source": "swe-bench",
      "rank": 2,
      "score": 49.2
    }
  ]
}

GET/api/rankings

取得排行榜資料列表，支援按領域和提供商篩選。回傳模型排名和得分。

查詢參數

參數	型別	必填	說明
domain	string	否	按領域篩選: coding、general、multimodal
provider	string	否	按提供商篩選，如 OpenAI、Anthropic

回應範例

{
  "data": [
    {
      "modelId": "gpt-4o",
      "modelName": "GPT-4o",
      "provider": "OpenAI",
      "domain": "coding",
      "source": "swe-bench",
      "rank": 2,
      "score": 49.2,
      "metrics": {
        "resolveRate": 49.2
      },
      "updatedAt": "2025-04-22T00:00:00Z"
    }
  ]
}

GET/api/rankings/:domain

按領域取得排行榜。可用領域: coding（程式碼）、general（通用）、multimodal（多模態）。

回應範例

{
  "domain": "coding",
  "source": "swe-bench",
  "rankings": [
    {
      "rank": 1,
      "modelId": "claude-3.5-sonnet",
      "modelName": "Claude 3.5 Sonnet",
      "provider": "Anthropic",
      "score": 49.0
    },
    {
      "rank": 2,
      "modelId": "gpt-4o",
      "modelName": "GPT-4o",
      "provider": "OpenAI",
      "score": 49.2
    }
  ],
  "updatedAt": "2025-04-22T00:00:00Z"
}

GET/api/health

健康檢查端點。用於監控服務執行狀態和資料庫連線。

回應範例

{
  "status": "ok",
  "timestamp": "2025-04-22T12:00:00Z",
  "database": "connected"
}

錯誤回應

所有錯誤均回傳 JSON 格式，包含 HTTP 狀態碼和錯誤資訊。

{
  "error": {
    "code": 404,
    "message": "Model not found"
  }
}

狀態碼	說明
200	請求成功
400	參數錯誤
404	資源未找到
429	請求過於頻繁
500	伺服器內部錯誤