API هوش مصنوعی نِت اَرز · سازگار با OpenAI

API گراک (Grok) با همان کد OpenAI

مدل‌های Grok شرکت xAI را با کتابخانهٔ رسمی OpenAI و نشانی پایهٔ نِت اَرز صدا می‌زنید و در فیلد model شناسه‌ای مثل openrouter/x-ai/grok-4.6 را می‌نویسید. Grok را مستقیم از xAI نمی‌گیریم: همهٔ مدل‌هایش از راه OpenRouter می‌آیند و شناسه‌شان با openrouter/x-ai/ شروع می‌شود. اعتبار را تومانی می‌خرید و قیمت هر مدل به تومان در جدول پایین آمده است.

نمونه‌کد با کتابخانهٔ رسمی OpenAI

همان کتابخانه‌ای که برای OpenAI نصب می‌کنید. نشانی پایه را https://netarz.ir/api/ai/v1 بگذارید، کلید نِت اَرز را جای کلید OpenAI و در فیلد model شناسهٔ مدل را از جدول پایین بردارید.

پاسخ تکه‌تکه (استریم) با stream=True و در همان قالب OpenAI می‌رسد. برای n8n، LangChain و ابزارهای دیگر، نمونه‌های مستندات را ببینید.

$ pip install openai

from openai import OpenAI

client = OpenAI(
    base_url="https://netarz.ir/api/ai/v1",
    api_key="sk-ntz-v1-...",  # کلید پروژهٔ نِت اَرز
)

response = client.chat.completions.create(
    model="openrouter/x-ai/grok-4.6",
    messages=[{"role": "user", "content": "سلام، خودتان را معرفی کنید."}],
)

print(response.choices[0].message.content)

$ npm install openai

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://netarz.ir/api/ai/v1",
  apiKey: process.env.NETARZ_API_KEY, // sk-ntz-v1-...
});

const response = await client.chat.completions.create({
  model: "openrouter/x-ai/grok-4.6",
  messages: [{ role: "user", content: "سلام، خودتان را معرفی کنید." }],
});

console.log(response.choices[0].message.content);

مدل‌های Grok و قیمت هر کدام به تومان

قیمت‌ها برای هر یک میلیون توکن ورودی و خروجی است و هر روز به‌روز می‌شود. توکن (Token) تکهٔ کوچکی از متن است که مدل با آن حساب می‌کند.

مدل ورودی / ۱M خروجی / ۱M
SpaceXAI: Grok 4.20 openrouter/x-ai/grok-4.20 از راه OpenRouter ۵۲۹,۸۶۸ تومان $1.9121 ۱,۰۵۹,۷۳۵ تومان $3.8243
SpaceXAI: Grok 4.20 Multi-Agent openrouter/x-ai/grok-4.20-multi-agent از راه OpenRouter ۵۲۹,۸۶۸ تومان $1.9121 ۱,۰۵۹,۷۳۵ تومان $3.8243
SpaceXAI: Grok 4.3 openrouter/x-ai/grok-4.3 از راه OpenRouter ۵۲۹,۸۶۸ تومان $1.9121 ۱,۰۵۹,۷۳۵ تومان $3.8243
SpaceXAI: Grok 4.5 openrouter/x-ai/grok-4.5 از راه OpenRouter ۸۴۷,۷۸۸ تومان $3.0595 ۲,۵۴۳,۳۶۳ تومان $9.1785
SpaceXAI: Grok 4.6 openrouter/x-ai/grok-4.6 از راه OpenRouter ۸۴۷,۷۸۸ تومان $3.0595 ۲,۵۴۳,۳۶۳ تومان $9.1785
SpaceXAI: Grok 4.7 openrouter/x-ai/grok-4.7 از راه OpenRouter ۸۴۷,۷۸۸ تومان $3.0595 ۲,۵۴۳,۳۶۳ تومان $9.1785
SpaceXAI: Grok Build 0.1 openrouter/x-ai/grok-build-0.1 از راه OpenRouter ۴۲۳,۸۹۴ تومان $1.5297 ۸۴۷,۷۸۸ تومان $3.0595
SpaceXAI: Grok Imagine Image Quality تولید تصویر openrouter/x-ai/grok-imagine-image-quality از راه OpenRouter ۲۱,۱۹۵ تومان $0.0764 هر تصویر —
SpaceXAI: Grok Imagine Video تولید ویدیو openrouter/x-ai/grok-imagine-video از راه OpenRouter ۲۱,۱۹۵ تومان $0.0764 هر ثانیه ویدیو —
SpaceXAI: Grok Imagine Video 1.5 تولید ویدیو openrouter/x-ai/grok-imagine-video-1.5 از راه OpenRouter ۳۳,۹۱۲ تومان $0.1223 هر ثانیه ویدیو —
SpaceXAI: Grok Imagine Video 1.5 Lite تولید ویدیو openrouter/x-ai/grok-imagine-video-1.5-lite از راه OpenRouter ۸,۴۷۸ تومان $0.0305 هر ثانیه ویدیو —
SpaceXAI: Grok STT 1.0 تبدیل گفتار به متن openrouter/x-ai/grok-stt-1.0 از راه OpenRouter ۷۰۷ تومان $0.0025 هر دقیقه صوت —
SpaceXAI: Grok Voice TTS 1.0 تبدیل متن به گفتار openrouter/x-ai/grok-voice-tts-1.0 از راه OpenRouter ۶,۳۵۸,۴۰۶ تومان $22.9462 هر ۱M کاراکتر —
xAI: Grok Imagine Image 2.0 تولید تصویر openrouter/x-ai/grok-imagine-image-2.0 از راه OpenRouter ۱۶,۹۵۶ تومان $0.0611 هر تصویر —
xAI: Grok Latest openrouter/~x-ai/grok-latest از راه OpenRouter ۸۴۷,۷۸۸ تومان $3.0595 ۲,۵۴۳,۳۶۳ تومان $9.1785

چند نکتهٔ مهم دربارهٔ Grok روی درگاه ما

  • درخواست شما از راه OpenRouter به xAI می‌رسد؛ برای همین شناسهٔ مدل با openrouter/x-ai/ شروع می‌شود. نام تنها، مثل grok-4، بدون این پیشوند پیدا نمی‌شود.
  • تصویر و ویدیو با Grok Imagine هم با همین کلید ساخته می‌شود: تصویر در مسیر /images/generations و ویدیو در /videos. پاسخ تصویر همیشه base64 است، نه لینک، و واحد قیمت هر مدل کنار قیمتش آمده است.
  • شناسهٔ openrouter/~x-ai/grok-latest همیشه به تازه‌ترین نسخهٔ Grok اشاره می‌کند. برای کدی که در محیط اصلی (production) کار می‌کند، شناسهٔ نسخه‌دار را بنویسید تا رفتار مدل یک‌باره عوض نشود.

کد نمی‌نویسید؟

اگر فقط می‌خواهید با Grok گفت‌وگو کنید، به وب‌سرویس نیازی ندارید. در «استودیو هوش مصنوعی» همین مدل‌ها را در مرورگر و با همان اعتبار به کار می‌گیرید؛ اگر اشتراک خود سرویس را می‌خواهید، اکانت‌های آماده را ببینید.

برای اینکه هزینهٔ Grok را با GPT، Claude، Gemini و DeepSeek در یک کار واقعی کنار هم ببینید، راهنمای کامل مقایسهٔ قیمت API مدل‌ها را بخوانید.

پرسش‌های متداول

به حساب xAI و کارت ارزی نیازی ندارید. در نِت اَرز کلید API بگیرید، اعتبار را تومانی بخرید و در کتابخانهٔ رسمی OpenAI، base_url را https://netarz.ir/api/ai/v1 بگذارید. در فیلد model شناسهٔ Grok را با پیشوند openrouter/x-ai/ بنویسید، مثل openrouter/x-ai/grok-4.6.

بله. مدل‌های Grok Imagine تصویر را در مسیر images/generations و ویدیو را در مسیر videos می‌سازند، با همان کلید و همان اعتبار. هر مدل اندازه‌ها و مدت‌های خودش را دارد و اگر مقداری بفرستید که مدل ندارد، پیش از کم شدن هر هزینه‌ای خطا می‌گیرید. اگر ویدیو ساخته نشود، هزینه‌اش خودکار برمی‌گردد.

هر مدل Grok برای هر یک میلیون توکن ورودی و خروجی قیمت جدا دارد و قیمت تومانی‌اش در جدول همین صفحه آمده است. حداقل شارژ ۵۰,۰۰۰ تومان است و ۹٪ مالیات بر ارزش افزوده در صفحهٔ پرداخت، در یک ردیف جدا، اضافه می‌شود.

بله. با API گراک اعتبار می‌خرید تا Grok را از کد، ربات یا سایت خودتان صدا بزنید و هزینهٔ هر درخواست به اندازهٔ مصرف کم شود. SuperGrok اشتراک گفت‌وگو در خود سایت و اپ Grok است و اکانتش را در فروشگاه جدا می‌فروشیم.

اشتراک ماهانه ندارد؛ به اندازهٔ مصرف می‌پردازید

حداقل شارژ ۵۰,۰۰۰ تومان است و ۹٪ مالیات بر ارزش افزوده در صفحهٔ پرداخت، در یک ردیف جدا، اضافه می‌شود. کلید را هر وقت بخواهید باطل می‌کنید.