البدء السريع

كل نقطة نهاية في 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 خلاف ذلك (الجزء المحلي لوحدات GPU باليوان الصيني). القيم المفقودة/غير المختبَرة هي 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