Grok API: اپنے کوڈ سے Grok کو کال کریں

کوڈ کے ذریعے Grok تک رسائی کے دو طریقے

ڈیولپرز بنیادی طور پر دو طریقوں سے Grok ماڈلز کال کر سکتے ہیں۔ پہلا طریقہ xAI API ہے، جو خود کمپنی (اب SpaceXSI برانڈ) چلاتی ہے، اور اس کی کیز (keys) console.x.ai سے ملتی ہیں۔ دوسرا طریقہ ماڈل راؤٹر جیسے کہ OpenRouter ہے، جو ایک ہی key اور ایک ہی بل کے تحت کئی فراہم کنندگان کے ماڈلز پیش کرتا ہے۔ دونوں OpenAI کے Chat Completions فارمیٹ میں درخواستیں قبول کرتے ہیں، اس لیے جیسے ہی آپ بنیادی ایڈریس (base address) اور ماڈل کا نام تبدیل کریں گے، آفیشل OpenAI SDKs کام کرنا شروع کر دیں گے۔

کون سا راستہ منتخب کریں

• اگر آپ Grok کا ہر فیچر سب سے پہلے حاصل کرنا چاہتے ہیں تو xAI API منتخب کریں: تمام ماڈلز کی مکمل فہرست، Responses API، سرور سائیڈ ویب سرچ اور X سرچ ٹولز، Grok Imagine کے ذریعے امیج اور ویڈیو جنریشن، وائس، بیچ جابز (batch jobs)، اور کیشڈ پرامپٹ (cached-prompt) پر رعایت۔ بنیادی URL ہے https://api.x.ai/v1۔
• اگر آپ نئے معاہدوں کے بغیر Grok اور دیگر کمپنیوں کے ماڈلز کے درمیان سوئچ کرنا چاہتے ہیں، یا آپ کے پاس پہلے سے OpenRouter اکاؤنٹ ہے تو OpenRouter منتخب کریں۔ بنیادی URL ہے https://openrouter.ai/api/v1، اور ماڈل آئی ڈیز سے پہلے x-ai/ لگتا ہے۔ سیٹ اپ کی تفصیلات OpenRouter quickstart میں موجود ہیں۔

دونوں صورتوں میں، اپنی key کو سرور پر یا کسی انوائرمنٹ ویری ایبل (environment variable) میں محفوظ رکھیں۔ اسے کبھی بھی ویب پیج یا موبائل ایپ کے اندر شامل کر کے بھیجنے کی غلطی نہ کریں، جہاں اسے کوئی بھی پڑھ سکتا ہو۔

xAI API کو آپ کی پہلی درخواست

کنسول میں ایک key بنائیں، اسے 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": "You are a concise assistant."},
      {"role": "user", "content": "Give me three tips for a first marathon."}
    ]
  }'

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": "Is 391 a prime number? Show your check."}],
)
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 الگ آئی ڈیز فراہم کرتا ہے: grok-4.20-0309-reasoning اور grok-4.20-0309-non-reasoning۔

یہی کام OpenRouter کے ذریعے

OpenRouter پر، key کو OPENROUTER_API_KEY میں رکھیں اور x-ai/ والے آئی ڈیز استعمال کریں۔ 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: "Rewrite this headline in a calmer tone: PRICES EXPLODE AGAIN" }],
  }),
});
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 سبھی تصاویر پڑھ سکتے ہیں۔ متعدد حصوں پر مشتمل فہرست (list of parts) کے ساتھ 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": "List the items and the total on this receipt."}
    ]
  }]
}

Grok ماڈل آئی ڈیز اور قیمتیں

یہ وہ موجودہ ٹیکسٹ ماڈلز ہیں جنہیں OpenRouter نے SpaceXAI کے تحت درج کیا ہے، بمع کونٹیکسٹ سائز اور فی ملین ٹوکن قیمتیں (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۔
• بیچ جابز (Batch jobs) جن میں انتظار ممکن ہو، ان پر رعایت ملتی ہے، اور OpenRouter پر x-ai/grok-4.3:batch بھی $1 / $2 کے ریٹ پر درج ہے۔
• ماخذ کے لحاظ سے کونٹیکسٹ مختلف ہے: OpenRouter پر Grok 4.20 کے لیے 2,000,000 ٹوکنز درج ہیں، جبکہ xAI کا اپنا ماڈل پیج 1,000,000 بتاتا ہے۔

سوچنے کے دوران خرچ ہونے والے ٹوکنز (Thinking tokens) کو آؤٹ پٹ شمار کیا جاتا ہے، اس لیے فی ٹوکن ریٹ کے مقابلے میں ایک reasoning ماڈل کے ہر جواب کی لاگت زیادہ ہو سکتی ہے۔

عملی تجاویز

• چیٹ، ری رائٹنگ، اور ڈیٹا نکالنے کے لیے Grok 4.20 non-reasoning سے آغاز کریں۔ یہ تیز اور سستا ہے۔ جب رفتار کے مقابلے میں مشکل کاموں پر کوالٹی زیادہ اہم ہو تو Grok 4.3 یا 4.7 کی طرف جائیں۔
• معلومات کی آخری حد (knowledge cut-off) ذہن میں رکھیں۔ xAI کے مطابق، Grok 4.7 مئی 2026 تک کے واقعات سے باخبر ہے۔ اس سے نئی معلومات کے لیے پرامپٹ میں حقائق شامل کریں، یا xAI کے سرور سائیڈ ویب اور X سرچ ٹولز استعمال کریں، جن کی فیس فی کال وصول کی جاتی ہے۔
• ایک سسٹم میسج لکھیں جس میں مطلوبہ کردار، لہجہ اور آؤٹ پٹ فارمیٹ واضح ہو، اور اگر آپ کا کوڈ جواب کو پارس (parse) کرتا ہے تو اسکیما (schema) کے ساتھ JSON مانگیں۔
• ریٹ لمٹس (rate limits) کو ہینڈل کریں۔ 429 کا رسپانس ملنے پر تھوڑے وقفے کے بعد دوبارہ کوشش کریں۔
• قوانین پر عمل کریں۔ API کے استعمال پر xAI کی قابل قبول استعمال کی پالیسی لاگو ہوتی ہے، اور safety_identifier فیلڈ آپ کو ہر اینڈ یوزر کے حساب سے درخواستوں کو ٹیگ کرنے کی سہولت دیتی ہے۔

جب کوئی مسئلہ پیش آئے

• 401 یا 403: key غائب ہے، منسوخ ہو چکی ہے، یا غلط انوائرمنٹ میں لوڈ ہوئی ہے۔ تصدیق کے لیے سرور پر اس کے ابتدائی چند حروف پرنٹ کر کے دیکھیں۔
• ماڈل نہیں ملا (Model not found): سابقہ (prefix) چیک کریں۔ OpenRouter کو x-ai/grok-4.7 درکار ہے، جبکہ xAI کو سادہ grok-4.7 چاہیے۔
• reasoning ماڈل کی طرف سے خالی یا بہت سست جوابات کا مطلب عام طور پر یہ ہوتا ہے کہ اس نے اپنا پورا آؤٹ پٹ بجٹ سوچنے میں خرچ کر دیا۔ effort کم کریں یا max_tokens بڑھائیں۔
• تصویر مسترد ہو گئی: اسے JPEG یا PNG میں تبدیل کریں اور سائز مقررہ حد کے اندر رکھیں۔

عام سوالات

کیا Grok API، OpenAI SDK کے ساتھ کام کرتا ہے؟

جی ہاں۔ xAI کی key کے ساتھ SDK کا رخ https://api.x.ai/v1 کی طرف کریں، یا OpenRouter کی key کے ساتھ OpenRouter کی طرف، اور کوئی بھی Grok ماڈل آئی ڈی استعمال کریں۔

کیا Grok API مفت دستیاب ہے؟

کوئی مستقل مفت پلان درج نہیں ہے۔ xAI اور OpenRouter دونوں فی ٹوکن چارج کرتے ہیں، البتہ مختصر ٹیسٹنگ پر بہت ہی کم لاگت آتی ہے۔

کیا میں Grok API سے تصاویر بنا سکتا ہوں؟

جی ہاں، ایک الگ images اینڈ پوائنٹ پر xAI کے Grok Imagine ماڈلز کے ذریعے۔ ہمارا Grok Imagine پیج دیکھیں۔ ہماری چیٹ تصاویر نہیں بناتی۔

Grok.Online کون سا Grok ماڈل استعمال کرتا ہے؟

ہماری چیٹ OpenRouter کے ذریعے Grok 4.20 (سوچنے کے عمل کے بغیر)، Grok 4.3 (کم سوچ بچار کے ساتھ)، اور روزانہ 10 پیغامات تک Grok 4.7 پیش کرتی ہے۔