Google Gemini API رایگان

هدف استفاده و نیت جست‌وجو

Google Gemini API برای کاربرانی مناسب است که در منطقه رسمی پشتیبانی‌شده به مدل‌های Gemini و رابط سازگار با OpenAI نیاز دارند. ایران در فهرست رسمی مناطق پشتیبانی‌شده قرار ندارد و تست مستقیم ثبت‌شده نیز پاسخ ۴۰۳ داده است؛ بنابراین این صفحه وضعیت منطقه‌ای را شفاف توضیح می‌دهد و سرویس را به‌عنوان گزینه مستقیم برای کاربران داخل ایران معرفی نمی‌کند.

مراحل ثبت‌نام

1. پیش از ساخت کلید، فهرست رسمی Available regions را بررسی کنید؛ فقط کاربری که از نظر منطقه و شرایط حساب مجاز است باید از Google AI Studio کلید API بسازد.
2. کلید را در متغیر محیطی GEMINI_API_KEY نگهداری کنید و آن را در JavaScript سمت مرورگر، مخزن عمومی یا پیام پشتیبانی منتشر نکنید.
3. مدل و سهمیه را در AI Studio و مستندات فعلی کنترل کنید؛ وجود Free Tier یا یک مدل در مستندات به معنی پشتیبانی منطقه‌ای برای ایران نیست.

نمونه اولین درخواست API

curl https://generativelanguage.googleapis.com/v1beta/openai/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $GEMINI_API_KEY" \
  -d '{"model":"gemini-2.5-flash-lite","messages":[{"role":"user","content":"سلام! کوتاه پاسخ بده."}]}'

این نمونه فقط برای حساب و منطقه رسمی پشتیبانی‌شده است. از آن برای دورزدن محدودیت منطقه‌ای استفاده نکنید؛ شناسه مدل و محدودیت حساب نیز باید پیش از اجرا در مستندات رسمی کنترل شود.

منبع رسمی نمونه درخواست — بررسی‌شده در 2026-07-16

خطاهای رایج و رفع اشکال

• 400 — پیش‌شرط حساب یا منطقه برقرار نیست

  پیام FAILED_PRECONDITION را بررسی کنید؛ Free Tier ممکن است برای کشور حساب یا محل استفاده در دسترس نباشد. فهرست مناطق رسمی و وضعیت billing را بدون تلاش برای دورزدن سیاست منطقه‌ای کنترل کنید. منبع رسمی (2026-07-16)

• 403 — دسترسی یا منطقه مجاز نیست

  اعتبار کلید، محدودیت پروژه و فهرست رسمی مناطق را بررسی کنید. برای ایران، Catalog پروژه وضعیت officially_unsupported را بر اساس سند رسمی و تست مستقیم ثبت کرده است. منبع رسمی (2026-07-16)

• 429 — سهمیه درخواست تکمیل شده

  مصرف مدل و پروژه را در AI Studio بررسی کنید، درخواست‌ها را کاهش دهید و retry را با exponential backoff و jitter انجام دهید؛ سهمیه مدل‌ها یکسان نیست. منبع رسمی (2026-07-16)

• 503 — مدل موقتاً شلوغ است

  درخواست را با backoff محدود تکرار کنید، ورودی را کوتاه‌تر کنید یا مدل مناسب دیگری را فقط از فهرست رسمی انتخاب کنید؛ retry نامحدود اجرا نکنید. منبع رسمی (2026-07-16)

چه زمانی این Provider انتخاب مناسبی نیست؟

• برای استفاده مستقیم از داخل ایران، چون ایران در فهرست رسمی مناطق پشتیبانی‌شده نیست و Evidence پروژه نیز پاسخ ۴۰۳ ثبت کرده است.
• زمانی که پروژه به سازگاری کامل و بدون تفاوت با تمام قابلیت‌های OpenAI API وابسته است؛ لایه compatibility باید برای قابلیت موردنظر جداگانه تست شود.
• زمانی که مدل یا سهمیه ثابت و تضمین‌شده لازم است و تغییرات مدل یا محدودیت‌های حساب قابل پذیرش نیست.

راهنماهای مرتبط

• openai-sdk-custom-base-url
• best-free-llm-api-iran
• free-tier-vs-trial-vs-credit

آخرین بازبینی محتوای این صفحه: 2026-07-16