बेस URL और प्रमाणीकरण
हमारा API OpenAI Chat Completions मानक का पालन करता है। सेवा के साथ इंटरैक्ट करने के लिए, आपको अपने क्लाइंट को https://api.grokapikey.com/v1 की ओर निर्देशित करना चाहिए और अपनी विशिष्ट API कुंजी को Authorization हेडर में शामिल करना चाहिए। आप साइन इन करने के तुरंत बाद केवल ईमेल और पासवर्ड के साथ इस कुंजी को जनरेट कर सकते हैं। कुंजी निर्माण के समय एक बार प्रदर्शित होती है, इसलिए इसे सुरक्षित रूप से सहेजें। यदि आप इसे खो देते हैं, तो आप अपने डैशबोर्ड से एक नई कुंजी जनरेट कर सकते हैं, जो पिछली कुंजी को तुरंत रद्द कर देती है। ट्रायल खाते के लिए क्रेडिट कार्ड लिंक करने की आवश्यकता नहीं है।
आपका पहला अनुरोध
कनेक्टिविटी की जांच करने के लिए एक सरल टेक्स्ट प्रॉम्प्ट भेजकर शुरू करें। मॉडल पहचानकर्ता uncensored के साथ मानक chat/completions एंडपॉइंट का उपयोग करें। निम्नलिखित उदाहरण कनेक्शन का परीक्षण करने के लिए एक मूल curl कमांड प्रदर्शित करता है। यह पुष्टि करता है कि आपका प्रमाणीकरण सही है और सेवा प्रतिक्रिया दे रही है। फिर आप इस संरचना को अपने विशिष्ट एप्लिकेशन लॉजिक के लिए अनुकूलित कर सकते हैं।
इस कमांड को चलाने से पहले YOUR_API_KEY को अपनी वास्तविक कुंजी से बदलें।
curl https://api.grokapikey.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
}'
Python SDK एकीकरण
यदि आप एक Python एप्लिकेशन बना रहे हैं, तो आधिकारिक openai लाइब्रेरी का उपयोग करें। हमारे बेस URL और अपनी API कुंजी का उपयोग करने के लिए क्लाइंट को कॉन्फ़िगर करें। यह आपको बिना सेंसर मॉडल तक पहुंचते समय परिचित Python इडियम्स का लाभ उठाने की अनुमति देता है। क्लाइंट स्वचालित रूप से सीरियलाइजेशन और स्ट्रीमिंग संभालता है। हमारे एंडपॉइंट्स के साथ सर्वोत्तम संगतता के लिए सुनिश्चित करें कि आपके वातावरण में लाइब्रेरी का नवीनतम संस्करण स्थापित है।
from openai import OpenAI
client = OpenAI(base_url="https://api.grokapikey.com/v1", api_key="YOUR_KEY")
resp = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)
Node.js SDK एकीकरण
JavaScript या TypeScript प्रोजेक्ट्स के लिए, Node.js OpenAI SDK बिना किसी समस्या के काम करता है। कॉन्फ़िगरेशन ऑब्जेक्ट में apiKey और baseURL गुण सेट करें। यह सुनिश्चित करता है कि सभी अगले अनुरोध हमारी इंफ्रास्ट्रक्चर के माध्यम से रूट होते हैं। आप प्रतिक्रियाओं को संभालने के लिए मानक async/await पैटर्न का उपयोग कर सकते हैं। यह दृष्टिकोण सर्वर-साइड एप्लिकेशन या एज फंक्शंस के लिए आदर्श है जिन्हें OpenAI के माध्यम से प्रॉक्सी किए बिना सीधे API एक्सेस की आवश्यकता होती है।
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.grokapikey.com/v1", apiKey: process.env.API_KEY });
const resp = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);
स्ट्रीमिंग प्रतिक्रियाएं
ऐप्लिकेशन के लिए जो रियल-टाइम टोकन जनरेशन से लाभान्वित होते हैं, अपने अनुरोध बॉडी में stream: true सेट करके स्ट्रीमिंग सक्षम करें। API आंशिक प्रतिक्रियाओं का एक Server-Sent Events (SSE) स्ट्रीम लौटाता है। यह उपयोगकर्ताओं के लिए अनुभव कम लेटेंसी प्रदान करता है और जनरेटेड टेक्स्ट को तुरंत प्रदर्शित करने की अनुमति देता है। प्रत्येक चंक प्रतिक्रिया का एक डेल्टा होता है। UI को क्रमिक रूप से अपडेट करने के लिए इन इवेंट्स को अपने क्लाइंट कोड में हैंडल करें। स्ट्रीमिंग सामान्य रूप से टोकन का उपभोग करती है और मूल्य निर्धारण को प्रभावित नहीं करती है।
stream = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Tell the story in second person."}],
stream=True,
)
for chunk in stream:
if chunk.choices and chunk.choices[0].delta.content:
print(chunk.choices[0].delta.content, end="", flush=True)
सीमाएं, त्रुटियां और कॉन्टेक्स्ट
प्रत्येक API कुंजी प्रति मिनट 300 अनुरोधों और अधिकतम 8 MB के अनुरोध बॉडी आकार के लिए सीमित है। यदि आप रेट लिमिट से अधिक हो जाते हैं, तो API 429 स्टेटस कोड लौटाता है; कुछ सेकंड प्रतीक्षा करें और पुनः प्रयास करें। 401 त्रुटि अमान्य या रद्द की गई कुंजी को दर्शाती है, जबकि 402 त्रुटि यह दर्शाती है कि आपका प्रीपेड क्रेडिट समाप्त हो गया है। मॉडल इनपुट और आउटपुट दोनों के लिए मिलाकर 100,000-टोकन कॉन्टेक्स्ट विंडो का समर्थन करता है। ट्रंकेशन से बचने के लिए सुनिश्चित करें कि आपके प्रॉम्प्ट इस सीमा के भीतर फिट हों। सामग्री फ़िल्टर न्यूनतम बने रहते हैं, सिवाय किशोरों से संबंधित यौन सामग्री पर कठोर प्रतिबंध के।