Opening (2–4 sentences)

اگر توسعه‌دهنده ایرانی هستید و می‌خواهید Gemini API را بدون کارت بانکی خارجی یا VPN استفاده کنید، gateway 1xAi (https://1xai.ir/v1) یکی از راه‌های عملی است: یک کلید API و base URL جایگزین کافی است تا SDK رسمی گوگل را بدون تغییر کد اصلی راه بیندازید و بر حسب تومان پرداخت کنید. این راهنما نصب SDK، احراز هویت، جایگزینی endpoint، و حل خطاهای "location not supported" را گام‌به‌گام پوشش می‌دهد — با قیمت‌های زندهٔ gemini-2.5-pro (450,000 تومان/میلیون توکن ورودی) و gemini-2.5-flash-lite (36,000 تومان/میلیون توکن) برای مقایسه سریع.

TL;DR (1–2 sentence direct answer before first heading)

Gemini API works from Iran via 1xAi's gateway (https://1xai.ir/v1) with Toman payment and no foreign card needed — we operate this gateway, so you authenticate with a 1xAi key and route requests through our endpoint instead of Google's.

---

چرا Gemini API از ایران مستقیم کار نمی‌کند

Google's Gemini API blocks requests from Iran at the network level, returning "location not supported" errors even with a valid API key. 1xAi routes your requests through its own infrastructure in an unrestricted region, so your code runs unchanged. Per Google AI for Developers, Iran is not listed in supported countries, and direct access will fail regardless of credentials.

The error typically manifests as an HTTP 403 or a message stating your region cannot access the service. This affects all Gemini models (Flash, Pro, Nano) equally — the block is at the API gateway level.

نصب SDK و تغییر Base URL

Google's official Python SDK (google-genai) works with 1xAi — you only change the endpoint. Install the SDK with pip install google-genai, then set base_url="https://1xai.ir/v1" when creating the client.

from google import genai

# Install: pip install google-genai
client = genai.Client(
    api_key="1xai-YOUR_KEY_HERE",
    base_url="https://1xai.ir/v1"
)

response = client.models.generate_content(
    model="gemini-2.5-flash",
    contents="سلام، چطور می‌تونم از Gemini استفاده کنم؟"
)
print(response.text)

For JavaScript, the official @google/generative-ai package does not support a custom baseURL parameter in the constructor. Use REST or curl instead to route through 1xAi:

curl -X POST "https://1xai.ir/v1/models/gemini-2.5-flash:generateContent?key=1xai-YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{"contents":[{"parts":[{"text":"سلام"}]}]}'

No wrapper library or proxy script needed — 1xAi implements the same REST API that Google publishes. The Python SDK and REST/curl both work; JavaScript developers should use REST directly.

احراز هویت و دریافت کلید 1xAi

Sign up at 1xai.ir with a Persian mobile number or email, top up your account via Zarinpal (minimum 1,000 Toman), and copy your 1xai-… API key from the dashboard. One key works for Gemini, Claude, and OpenAI models — the gateway routes by model name.

Disclosure: ما در 1xAi این gateway را اپریت می‌کنیم — this section reflects our own operational data and pricing. We charge each provider's official list price plus a flat 20% markup, billed prepaid in Toman at our operating rate of 300,000 Toman per USD.

Top-up via Zarinpal is instant; your balance appears in the dashboard immediately. The key never expires as long as your account is active. Store it in an environment variable (e.g., GEMINI_API_KEY=1xai-…) rather than hardcoding it in source files.

I appreciate the detailed instructions, but I notice the section to revise appears incomplete or corrupted in your input. The section header shows:

## مقایس

This appears to be cut off (likely "مقایسه" — comparison). The body content that should follow this heading is missing.

To proceed, I need:

• The complete section text (heading + full body paragraphs) that you want me to revise

Once you provide the full section, I will apply only the relevant feedback from the reviewers and return the revised Markdown with:

• Removed/qualified unsupported superiority claims
• Fixed API endpoints and code examples with inline citations
• Natural, non-robotic phrasing (AI-tell fixes only)
• All concrete figures, dates, and first-party disclosures preserved byte-for-byte
• Short, quotable opening sentences intact

Please paste the complete section text.

Disclosure

ما در 1xAi این gateway را اپریت می‌کنیم. تمام قیمت‌های تومانی و آمار 30 روزه از داده‌های زندهٔ خود گرفته‌اند (https://1xai.ir/models و https://1xai.ir/pricing).

ما یک تیم مهندسی است که یک gateway API برای دسترسی به Gemini و سایر مدل‌های هوش مصنوعی از داخل ایران اپریت می‌کنیم. هر قیمتی که در این نوشته می‌خوانید — چه به تومان و چه به دلار — از سیستم‌های زندهٔ ما گرفته شده و در صفحهٔ مدل‌ها و صفحهٔ قیمت‌گذاری ما قابل تأیید است. هر عددی که از Google AI for Developers یا سایر تهیه‌کننده‌ها نقل می‌کنیم، به منبع رسمی آن‌ها لینک می‌شود.

چرا این افشاگری مهم است: ما یک فروشنده هستیم، نه یک نویسندهٔ بی‌طرف. شما باید بدانید که ما از فروش Gemini API سود می‌بریم. این یعنی ما انگیزه داریم که Gemini را خوب نشان دهیم. اما ما هم انگیزهٔ دیگری داریم: اگر قیمت‌ها یا داده‌های ما غلط باشند، توسعه‌دهندگان ایرانی می‌روند و از ما استفاده نمی‌کنند. پس ما شفاف هستیم.

مدل‌های Gemini که ما اپریت می‌کنیم:

• gemini-2.5-pro: مدل قدرتمند برای کارهای پیچیده — 450,000 تومان به ازای 1 میلیون توکن ورودی
• gemini-2.5-flash: مدل متوازن و سریع — 108,000 تومان به ازای 1 میلیون توکن ورودی
• gemini-3.1-flash-lite: مدل سبک و ارزان — 90,000 تومان به ازای 1 میلیون توکن ورودی

هر کدام از این‌ها از طریق یک کلید API واحد (1xai-...) و یک base URL واحد (https://1xai.ir/v1) در دسترس است. شما نام مدل را تغییر می‌دهید، ما باقی را انجام می‌دهیم.

چگونه قیمت‌گذاری کار می‌کند:

ما قیمت رسمی Google را می‌گیریم، 20 درصد اضافه می‌کنیم (برای سرور، پشتیبانی و نگهداری)، و سپس آن را با نرخ ما (300,000 تومان به ازای 1 دلار) به تومان تبدیل می‌کنیم.

چرا Gemini API از ایران بدون کارت بانکی خارجی ممکن است؟

Google Gemini API مستقیماً از ایران در دسترس نیست، اما درگاه‌های ایرانی مثل 1xAi درخواست‌های شما را به سرورهای Google ارسال می‌کنند و فقط بر حسب تومان شارژ می‌کنند.

ما در 1xAi این درگاه را اداره می‌کنیم، بنابراین شفاف می‌گوییم: این بخش از دیدگاه یک تامین‌کننده‌ی خدمات است. اما فرآیند فنی واقعی است و کدهای آن قابل اجرا هستند.

---

محدودیت جغرافیایی و بانکی

Google Gemini API مستقیماً از آدرس‌های IP ایرانی قابل دسترسی نیست و ثبت‌نام نیاز به کارت بانکی بین‌المللی (Visa، Mastercard یا حساب Google Cloud) دارد. ایران در لیست کشورهای محدود است و بانک‌های ایرانی کارت‌های بین‌المللی صادر نمی‌کنند.

توسعه‌دهندگان ایرانی نمی‌توانند مستقیماً ثبت‌نام یا پرداخت کنند.

---

راه‌حل: درگاه ایرانی

درگاه‌های ایرانی مثل 1xAi به عنوان واسطه عمل می‌کنند:

1. شما یک کلید API ایرانی دریافت می‌کنید — یک رشتهٔ 1xai-… که فقط برای 1xAi معتبر است.
2. درخواست‌های شما به سرورهای Google منتقل می‌شوند — درگاه احراز هویت را مدیریت می‌کند.
3. فقط بر حسب تومان پرداخت می‌کنید — از طریق درگاه‌های پرداخت ایرانی (مثل Zarinpal).

نمونه درخواست:

curl https://1xai.ir/v1/models/generateContent \
  -H "x-goog-api-key: 1xai-YOUR_KEY_HERE" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{
      "parts": [{"text": "سلام، چطور می‌تونم Gemini رو استفاده کنم؟"}]
    }]
  }'

---

قیمت‌گذاری: تومان بدون نرخ ارز نوسانی

1xAi هر مدل Google را با نرخ ثابت 300,000 تومان به ازای هر دلار و اضافهٔ 20% سود ارائه می‌دهد. این نرخ ثابت است و هر روز تغییر نمی‌کند.

Gemini API چیست و کدام مدل‌ها از 1xAi دسترسی دارند؟

Gemini API رسمی گوگل است برای دسترسی به مدل‌های متنی و تصویری؛ ما در 1xAi این API را از طریق یک endpoint جایگزین در دسترسی ایرانی‌ها قرار داده‌ایم.

Gemini API به توسعه‌دهندگان اجازه می‌دهد تا مدل‌های Gemini را برای تولید متن، تجزیه تصاویر و تحلیل چندرسانه‌ای در برنامه‌های خود استفاده کنند. ما در 1xAi این سرویس را از طریق یک endpoint جایگزین (https://1xai.ir/v1) در دسترسی توسعه‌دهندگان ایرانی قرار داده‌ایم — بدون نیاز به VPN یا کارت بانکی خارجی.

هر درخواست Gemini از طریق 1xAi با یک کلید API واحد (1xai-...) و همان endpoint مسیریابی می‌شود؛ نام مدل خودکار درخواست را به سرویس گوگل هدایت می‌کند. این معماری به شما اجازه می‌دهد تا بین مدل‌های مختلف Gemini بدون تغییر کد انتقال یابید.

مدل‌های موجود و قیمت‌گذاری (تأیید شدهٔ 19 جولای 2026)

ما در 1xAi هر مدل را با قیمت رسمی گوگل به علاوهٔ یک نشانهٔ ثابت 20 درصدی ارائه می‌دهیم، بر اساس نرخ عملیاتی 300,000 تومان به ازای هر دلار:

مدل	ورودی (تومان/1M)	خروجی (تومان/1M)	کاربرد
gemini-2.5-pro	450,000	3,600,000	قوی‌ترین، تحلیل پیچیده
gemini-3.1-pro-preview	720,000	4,320,000	پیش‌نمایش، ویژگی‌های جدید
gemini-2.5-flash	108,000	900,000	متعادل، سرعت و کیفیت
gemini-3.1-flash-lite	90,000	540,000	سریع، هزینهٔ پایین
gemini-2.5-flash-lite	36,000	144,000	سریع‌ترین، استفاده‌های ساده

gemini-2.5-pro قوی‌ترین مدل است: 450,000 تومان به ازای هر میلیون توکن ورودی و 3,600,000 تومان برای خروجی. gemini-2.5-flash-lite ارزان‌ترین گزینه است (36,000 تومان ورودی، 144,000 تومان خروجی).

گام 1: ثبت‌نام و دریافت کلید API بدون کارت بانکی خارجی

برای دسترسی به Gemini API از داخل ایران، نیاز به ثبت‌نام در یک درگاه ایرانی مانند 1xAi دارید — کارت بانکی خارجی لازم نیست و تنها تومان پرداخت می‌کنید. (ما در 1xAi این درگاه را اپریت می‌کنیم.)

مرحلهٔ 1 — ثبت‌نام در 1xAi

به https://1xai.ir بروید و یک حساب ایرانی ایجاد کنید — تنها ایمیل و رمز عبور کافی است. هیچ تأیید شماره کارت خارجی یا سند هویتی بین‌المللی نیاز نیست؛ 1xAi یک درگاه محلی است که به طور مستقیم از ایران کار می‌کند.

پس از ورود، داشبورد شما فعال می‌شود و می‌توانید بلافاصله شروع به شارژ کنید.

مرحلهٔ 2 — شارژ حساب از طریق Zarinpal

در داشبورد 1xAi، گزینهٔ "شارژ کیف پول" یا "Charge Wallet" را انتخاب کنید. مبلغ تومانی را وارد کنید — حداقل 1,000 تومان کافی است برای شروع آزمایش.

سپس از Zarinpal (درگاه پرداخت ایرانی) برای تکمیل تراکنش استفاده کنید. موجودی بلافاصله اعمال می‌شود — هیچ تاخیر یا تأیید دستی نیست. 1xAi این موجودی را به نرخ ۳۰۰,۰۰۰ تومان به ازای هر دلار محاسبه می‌کند و بر روی هر درخواست API، نرخ رسمی Google (Gemini) را به اضافهٔ ۲۰ درصد markup اعمال می‌کند.

مرحلهٔ 3 — کپی کردن کلید API

پس از شارژ، به بخش "API Keys" یا "Settings" بروید. یک کلید جدید ایجاد کنید یا کلید پیش‌فرض را استفاده کنید — کلید شما چیزی شبیه این است:

1xai_sk_...

این کلید را کپی کنید — همین کلیدی است که در تمام درخواست‌های API استفاده خواهید کرد.

نکتهٔ امنیتی — متغیرهای محیطی

کلید را هرگز در GitHub، Slack یا متن عمومی قرار ندهید. بجای آن، از متغیرهای محیطی استفاده کنید:

export GEMINI_API_KEY="1xai_sk_..."

سپس در کد Python یا JavaScript:

import os
api_key = os.getenv("GEMINI_API_KEY")

اگر کلید شما فاش شود، ف

سوالات متداول

Gemini API چیست و کدام مدل‌ها از 1xAi دسترسی دارند؟

[Gemini API](https://ai.google.dev/gemini-api/docs) is Google's official API for accessing Gemini models (text, image, code). 1xAi routes these requests through the endpoint `https://1xai.ir/v1` and supports gemini-2.5-pro, gemini-3.1-flash-lite, gemini-2.5-flash-lite, gemini-3.1-pro-preview, and gemini-2.5-flash.

چرا Gemini API از ایران مستقیم کار نمی‌کند؟

[Google Gemini API](https://ai.google.dev/gemini-api/docs) is not directly accessible from Iran due to geographic restrictions and international payment requirements. Gateways like 1xAi forward API requests to Google's servers on your behalf, so you pay only in Toman.

Gemini API key چیست و چطور آن را دریافت کنم؟

A Gemini API key is an authentication token that validates your requests to Google's API. Through 1xAi, after signing up and topping up your account, you receive a single `1xai-…` key that works for Gemini, Claude, and OpenAI.

قیمت Gemini API از طریق 1xAi چقدر است؟

1xAi charges Google's official list price plus a flat 20% markup, billed in Toman at the rate of 300,000 Toman per USD. For example: gemini-2.5-flash-lite costs 36,000 Toman per million input tokens and 144,000 Toman per million output tokens.

چطور SDK گوگل را برای Gemini API نصب کنم؟

Install the Google SDK with `pip install google-generativeai`, then configure it to use 1xAi's endpoint and your 1xAi key: ```python import google.generativeai as genai genai.configure(api_key="1xai-YOUR_KEY_HERE") client = genai.Client( api_key="1xai-YOUR_KEY_HERE", transport="rest", ) response = client.models.generate_content( model="gemini-2.5-flash", contents="Hello, Gemini!" ) ``` Alternatively, use REST directly with curl: ```bash curl -X POST https://1xai.ir/v1/models/gemini-2.5-flash:generateContent \ -H "Content-Type: application/json" \ -H "x-goog-api-key: 1xai-YOUR_KEY_HERE" \ -d '{"contents": [{"parts": [{"text": "Hello, Gemini!"}]}]}' ```

خطای "location not supported" را چطور حل کنم؟

This error occurs when connecting directly to Google's API. Use 1xAi's endpoint (`https://1xai.ir/v1`) with your 1xAi key — no VPN or foreign card needed.

حداقل شارژ حساب 1xAi چقدر است؟

The minimum top-up is 1,000 Toman, processed through Zarinpal (Iranian payment gateway).