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

API جمینای (Gemini) با پرداخت تومانی

مدل‌های Gemini گوگل را با کلید سازگار با OpenAI و اعتبار تومانی صدا می‌زنید؛ کتابخانهٔ OpenAI سر جایش می‌ماند و فقط base_url و نام مدل (مثل gemini-3.5-flash) عوض می‌شود. بخشی از مدل‌ها مستقیم به گوگل وصل‌اند و بخشی با پیشوند openrouter/google/ از راه OpenRouter می‌آیند. قیمت هر مدل به تومان در جدول همین صفحه آمده است.

ساخت حساب و کلید API راهنمای شروع سریع

پیش از خرید بدانید

نشانی پایه (base_url)
https://netarz.ir/api/ai/v1
حداقل شارژ و مالیات

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

تا احراز هویت (KYC) حسابتان تأیید نشده، سقف کل مصرف ۲ دلار است؛ بعد از تأیید، این سقف برداشته می‌شود.
متن درخواست را نگه نمی‌داریم

از هر درخواست فقط فراداده‌ای مثل نام مدل، تعداد توکن، هزینه و IP ثبت می‌شود. خود متن به گوگل می‌رسد؛ اگر شناسهٔ مدل با openrouter/google/ شروع شود، از راه OpenRouter. سیاست دادهٔ همین شرکت‌ها بر متن حاکم است.
خطای پیش از پاسخ هزینه ندارد

اگر خطا پیش از تولید پاسخ رخ بدهد، مبلغی که برای درخواست کنار گذاشته شده بود همان لحظه به اعتبارتان برمی‌گردد.

نمونه‌کد با کتابخانهٔ رسمی 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="gemini-3.5-flash",
    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: "gemini-3.5-flash",
  messages: [{ role: "user", content: "سلام، خودتان را معرفی کنید." }],
});

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

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

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

مدل	کانتکست	ورودی / ۱M	خروجی / ۱M
Gemini 3.8 Flash `gemini-3.8-flash` اتصال مستقیم	1.0M	۲۵۰,۴۲۵ تومان $1.05	۱,۲۵۲,۱۲۵ تومان $5.25
Gemini 3.6 Flash `gemini-3.6-flash` اتصال مستقیم	1.0M	۲۵۰,۴۲۵ تومان $1.05	۱,۲۵۲,۱۲۵ تومان $5.25
Gemini 3.7 Flash `gemini-3.7-flash` اتصال مستقیم	1.0M	۲۵۰,۴۲۵ تومان $1.05	۱,۲۵۲,۱۲۵ تومان $5.25
Gemini 3.5 Flash `gemini-3.5-flash` اتصال مستقیم	1.0M	۵۰۰,۸۵۰ تومان $2.10	۳,۰۰۵,۱۰۰ تومان $12.60
Gemini 3.5 Flash-Lite `gemini-3.5-flash-lite` اتصال مستقیم	1.0M	۱۰۰,۱۷۰ تومان $0.42	۸۳۴,۷۵۰ تومان $3.50
Gemini 3.1 Flash-Lite `gemini-3.1-flash-lite` اتصال مستقیم	1.0M	۸۳,۴۷۵ تومان $0.35	۵۰۰,۸۵۰ تومان $2.10
Gemini 3 Flash (Preview) `gemini-3-flash-preview` اتصال مستقیم	1.0M	۱۶۶,۹۵۰ تومان $0.70	۱,۰۰۱,۷۰۰ تومان $4.20
Gemini Embedding 2 امبدینگ (بردار) `gemini-embedding-2` اتصال مستقیم	8.2K	۶۶,۷۸۰ تومان $0.28	—
Gemini Embedding 001 امبدینگ (بردار) `gemini-embedding-001` اتصال مستقیم	2.0K	۵۰,۰۸۵ تومان $0.21	—
Lyria 3 Clip ساخت موسیقی `openrouter/google/lyria-3-clip-preview` از راه OpenRouter	—	۱۳,۳۵۶ تومان $0.056 هر درخواست	—
Lyria 3 Pro ساخت موسیقی `openrouter/google/lyria-3-pro-preview` از راه OpenRouter	—	۲۶,۷۱۲ تومان $0.112 هر درخواست	—
Google: Gemini 2.5 Flash `openrouter/google/gemini-2.5-flash` از راه OpenRouter	1.0M	۱۰۰,۱۷۰ تومان $0.42	۸۳۴,۷۵۰ تومان $3.50
Google: Gemini 2.5 Flash Lite `openrouter/google/gemini-2.5-flash-lite` از راه OpenRouter	1.0M	۳۳,۳۹۰ تومان $0.14	۱۳۳,۵۶۰ تومان $0.56
Google: Gemini 2.5 Pro `openrouter/google/gemini-2.5-pro` از راه OpenRouter	1.0M	۴۱۷,۳۷۵ تومان $1.75	۳,۳۳۹,۰۰۰ تومان $14.00
Google: Gemini 2.5 Pro Preview 06-05 `openrouter/google/gemini-2.5-pro-preview` از راه OpenRouter	1.0M	۴۱۷,۳۷۵ تومان $1.75	۳,۳۳۹,۰۰۰ تومان $14.00
Google: Gemini 3 Flash Preview `openrouter/google/gemini-3-flash-preview` از راه OpenRouter	1.0M	۱۶۶,۹۵۰ تومان $0.70	۱,۰۰۱,۷۰۰ تومان $4.20
Google: Gemini 3.1 Flash Lite `openrouter/google/gemini-3.1-flash-lite` از راه OpenRouter	1.0M	۸۳,۴۷۵ تومان $0.35	۵۰۰,۸۵۰ تومان $2.10
Google: Gemini 3.1 Flash Lite Preview `openrouter/google/gemini-3.1-flash-lite-preview` از راه OpenRouter	1.0M	۸۳,۴۷۵ تومان $0.35	۵۰۰,۸۵۰ تومان $2.10
Google: Gemini 3.1 Pro Preview `openrouter/google/gemini-3.1-pro-preview` از راه OpenRouter	1.0M	۶۶۷,۸۰۰ تومان $2.80	۴,۰۰۶,۸۰۰ تومان $16.80
Google: Gemini 3.1 Pro Preview Custom Tools `openrouter/google/gemini-3.1-pro-preview-customtools` از راه OpenRouter	1.0M	۶۶۷,۸۰۰ تومان $2.80	۴,۰۰۶,۸۰۰ تومان $16.80
Google: Gemini 3.5 Flash Lite `openrouter/google/gemini-3.5-flash-lite` از راه OpenRouter	1.0M	۱۰۰,۱۷۰ تومان $0.42	۸۳۴,۷۵۰ تومان $3.50
Google: Gemini Flash Latest `openrouter/~google/gemini-flash-latest` از راه OpenRouter	1.0M	۲۵۰,۴۲۵ تومان $1.05	۱,۲۵۲,۱۲۵ تومان $5.25
Google: Gemini Pro Latest `openrouter/~google/gemini-pro-latest` از راه OpenRouter	1.0M	۶۶۷,۸۰۰ تومان $2.80	۴,۰۰۶,۸۰۰ تومان $16.80
Google: Gemma 2 27B `openrouter/google/gemma-2-27b-it` از راه OpenRouter	8.2K	۲۱۷,۰۳۵ تومان $0.91	۲۱۷,۰۳۵ تومان $0.91
Google: Gemma 3 12B `openrouter/google/gemma-3-12b-it` از راه OpenRouter	131.1K	۱۶,۶۹۵ تومان $0.07	۵۰,۰۸۵ تومان $0.21
Google: Gemma 3 27B `openrouter/google/gemma-3-27b-it` از راه OpenRouter	131.1K	۲۶,۷۱۲ تومان $0.112	۱۵۰,۲۵۵ تومان $0.63
Google: Gemma 3 4B `openrouter/google/gemma-3-4b-it` از راه OpenRouter	131.1K	۱۶,۶۹۵ تومان $0.07	۳۳,۳۹۰ تومان $0.14
Google: Gemma 4 26B A4B `openrouter/google/gemma-4-26b-a4b-it` از راه OpenRouter	262.1K	۲۲,۵۳۹ تومان $0.0945	۷۵,۱۲۸ تومان $0.315
Google: Gemma 4 31B `openrouter/google/gemma-4-31b-it` از راه OpenRouter	262.1K	۳۰,۰۵۱ تومان $0.126	۱۱۳,۵۲۶ تومان $0.476

همهٔ مدل‌های Gemini در فهرست کامل مستندات مدل‌ها و قیمت‌ها

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

تولید تصویر با مدل‌های گوگل (Imagen) روی درگاه نیست. برای ساخت تصویر از API، مدل‌های GPT Image را در صفحهٔ API اوپن‌ای‌آی ببینید.
برای مدل‌های Gemini قولی دربارهٔ سرعت یا تعداد درخواست در دقیقه نمی‌دهیم. اگر کارتان حجم بالایی دارد، اول با شارژ کم آزمایش کنید و در کدتان برای خطای 429 تلاش دوباره (retry) بگذارید.
ساخت موسیقی با Lyria، مدل موسیقی گوگل، هم با همین کلید کار می‌کند؛ راهنمایش در مستندات آمده است.

ساخت تصویر با GPT Image: API اوپن‌ای‌آی (OpenAI). ساخت موسیقی: مستندات موسیقی.

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

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

استودیو هوش مصنوعی اکانت‌های آماده

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

به کلید Google AI Studio نیازی ندارید. در نِت اَرز کلید API بگیرید، اعتبار را تومانی بخرید و در کتابخانهٔ رسمی OpenAI، base_url را https://netarz.ir/api/ai/v1 بگذارید. در فیلد model نام مدل Gemini را بنویسید، مثل gemini-3.5-flash.

مدل‌های تصویرساز گوگل (Imagen) روی درگاه نیستند. Gemini روی درگاه برای متن و گفت‌وگو به کار می‌رود و بعضی مدل‌هایش تصویر ورودی را هم می‌خوانند؛ قابلیت هر مدل در جدول آمده است. برای ساخت تصویر، مدل‌های GPT Image با همین کلید در دسترس‌اند.

روی درگاه نِت اَرز هر کلید به‌طور پیش‌فرض ۶۰ درخواست در دقیقه دارد. این سقفِ کلید شماست، نه قولی دربارهٔ ظرفیت خود گوگل؛ برای مدل‌های Gemini سرعت مشخصی قول نمی‌دهیم و در ساعت‌های شلوغ ممکن است خطای 429 بگیرید.

تا احراز هویت (KYC) حسابتان تأیید نشده، سقف کل مصرف ۲ دلار است؛ بعد از تأیید، این سقف برداشته می‌شود. حداقل شارژ ۱۰۰,۰۰۰ تومان است و ۹٪ مالیات بر ارزش افزوده در صفحهٔ پرداخت، در یک ردیف جدا، اضافه می‌شود.

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

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

ساخت حساب و کلید API مستندات API