API Gemini در ایران، با یک کلید سازگار با OpenAI
Gemini خانواده‌ی مدلهای چندوجهی گوگل است. نسخه‌های Flash و Flash Lite سریع و ارزان‌اند و برای حجم بالای درخواست مناسب‌اند. نسخه‌های Pro برای استدلال و تحلیل دقیق‌تر ساخته شده‌اند. بیشتر مدلهای Gemini کانتکست بسیار طولانی و ورودی تصویر دارند.
در هوشوانا مدلهای Gemini را با همان SDK OpenAI صدا می‌زنید. لازم نیست با Google AI Studio یا Vertex AI کار کنید و هزینه به تومان از کیف پولتان کم میشود.
قیمت API Gemini به تومان
قیمت دلاری سازنده ضرب در نرخ دلار هوشوانا (به‌روزشده در ۲۲ مهر ۱۴۰۵). فقط به اندازه‌ی توکن مصرفی پرداخت می‌کنید.
| مدل | نوع | کانتکست | قیمت ورودی | قیمت خروجی | کیفیت فارسی |
|---|---|---|---|---|---|
| Gemini 3.8 Flashgoogle/gemini-3.8-flash | متن | ۱ میلیون توکن | ۲۲۱٬۲۵۰ تومان | ۱٬۱۰۶٬۲۵۰ تومان | ۵ از ۵ |
| Gemini 4 Argongoogle/gemini-4-argon | متن | ۱ میلیون توکن | ۵۹۰٬۰۰۰ تومان | ۲٬۹۵۰٬۰۰۰ تومان | ۵ از ۵ |
| Gemini 3.1 Progoogle/gemini-3.1-pro-preview | متن | ۱ میلیون توکن | ۵۹۰٬۰۰۰ تومان | ۳٬۵۴۰٬۰۰۰ تومان | ۵ از ۵ |
| Nano Banana 2 (Gemini 3.1 Flash Image)google/gemini-3.1-flash-image | متن | ۱۳۱ هزار توکن | ۱۴۷٬۵۰۰ تومان | ۸۸۵٬۰۰۰ تومان | ۳ از ۵ |
| Gemini 2.5 Flashgoogle/gemini-2.5-flash | متن | ۱ میلیون توکن | ۸۸٬۵۰۰ تومان | ۷۳۷٬۵۰۰ تومان | ۴ از ۵ |
| Gemini 3.1 Flash Litegoogle/gemini-3.1-flash-lite | متن | ۱ میلیون توکن | ۷۳٬۷۵۰ تومان | ۴۴۲٬۵۰۰ تومان | ۴ از ۵ |
| Gemini 2.5 Progoogle/gemini-2.5-pro | متن | ۱ میلیون توکن | ۳۶۸٬۷۵۰ تومان | ۲٬۹۵۰٬۰۰۰ تومان | ۴ از ۵ |
| Gemini 3.5 Flash Litegoogle/gemini-3.5-flash-lite | متن | ۱ میلیون توکن | ۸۸٬۵۰۰ تومان | ۷۳۷٬۵۰۰ تومان | ۴ از ۵ |
قیمت مدلهای متنی و Embedding برای هر یک میلیون توکن است. مدلهای تصویر برای هر تصویر، گفتار به متن برای هر دقیقه و متن به گفتار برای هر یک میلیون کاراکتر حساب می‌شوند.
هزینه‌ی تقریبی کارهای رایج
برآورد با توکن‌های میانگین هر کار. عدد دقیق هر درخواست را در لاگ داشبورد می‌بینید، یا متن خودتان را در شمارنده‌ی توکن بسنجید.
| مدل | یک پیام کوتاه چت‌بات | یک مقاله‌ی ۱۵۰۰ کلمه‌ای فارسی | خلاصه‌ی یک سند ۲۰ صفحه‌ای |
|---|---|---|---|
| Gemini 3.5 Flash Liteارزان‌ترین | ۲۳۸ تومان | ۲٬۶۱۷ تومان | ۱٬۹۱۸ تومان |
| Gemini 3.8 Flashسریع و همه‌کاره | ۴۰۹ تومان | ۳٬۹۶۰ تومان | ۴٬۲۰۴ تومان |
| Gemini 2.5 Proاستدلال | ۹۵۹ تومان | ۱۰٬۴۷۳ تومان | ۷٬۸۹۱ تومان |
| Gemini 3.1 Proنسل جدید Pro | ۱٬۲۳۹ تومان | ۱۲٬۶۲۶ تومان | ۱۱٬۶۸۲ تومان |
چرا API مستقیم Gemini از ایران کار نمی‌کند؟
Google AI Studio و Gemini API در ایران در دسترس نیستند و Vertex AI هم به حساب Google Cloud با پرداخت بین‌المللی نیاز دارد.
هوشوانا این مشکل را از سمت سرور حل می‌کند: درخواست شما به سرور هوشوانا در ایران می‌رسد، به مدل اصلی سازنده فرستاده میشود و پاسخ همان مدل برمی‌گردد. پرداخت ریالی است و احراز هویت لازم نیست.
کدام مدل Gemini را انتخاب کنم؟
- حجم بالا با هزینه‌ی کم: Gemini Flash Lite برای دسته‌بندی، ترجمه‌ی کوتاه و پاسخ‌های ساده اقتصادی است.
- کار روزمره: Gemini Flash سرعت خوب و کیفیت مناسب برای چت‌بات و خلاصه‌سازی اسناد دارد.
- تحلیل و استدلال: Gemini Pro را برای مسئله‌های چندمرحله‌ای، کد و اسناد پیچیده انتخاب کنید.
اتصال به API Gemini در سه قدم
ثبت‌نام و شارژ
با شماره موبایل ثبت‌نام کنید و کیف پول را با درگاه بانکی یا کارت‌به‌کارت شارژ کنید.
ساخت کلید
در داشبورد یک کلید بسازید و در صورت نیاز سقف هزینه و مدلهای مجاز تعیین کنید.
تغییر آدرس پایه
در SDK خودتان base_url را روی آدرس هوشوانا بگذارید و مدل را با پیشوند سازنده بنویسید.
آدرس پایه‌ی سازگار با OpenAI: https://hooshvana.ir/api/v1
curl https://hooshvana.ir/api/v1/chat/completions \
-H "Authorization: Bearer $HOOSHVANA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "google/gemini-3.8-flash",
"messages": [
{"role": "user", "content": "یک شعار کوتاه برای کافه‌ام بنویس"}
]
}'کانتکست طولانی و ورودی تصویر
بسیاری از مدلهای Gemini می‌توانند اسناد بسیار بلند، چند فایل یا تاریخچه‌ی طولانی گفت‌وگو را یک‌جا بخوانند. یادتان باشد کل متنی که در هر درخواست میفرستید توکن ورودی حساب میشود، پس برای اسناد تکراری از پایگاه دانش و جست‌وجوی معنایی استفاده کنید تا فقط بخش‌های لازم ارسال شود.
برای فرستادن تصویر، آن را به‌صورت آدرس https یا داده‌ی base64 در محتوای پیام بگذارید؛ همان قالبی که در Chat Completions برای مدلهای بینایی OpenAI استفاده میشود.
پرسش‌های پرتکرار درباره‌ی API Gemini
برای استفاده از Gemini باید SDK گوگل نصب کنم؟
خیر. در هوشوانا مدلهای Gemini از طریق endpoint سازگار با OpenAI در دسترساند. با SDK رسمی OpenAI و شناسهای مثل google/gemini-3.8-flash درخواست میفرستید.
قیمت API Gemini به تومان چقدر است؟
قیمت دلاری گوگل در نرخ دلار هوشوانا ضرب میشود. جدول همین صفحه قیمت تومانی هر یک میلیون توکن ورودی و خروجی مدلهای Flash و Pro را با نرخ امروز نشان میدهد.
کیفیت فارسی Gemini چطور است؟
مدلهای Gemini متن فارسی را خوب میفهمند و تولید میکنند، ولی کیفیت بین نسخهها فرق دارد. ارزیابی کیفیت فارسی هر مدل در صفحهی همان مدل آمده و بهتر است با نمونهی واقعی متن خودتان مقایسه کنید.