빠른 시작

모든 TKX 엔드포인트는 정적 JSON 문서입니다. 설치할 것도, 발급받을 키도 없습니다 — HTTP GET 요청만 하면 됩니다.

기본 URL

모든 엔드포인트는 다음 아래에 있습니다:

https://tkx.org/api/v1/

첫 요청

모델 랭킹을 가져오세요 — 순위가 매겨진 각 모델의 최저 검증 오퍼:

curl https://tkx.org/api/v1/rankings.json

{
  "generatedAt": "2026-07-22T16:07:24.242Z",
  "attribution": "Data by TKX (https://tkx.org) — free use requires attribution",
  "rankings": [
    {
      "id": "gpt-5.5",
      "name": "gpt-5.5",
      "org": "azure_ai",
      "ctx": 1050000,
      "best": {
        "in": 5,
        "out": 30,
        "blended": 11.25,
        "router": "official",
        "provider": "azure_ai",
        "evidence": "official"
      },
      "avgBlended": 11.25,
      "providerCount": 5,
      "ttft": null,
      "tps": null,
      "uptime": null,
      "spark": [],
      "providers": [
        {
          "router": "official",
          "provider": "azure_ai",
          "in": 5,
          "out": 30,
          "ttft": null,
          "tps": null,
          "uptime": null,
          "evidence": "official"
        }
      ],
      "usage": {
        "tokens": 98987458250,
        "tokensPaid": 98987458250,
        "tokensFree": 0,
        "share": 1.03,
        "rank": 15,
        "usd": 1113608.91,
        "volChgPct": null,
        "spendChgPct": null
      }
    }
  ]
}

응답 규약

• 모든 응답에는 attribution 문자열이 포함되며, 관련이 있는 경우 generatedAt ISO-8601 타임스탬프(UTC)가 포함됩니다.
• 리스트 페이로드는 명명된 키 아래에 위치합니다 — rankings, data, events, clouds 등 (각 엔드포인트 참조).
• 가격은 currency 필드가 달리 명시하지 않는 한 100만 토큰당 USD입니다 (GPU 국내 부문은 CNY). 누락되거나 테스트되지 않은 값은 null이며 — 결코 추정하지 않습니다.
• 각 오퍼에는 evidence 태그가 붙습니다 — 데이터 모델 및 증거를 참조하십시오.

최신성 및 캐싱

CORS 및 브라우저

CORS가 활성화되어 있으므로 브라우저에서 직접 fetch()할 수 있습니다:

const r = await fetch('https://tkx.org/api/v1/indices.json');
const { indices } = await r.json();
console.log(indices.TTPI.value); // 1.67