Grok API: अपने कोड से Grok को कॉल करें

कोड से Grok को ऐक्सेस करने के दो तरीके

डेवलपर्स मुख्य रूप से दो तरीकों से Grok मॉडल्स को कॉल कर सकते हैं। पहला है xAI API, जिसे खुद कंपनी चलाती है (अब SpaceXSI ब्रांडेड), और इसकी कीज़ console.x.ai से मिलती हैं। दूसरा है एक मॉडल राउटर जैसे OpenRouter, जो एक ही API की और एक ही बिल के तहत कई प्रोवाइडर्स के मॉडल्स रीसेल करता है। दोनों ही OpenAI Chat Completions फ़ॉर्मैट में रिक्वेस्ट स्वीकार करते हैं, इसलिए बेस एड्रेस और मॉडल का नाम बदलते ही आधिकारिक OpenAI SDK काम करने लगते हैं।

कौन-सा तरीका चुनें

• xAI API अगर आप Grok का हर फ़ीचर सबसे पहले चाहते हैं: मॉडल्स की पूरी लिस्ट, Responses API, सर्वर-साइड वेब सर्च और X सर्च टूल्स, Grok Imagine के साथ इमेज और वीडियो जनरेशन, वॉइस, बैच जॉब्स और कैश्ड-प्रॉम्प्ट डिस्काउंट। बेस URL: https://api.x.ai/v1।
• OpenRouter अगर आप बिना नए कॉन्ट्रैक्ट्स के Grok और अन्य कंपनियों के मॉडल्स के बीच स्विच करना चाहते हैं, या आपके पास पहले से एक OpenRouter अकाउंट है। बेस URL: https://openrouter.ai/api/v1, मॉडल ids में x-ai/ प्रीफ़िक्स होता है। सेटअप की जानकारी OpenRouter क्विकस्टार्ट में है।

चाहे कोई भी तरीका चुनें, API की को सर्वर पर या एन्वायरमेंट वेरिएबल में ही रखें। इसे कभी भी किसी वेब पेज या मोबाइल ऐप के अंदर न डालें, जहाँ इसे कोई भी देख सकता है।

xAI API पर आपकी पहली रिक्वेस्ट

कंसोल में एक की बनाएँ, इसे XAI_API_KEY के रूप में सेव करें, और Grok 4.7 को एक मैसेज भेजें:

curl

curl https://api.x.ai/v1/chat/completions \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-4.7",
    "reasoning_effort": "low",
    "messages": [
      {"role": "system", "content": "आप एक संक्षिप्त और सटीक सहायक हैं।"},
      {"role": "user", "content": "पहले मैराथन के लिए मुझे तीन टिप्स दें।"}
    ]
  }'

Python, OpenAI लाइब्रेरी के साथ

import os
from openai import OpenAI

grok = OpenAI(
    api_key=os.environ["XAI_API_KEY"],
    base_url="https://api.x.ai/v1",
)

answer = grok.chat.completions.create(
    model="grok-4.3",
    reasoning_effort="medium",
    messages=[{"role": "user", "content": "क्या 391 एक अभाज्य संख्या (प्राइम नंबर) है? अपनी जांच दिखाएं।"}],
)
print(answer.choices[0].message.content)

reasoning_effort यह तय करता है कि जवाब देने से पहले मॉडल कितनी देर सोचता है। Grok 4.3 में none, low, medium, high और xhigh सपोर्टेड हैं और इसका डिफ़ॉल्ट low है; Grok 4.7 में low, medium, high और xhigh सपोर्टेड हैं और इसका डिफ़ॉल्ट high है। Grok 4.20 के लिए, xAI अलग-अलग ids देता है: grok-4.20-0309-reasoning और grok-4.20-0309-non-reasoning।

OpenRouter के ज़रिए यही काम करना

OpenRouter पर, की को OPENROUTER_API_KEY में रखें और x-ai/ वाले ids का उपयोग करें। OpenRouter सोचने की क्षमता को reasoning ऑब्जेक्ट से कंट्रोल करता है। यह JavaScript कोड Node.js 18 या इसके बाद के वर्ज़न पर चलता है:

const endpoint = "https://openrouter.ai/api/v1/chat/completions";

const reply = await fetch(endpoint, {
  headers: {
    Authorization: `Bearer ${process.env.OPENROUTER_API_KEY}`,
    "Content-Type": "application/json",
  },
  method: "POST",
  body: JSON.stringify({
    model: "x-ai/grok-4.20",
    reasoning: { enabled: false },
    stream: false,
    messages: [{ role: "user", content: "इस हेडलाइन को शांत लहजे में दोबारा लिखें: कीमतें फिर आसमान छू गईं" }],
  }),
});
const json = await reply.json();
console.log(json.choices[0].message.content);

मॉडल को सोचने (थिंक) पर मजबूर करने के लिए, इसके बजाय reasoning: { effort: "low" } (या medium, high) भेजें। अगर आप चाहते हैं कि थिंकिंग प्रोसेस का इस्तेमाल तो हो लेकिन रिस्पॉन्स में वह न दिखे, तो exclude: true जोड़ें। जवाब जैसे-जैसे लिखा जा रहा हो वैसे-वैसे पाने के लिए stream: true सेट करें, जिससे चैट इंटरफ़ेस में यह काफ़ी तेज़ महसूस होता है।

इमेज भेजना

Grok 4.20, 4.3 और 4.7 सभी इमेज पढ़ सकते हैं। इसके लिए पार्ट्स की लिस्ट के साथ OpenAI-स्टाइल मैसेज का उपयोग करें। xAI का डॉक्यूमेंटेशन 20 MiB तक की JPEG और PNG इमेज सपोर्ट करता है; एक पब्लिक URL या base64 डेटा URL दोनों काम करते हैं।

{
  "model": "grok-4.20-0309-non-reasoning",
  "messages": [{
    "role": "user",
    "content": [
      {"type": "image_url", "image_url": {"url": "https://example.com/receipt.png"}},
      {"type": "text", "text": "इस रसीद पर मौजूद आइटम्स और कुल राशि की सूची बनाएं।"}
    ]
  }]
}

Grok मॉडल ids और कीमतें

यहाँ वे मौजूदा टेक्स्ट मॉडल्स दिए गए हैं जिन्हें OpenRouter ने SpaceXAI के लिए लिस्ट किया है, साथ ही कॉन्टेक्स्ट साइज़ और प्रति दस लाख (1M) टोकन की कीमतें (OpenRouter लिस्ट प्राइस, अक्टूबर 2026)। xAI API भी 200,000 टोकन से कम के प्रॉम्प्ट्स के लिए यही बेस रेट चार्ज करता है।

xAI के मॉडल्स और प्राइसिंग पेज से कुछ मुख्य बातें (xAI लिस्ट प्राइस, अक्टूबर 2026):

• लंबे प्रॉम्प्ट्स अधिक महंगे हैं। जैसे ही कोई प्रॉम्प्ट 200,000 टोकन तक पहुँचता है, पूरी रिक्वेस्ट का बिल हायर रेट पर बनता है: Grok 4.7 के लिए $4 / $12, Grok 4.3 और 4.20 के लिए $2.50 / $5।
• कैश्ड इनपुट सस्ता है: दोहराए जाने वाले प्रॉम्प्ट प्रीफ़िक्स के लिए Grok 4.7 हेतु $0.50 प्रति मिलियन और Grok 4.3 व 4.20 हेतु $0.20।
• बैच जॉब्स जिनमें इंतज़ार किया जा सकता है, डिस्काउंट मिलता है, और OpenRouter x-ai/grok-4.3:batch को $1 / $2 पर लिस्ट करता है।
• कॉन्टेक्स्ट सोर्स के अनुसार अलग होता है: OpenRouter Grok 4.20 के लिए 2,000,000 टोकन लिस्ट करता है, जबकि xAI का अपना मॉडल पेज 1,000,000 बताता है।

थिंकिंग टोकन्स आउटपुट में गिने जाते हैं, इसलिए रीज़निंग मॉडल की लागत प्रति जवाब टोकन प्राइस की तुलना में अधिक हो सकती है।

उपयोगी टिप्स

• चैट, रीराइटिंग और एक्सट्रैक्शन के लिए Grok 4.20 non-reasoning से शुरुआत करें। यह तेज़ और किफ़ायती है। जब कठिन कामों में स्पीड से ज़्यादा क्वालिटी मायने रखती हो, तब Grok 4.3 या 4.7 पर स्विच करें।
• नॉलेज कट-ऑफ याद रखें। xAI के अनुसार, Grok 4.7 मई 2026 तक की घटनाओं को जानता है। किसी भी नई जानकारी के लिए, अपने प्रॉम्प्ट में तथ्य पास करें, या xAI के सर्वर-साइड वेब और X सर्च टूल्स का उपयोग करें, जिनका बिल प्रति कॉल के हिसाब से होता है।
• एक सिस्टम मैसेज लिखें जिसमें मनचाहा रोल, टोन और आउटपुट फ़ॉर्मैट तय करें, और जब आपका कोड रिस्पॉन्स पार्स कर रहा हो तो स्कीमा के साथ JSON मांगें।
• रेट लिमिट्स हैंडल करें। 429 रिस्पॉन्स मिलने पर थोड़ा रुककर दोबारा कोशिश करें (retry)।
• नियमों का पालन करें। API के इस्तेमाल पर xAI की स्वीकार्य उपयोग नीति (AUP) लागू होती है, और safety_identifier फ़ील्ड की मदद से आप हर एंड यूज़र के हिसाब से रिक्वेस्ट्स को टैग कर सकते हैं।

जब कुछ काम न करे

• 401 या 403: की गायब है, निरस्त कर दी गई है या गलत एन्वायरमेंट में लोड हो गई है। सर्वर पर इसके शुरुआती कुछ अक्षर प्रिंट करके पुष्टि करें कि यह मौजूद है।
• Model not found: प्रीफ़िक्स चेक करें। OpenRouter को x-ai/grok-4.7 चाहिए, जबकि xAI को सिर्फ़ grok-4.7 चाहिए।
• खाली या बेहद धीमे जवाब किसी रीज़निंग मॉडल से आने का मतलब आमतौर पर यह होता है कि उसने अपना पूरा आउटपुट बजट सोचने में खर्च कर दिया। effort कम करें या max_tokens बढ़ाएँ।
• इमेज रिजेक्ट हो गई: इसे JPEG या PNG में बदलें और तय साइज़ लिमिट के अंदर रखें।

अक्सर पूछे जाने वाले सवाल (FAQ)

क्या Grok API, OpenAI SDK के साथ कम्पैटिबल है?

हाँ। SDK को xAI की के साथ https://api.x.ai/v1 पर, या OpenRouter की के साथ OpenRouter पर पॉइंट करें, और Grok मॉडल id का उपयोग करें।

क्या कोई फ़्री Grok API है?

कोई परमानेंट फ़्री टियर लिस्टेड नहीं है। xAI और OpenRouter दोनों प्रति टोकन चार्ज करते हैं, हालांकि छोटे टेस्ट्स में बहुत कम खर्च आता है।

क्या मैं Grok API से इमेज जनरेट कर सकता हूँ?

हाँ, एक अलग इमेज एंडपॉइंट पर xAI के Grok Imagine मॉडल्स के ज़रिए। हमारा Grok Imagine पेज देखें। हमारा चैट इमेज जनरेट नहीं करता है।

Grok.Online कौन-सा Grok मॉडल उपयोग करता है?

हमारा चैट बिना रीज़निंग वाला Grok 4.20, लो रीज़निंग एफ़र्ट वाला Grok 4.3, और दिन में 10 मैसेज तक Grok 4.7 ऑफ़र करता है, यह सब OpenRouter के ज़रिए उपलब्ध है।