API 문서

AITier는 최신 AI 모델 랭킹 및 벤치마크 데이터에 접근하기 위한 무료 오픈 API를 제공합니다. 모든 엔드포인트는 인증이 불필요하지만 속도 제한이 있습니다. 기본 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"
}

에러 응답

모든 에러는 HTTP 상태 코드와 에러 메시지를 포함한 JSON 형식으로 반환됩니다.

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

상태 코드	설명
200	요청 성공
400	잘못된 요청 / 잘못된 파라미터
404	리소스를 찾을 수 없음
429	속도 제한 초과
500	서버 내부 오류