メインコンテンツへスキップ

APIドキュメント

AITierは最新のAIモデルランキングとベンチマークデータにアクセスするための無料オープンAPIを提供しています。すべてのエンドポイントは認証不要ですが、レート制限があります。ベースURL: https://aitier.net。問題やご提案がございましたら、GitHubからお知らせください。

クイックリファレンス

ベースURL:https://aitier.net
プロトコル:HTTPS
認証:不要
レート制限:60リクエスト/分

エンドポイント一覧

GET/api/models

ページネーションとフィルタリングでモデル一覧を取得。モデル情報、能力スコア、プロバイダーを返します。

クエリパラメータ

パラメータタイプ必須説明
pagenumberいいえページ番号、デフォルト1
limitnumberいいえ1ページあたりの件数、デフォルト20
providerstringいいえプロバイダーでフィルタ(例: OpenAI、Anthropic)
domainstringいいえドメインでフィルタ: coding、general、multimodal
hasRankingbooleanいいえランキングデータのあるモデルのみ返却

レスポンス例

{
  "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

ドメインとプロバイダーでフィルタリングしたランキングデータを取得。モデルの順位とスコアを返します。

クエリパラメータ

パラメータタイプ必須説明
domainstringいいえドメインでフィルタ: coding、general、multimodal
providerstringいいえプロバイダーでフィルタ(例: 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"
}

エラーレスポンス

すべてのエラーはHTTPステータスコードとエラーメッセージを含むJSON形式で返されます。

{
  "error": {
    "code": 404,
    "message": "Model not found"
  }
}
ステータスコード説明
200リクエスト成功
400リクエストエラー / 無効なパラメータ
404リソースが見つかりません
429レート制限超過
500サーバー内部エラー