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	आंतरिक सर्वर त्रुटि