API संदर्भ

बेस URL

हर रिक्वेस्ट यहाँ जाती है:

ऑथेंटिकेशन

API कुंजियाँ पेज पर एक कुंजी बनाएं, फिर उसे Authorization हेडर में बियरर टोकन के रूप में भेजें। आपकी कुंजी का केवल एक हैश स्टोर किया जाता है — इसे बनते ही कॉपी कर लें, क्योंकि GatifyAI इसे दोबारा नहीं दिखा सकता।

त्वरित शुरुआत

curl, Python, या TypeScript में एक न्यूनतम रिक्वेस्ट:

curl https://gatifyai.com/api/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MODEL_NAME",
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

किसी कुंजी को विशिष्ट मॉडलों तक सीमित करना

डिफ़ॉल्ट रूप से एक नई कुंजी GatifyAI के किसी भी मुफ़्त मॉडल का उपयोग कर सकती है, और अगर कोई अनुपलब्ध हो तो वेब चैट जैसा ही स्वचालित फ़ॉलओवर होता है। इसके बजाय आप किसी कुंजी को किसी खास मॉडल या छोटी सूची तक सीमित कर सकते हैं — फिर कुंजी केवल उसी सूची के मॉडल, आपके दिए क्रम में, इस्तेमाल करेगी, चाहे रिक्वेस्ट किसी भी मॉडल की मांग करे। सूची से बाहर का मॉडल मांगने पर 400 एरर मिलेगा जिसमें बताया जाएगा कि कुंजी वास्तव में किन मॉडलों का उपयोग कर सकती है।

किसी पर्सोना के रूप में चैट करना

कम्युनिटी गैलरी में प्रकाशित किसी पर्सोना के रूप में चैट करने के लिए model: "persona/<slug>" भेजें — उसका व्यक्तित्व और पसंदीदा मॉडल अपने आप उपयोग होते हैं, फिर भी अगर आपने कुंजी के लिए अनुमत मॉडल सेट किए हैं तो उन्हीं तक सीमित रहते हैं। किसी पर्सोना का slug और तैयार उदाहरण उसके अपने पेज पर, API टैब में मिलेगा।

{
  "model": "persona/senior-engineer",
  "messages": [{"role": "user", "content": "Review my code."}]
}

स्ट्रीमिंग बनाम नॉन-स्ट्रीमिंग

टोकन जनरेट होते ही प्राप्त करने के लिए stream: true सेट करें, बिल्कुल OpenAI के स्ट्रीमिंग फ़ॉर्मैट (Server-Sent Events, [DONE] पर समाप्त) जैसा। इसे छोड़ें, या false सेट करें, ताकि पूरा जवाब मिलने का इंतज़ार हो और एक ही JSON रिस्पॉन्स मिले — यह डिफ़ॉल्ट है।

एरर

एरर OpenAI के एरर फ़ॉर्मैट का पालन करते हैं: {"error": {"message": "...", "type": "..."}}। 401 का मतलब है गुम, अमान्य, या रद्द की गई कुंजी। 400 का मतलब है कि रिक्वेस्ट खुद अमान्य है — अक्सर एक अपरिचित मॉडल, अप्रकाशित/अज्ञात पर्सोना slug, या आपकी कुंजी की अनुमत सूची से बाहर का मॉडल। 502 का मतलब है कि किसी भी उम्मीदवार मॉडल ने जवाब नहीं दिया।

{
  "error": {
    "message": "This API key may only use: llama-3.1-8b:free",
    "type": "invalid_request_error"
  }
}

रेट लिमिट

API रिक्वेस्ट वेब ऐप की तरह ही प्रति-खाता चैट रेट लिमिट में गिनी जाती हैं — फ़िलहाल API ट्रैफ़िक के लिए कोई अलग कोटा नहीं है।