Grok API: নিজের কোড থেকে Grok ব্যবহারের উপায়

কোড থেকে Grok ব্যবহারের দুটি উপায়

ডেভেলপাররা মূলত দুটি উপায়ে Grok মডেলগুলো কল করতে পারেন। প্রথমটি হলো xAI API, যা কোম্পানিটি নিজে পরিচালনা করে (বর্তমান ব্র্যান্ডিং SpaceXSI) এবং এর কী (key) পাওয়া যায় console.x.ai থেকে। দ্বিতীয়টি হলো OpenRouter-এর মতো কোনো মডেল রাউটার, যা একটিমাত্র কী এবং একটি বিলের মাধ্যমেই একাধিক প্রোভাইডারের মডেল ব্যবহারের সুবিধা দেয়। দুটি মাধ্যমই 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 এবং মডেল আইডিগুলোর শুরুতে 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": "You are a concise assistant."},
      {"role": "user", "content": "Give me three tips for a first marathon."}
    ]
  }'

OpenAI লাইব্রেরি সহ Python

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-এ কী-টি 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—সবকটি মডেলই ছবি বিশ্লেষণ করতে পারে। OpenAI-স্টাইলের মেসেজে পার্টসের লিস্ট ব্যবহার করুন। xAI-এর ডকুমেন্টেশন অনুযায়ী ২০ 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 মডেলের আইডি ও খরচ

SpaceXAI-এর জন্য OpenRouter-এ তালিকাভুক্ত বর্তমান টেক্সট মডেলগুলো নিচে দেওয়া হলো, সাথে কনটেক্সট সাইজ এবং প্রতি ১০ লাখ টোকেনের খরচ (OpenRouter-এর তালিকাভুক্ত মূল্য, অক্টোবর ২০২৬)। ২০০,০০০ টোকেনের নিচের প্রম্পটের জন্য xAI API-তেও একই বেস রেট নেওয়া হয়।

xAI-এর মডেল ও প্রাইসিং পেজ থেকে কিছু জরুরি তথ্য (xAI-এর তালিকাভুক্ত মূল্য, অক্টোবর ২০২৬):

• বড় প্রম্পটে খরচ বেশি: প্রম্পটের আকার ২০০,০০০ টোকেনে পৌঁছালে পুরো রিকোয়েস্টের বিল বেশি রেটে হয়: Grok 4.7-এর জন্য $৪ / $১২ এবং Grok 4.3 ও 4.20-এর জন্য $২.৫০ / $৫।
• ক্যাশড ইনপুটে সাশ্রয়: বারবার ব্যবহৃত প্রম্পট প্রিফিক্সের ক্ষেত্রে প্রতি ১০ লাখ টোকেনে Grok 4.7-এর জন্য $০.৫০ এবং Grok 4.3 ও 4.20-এর জন্য $০.২০ খরচ হয়।
• ব্যাচ জব: সময় নিয়ে করা যায় এমন ব্যাচ কাজের জন্য ছাড় রয়েছে, এবং OpenRouter-এ x-ai/grok-4.3:batch-এর রেট তালিকাভুক্ত আছে $১ / $২ হিসেবে।
• সোর্সভেদে কনটেক্সটের পার্থক্য: OpenRouter-এ Grok 4.20-এর কনটেক্সট ২,০০০,০০০ টোকেন উল্লেখ থাকলেও xAI-এর নিজস্ব পেজে ১,০০০,০০০ টোকেন বলা হয়েছে।

মডেলের চিন্তার টোকেনগুলোও আউটপুট হিসেবে গণ্য হয়, তাই একটি রিজনিং মডেলের প্রতি উত্তরের খরচ তার টোকেন প্রতি মূল্যের চেয়ে বেশি হতে পারে।

কিছু দরকারি পরামর্শ

• সাধারণ চ্যাট, রিরাইটিং ও টেক্সট এক্সট্রাকশনের জন্য Grok 4.20 non-reasoning দিয়ে শুরু করুন। এটি দ্রুত ও সাশ্রয়ী। জটিল কাজে গতির চেয়ে উত্তরের মান বেশি গুরুত্বপূর্ণ হলে Grok 4.3 বা 4.7 ব্যবহার করুন।
• তথ্যের সময়সীমা মনে রাখুন: xAI অনুসারে, Grok 4.7 মে ২০২৬ পর্যন্ত তথ্য জানে। এর পরের কোনো তথ্যের জন্য প্রম্পটেই তা উল্লেখ করুন, অথবা xAI-এর সার্ভার-সাইড ওয়েব ও X সার্চ টুল ব্যবহার করুন (প্রতি কলের জন্য আলাদা বিল প্রযোজ্য)।
• সিস্টেম মেসেজ ব্যবহার করুন: মডেলের ভূমিকা, টোন এবং উত্তরের ফরম্যাট কেমন হবে তা এতে বলে দিন। কোডের মাধ্যমে রেসপন্স পার্স করতে চাইলে স্কিমা সহ JSON ফরম্যাটে আউটপুট চান।
• রেট লিমিট খেয়াল রাখুন: 429 রেসপন্স পেলে কিছুক্ষণ বিরতি দিয়ে আবার রিকোয়েস্ট পাঠান।
• নিয়মাবলি মেনে চলুন: API ব্যবহারের ক্ষেত্রে xAI-এর গ্রহণযোগ্য ব্যবহারের নীতি (acceptable use policy) প্রযোজ্য, এবং safety_identifier ফিল্ডের মাধ্যমে প্রতি ব্যবহারকারীর রিকোয়েস্ট আলাদাভাবে ট্র্যাক করা যায়।

কোনো সমস্যা দেখা দিলে

• 401 বা 403 এরর: API কী মিসিং, বাতিল হয়ে গেছে বা ভুল এনভায়রনমেন্টে লোড হয়েছে। এটি ঠিকমতো আছে কিনা তা নিশ্চিত করতে সার্ভারে কী-এর প্রথম কয়েকটি অক্ষর প্রিন্ট করে দেখুন।
• Model not found: মডেলের প্রিফিক্স চেক করুন। OpenRouter-এর ক্ষেত্রে x-ai/grok-4.7 এবং xAI-এর ক্ষেত্রে শুধু grok-4.7 দিতে হয়।
• ফাঁকা বা ধীরগতির উত্তর: রিজনিং মডেলের ক্ষেত্রে এটি সাধারণত ঘটে যখন উত্তরের জন্য বরাদ্দ বাজেট চিন্তাভাবনা করতেই শেষ হয়ে যায়। রিজনিং এফোর্ট কমান অথবা max_tokens বাড়িয়ে দিন।
• ছবি রিজেক্ট হওয়া: ছবিটি JPEG বা PNG ফরম্যাটে রূপান্তর করুন এবং সাইজ নির্দিষ্ট সীমার মধ্যে রাখুন।

সাধারণ জিজ্ঞাসা

Grok API কি OpenAI SDK-র সাথে কাজ করে?

হ্যাঁ। xAI কী সহ SDK-র এন্ডপয়েন্ট https://api.x.ai/v1-এ অথবা OpenRouter কী সহ OpenRouter-এ রিডাইরেক্ট করে Grok মডেল আইডি ব্যবহার করুন।

Grok API কি বিনামূল্যে ব্যবহার করা যায়?

স্থায়ী কোনো ফ্রি টিয়ার নেই। xAI এবং OpenRouter উভয় মাধ্যমেই টোকেন অনুযায়ী বিল করা হয়, তবে ছোটখাটো টেস্টের জন্য খরচ খুবই সামান্য।

Grok API দিয়ে কি ছবি তৈরি করা যায়?

হ্যাঁ, আলাদা একটি ইমেজ এন্ডপয়েন্টে xAI-এর Grok Imagine মডেলগুলোর মাধ্যমে। বিস্তারিত জানতে আমাদের Grok Imagine পেজটি দেখুন। আমাদের চ্যাটে ছবি তৈরি করা যায় না।

Grok.Online-এ কোন Grok মডেল ব্যবহার করা হয়?

আমাদের চ্যাটে OpenRouter-এর মাধ্যমে রিজনিং ছাড়া Grok 4.20, লো রিজনিং এফোর্টে Grok 4.3 এবং প্রতিদিন সর্বোচ্চ ১০টি মেসেজ পর্যন্ত Grok 4.7 ব্যবহারের সুযোগ রয়েছে।