چطور یک کلید API Google Gemini رایگان دریافت کنیم (۲۰۲۶)

Gemini API از Google یکی از سخاوتمندانه‌ترین API‌های رایگان هوش مصنوعی موجود است. با سطح رایگانی که شامل ۱,۵۰۰ درخواست در روز برای Gemini 2.0 Flash و دسترسی به چندین نوع مدل می‌شود، نقطه شروع عالی‌ای برای توسعه‌دهندگانی است که اپلیکیشن‌های هوش مصنوعی می‌سازند. این راهنما نحوه دریافت کلید API رایگان و اولین فراخوانی‌های API را توضیح می‌دهد.

نکته مهم برای توسعه‌دهندگان ایرانی: دسترسی مستقیم به Google AI Studio ممکن است به دلیل محدودیت‌های جغرافیایی دشوار باشد. Hypereal یک راه‌حل بدون تحریم برای دسترسی به Gemini و سایر مدل‌های پریمیوم ارائه می‌دهد که در ادامه توضیح می‌دهیم.

چه چیزی رایگان دریافت می‌کنید

Google AI Studio دسترسی رایگان API به مدل‌های Gemini با محدودیت‌های زیر را فراهم می‌کند:

مدل	محدودیت سطح رایگان	محدودیت نرخ	پنجره context
Gemini 2.0 Flash	۱,۵۰۰ درخواست/روز	۱۵ RPM	۱ میلیون توکن
Gemini 2.0 Flash-Lite	۱,۵۰۰ درخواست/روز	۳۰ RPM	۱ میلیون توکن
Gemini 1.5 Pro	۵۰ درخواست/روز	۲ RPM	۲ میلیون توکن
Gemini 2.0 Flash Thinking	۱,۵۰۰ درخواست/روز	۱۰ RPM	۱ میلیون توکن

RPM = درخواست در دقیقه. محدودیت‌های روزانه در نیمه‌شب وقت اقیانوس آرام ریست می‌شوند.

اینها محدودیت‌های واقعاً مفیدی هستند. با ۱,۵۰۰ درخواست در روز برای Gemini 2.0 Flash، می‌توانید اپلیکیشن‌های تولیدی را رایگان بسازید و اجرا کنید — چیزی که کمتر ارائه‌دهنده هوش مصنوعی دیگری پیشنهاد می‌دهد.

مرحله ۱: به Google AI Studio بروید

مرورگرتان را باز کنید و به aistudio.google.com بروید.
با حساب Google خود وارد شوید. هر حساب Gmail کار می‌کند — حساب توسعه‌دهنده خاصی لازم نیست.
به محیط آزمایشگاه AI Studio می‌رسید که می‌توانید prompt‌ها را به صورت تعاملی تست کنید.

مرحله ۲: کلید API خود را تولید کنید

روی "Get API Key" در نوار کناری چپ (یا نوار ناوبری بالا) کلیک کنید.
روی "Create API Key" کلیک کنید.
یکی از موارد زیر را انتخاب کنید:
- Create API key in new project (برای کاربران جدید توصیه می‌شود)
- Create API key in existing project (اگر قبلاً یک پروژه Google Cloud دارید)
کلید API که ظاهر می‌شود را کپی کنید. با AIza... شروع می‌شود.

# Store the key as an environment variable
export GEMINI_API_KEY="AIzaSy-your-api-key-here"

مهم: کلید API سطح رایگان بدون نیاز به تنظیم پرداخت کار می‌کند. نیازی به افزودن کارت اعتباری یا فعال‌سازی صورت‌حساب در Google Cloud ندارید. با این حال، کلیدهای سطح رایگان داده‌های شما را در برنامه‌های بهبود Google شامل می‌کنند. برای استفاده تولیدی با حریم خصوصی داده، سطح پولی از طریق Vertex AI را در نظر بگیرید.

مرحله ۳: SDK را نصب کنید

Google SDKهای رسمی برای Python و JavaScript ارائه می‌دهد:

# Python
pip install google-genai

# JavaScript / Node.js
npm install @google/genai

مرحله ۴: اولین فراخوانی API خود را انجام دهید

نمونه Python

import os
from google import genai

client = genai.Client(api_key=os.environ["GEMINI_API_KEY"])

response = client.models.generate_content(
    model="gemini-2.0-flash",
    contents="Write a Python function that implements binary search on a sorted list. Include type hints and docstring."
)

print(response.text)

نمونه JavaScript / Node.js

const { GoogleGenAI } = require("@google/genai");

const ai = new GoogleGenAI({ apiKey: process.env.GEMINI_API_KEY });

async function main() {
  const response = await ai.models.generateContent({
    model: "gemini-2.0-flash",
    contents: "Write a TypeScript utility type that makes all nested properties optional. Explain how it works.",
  });

  console.log(response.text);
}

main();

نمونه cURL

curl "https://generativelanguage.googleapis.com/v1beta/models/gemini-2.0-flash:generateContent?key=$GEMINI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{
      "parts": [{"text": "Explain the CAP theorem with practical examples."}]
    }]
  }'

مرحله ۵: از endpoint سازگار با OpenAI استفاده کنید

Google همچنین یک endpoint سازگار با OpenAI ارائه می‌دهد که با ابزارهایی که از قبل از قالب OpenAI پشتیبانی می‌کنند آسان است:

from openai import OpenAI

client = OpenAI(
    api_key=os.environ["GEMINI_API_KEY"],
    base_url="https://generativelanguage.googleapis.com/v1beta/openai/"
)

response = client.chat.completions.create(
    model="gemini-2.0-flash",
    messages=[
        {"role": "system", "content": "You are a helpful coding assistant."},
        {"role": "user", "content": "Write a Redis caching middleware for Express.js."}
    ]
)

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

این سازگاری به معنی استفاده از کلید رایگان Gemini API در موارد زیر است:

Cursor (به عنوان کلید API سفارشی)
Continue.dev
Aider
LiteLLM
هر اپلیکیشن مبتنی بر OpenAI SDK

مرحله ۶: از قابلیت‌های multimodal استفاده کنید

Gemini به طور ذاتی multimodal است. می‌توانید تصویر، صدا، ویدیو و اسناد ارسال کنید:

تحلیل یک تصویر

import base64

with open("screenshot.png", "rb") as f:
    image_data = base64.b64encode(f.read()).decode()

response = client.models.generate_content(
    model="gemini-2.0-flash",
    contents=[
        {"text": "Describe what you see in this screenshot and identify any UI/UX issues."},
        {
            "inline_data": {
                "mime_type": "image/png",
                "data": image_data
            }
        }
    ]
)

print(response.text)

تحلیل یک سند PDF

with open("report.pdf", "rb") as f:
    pdf_data = base64.b64encode(f.read()).decode()

response = client.models.generate_content(
    model="gemini-2.0-flash",
    contents=[
        {"text": "Summarize the key findings in this report and list action items."},
        {
            "inline_data": {
                "mime_type": "application/pdf",
                "data": pdf_data
            }
        }
    ]
)

مرحله ۷: از Streaming برای UX بهتر استفاده کنید

برای اپلیکیشن‌های چت، streaming حس real-time می‌دهد:

response = client.models.generate_content_stream(
    model="gemini-2.0-flash",
    contents="Write a comprehensive guide to database indexing strategies."
)

for chunk in response:
    print(chunk.text, end="", flush=True)

مرحله ۸: از خروجی ساختاریافته استفاده کنید

Gemini از JSON mode برای خروجی ساختاریافته پشتیبانی می‌کند:

import json

response = client.models.generate_content(
    model="gemini-2.0-flash",
    contents="List the top 5 JavaScript frameworks with their GitHub stars, license, and primary use case.",
    config={
        "response_mime_type": "application/json"
    }
)

data = json.loads(response.text)
for framework in data:
    print(f"{framework['name']}: {framework['stars']} stars")

نکات بهینه‌سازی سطح رایگان

برای وظایف ساده از Flash-Lite استفاده کنید. Gemini 2.0 Flash-Lite محدودیت نرخ بالاتری دارد (۳۰ RPM در مقابل ۱۵ RPM) و برای خلاصه‌سازی، دسته‌بندی، و تولید کد ساده کاملاً مناسب است.

context تکراری را cache کنید. اگر همان system prompt یا context را به طور مکرر ارسال می‌کنید، از قابلیت context caching در Gemini استفاده کنید تا مصرف توکن و تأخیر کاهش یابد.

درخواست‌ها را کارآمد دسته‌بندی کنید. به جای ارسال ۱۰ فراخوانی API جداگانه، کارهای مرتبط را در درخواست‌های کمتر و جامع‌تر ترکیب کنید.

مصرف خود را رصد کنید. Google AI Studio داشبورد مصرف دارد. به طور دوره‌ای آن را بررسی کنید تا مطمئن شوید به محدودیت‌های روزانه نزدیک نمی‌شوید.

از context یک میلیون توکنی با خرد استفاده کنید. Gemini 2.0 Flash از یک میلیون توکن context پشتیبانی می‌کند. می‌توانید کل کدبیس‌ها یا اسناد را در یک درخواست ارسال کنید، که از چندین درخواست کوچک‌تر کارآمدتر است.

Gemini رایگان در مقابل سایر APIهای رایگان هوش مصنوعی

ویژگی	Gemini رایگان	اعتبار رایگان OpenAI	DeepSeek رایگان	Claude رایگان
محدودیت روزانه	۱,۵۰۰	N/A (بودجه توکن)	~۲,۰۰۰	N/A (محدودیت نرخ)
بهترین مدل	Gemini 2.0 Flash	GPT-4o mini	DeepSeek-V3	Claude Sonnet
پنجره context	۱ میلیون توکن	۱۲۸ هزار توکن	۶۴ هزار توکن	۲۰۰ هزار توکن
Multimodal	بله (تصویر، ویدیو، صدا، PDF)	متن + تصویر	فقط متن	متن + تصویر
نیاز به کارت اعتباری	خیر	خیر	خیر	خیر
سازگار با OpenAI	بله	بومی	بله	خیر
کیفیت کد	خوب	خوب	عالی	عالی
مدت	سطح رایگان دائمی	اعتبار در ۳ ماه منقضی می‌شود	اعتبار منقضی می‌شود	سطح رایگان دائمی

Gemini با سطح رایگان دائمی (بدون اعتبار منقضی‌شونده)، پنجره context عظیم، و قابلیت‌های multimodal برتری دارد.

مشکلات رایج

خطای "API key not valid": مطمئن شوید کلید کامل را کپی کرده‌اید، از جمله پیشوند AIza. فاصله‌های اضافی در انتها هم می‌توانند مشکل ایجاد کنند.

خطای "Quota exceeded": به محدودیت روزانه یا نرخ در دقیقه رسیده‌اید. منتظر بمانید تا محدودیت ریست شود (نیمه‌شب PT برای روزانه، ۱ دقیقه برای RPM).

پاسخ‌های ناسازگار: برای خروجی‌های قطعی temperature=0 تنظیم کنید. دمای پیش‌فرض مقداری تصادفی‌بودن را مجاز می‌داند.

نگرانی‌های حریم خصوصی داده: فراخوانی‌های API سطح رایگان ممکن است برای بهبود مدل‌های Google استفاده شوند. برای داده‌های حساس، از سطح پولی از طریق Vertex AI استفاده کنید.

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

آیا سطح رایگان Gemini واقعاً دائمی است؟ Google سطح رایگان را از زمان راه‌اندازی AI Studio حفظ کرده است. با اینکه محدودیت‌ها ممکن است تغییر کنند، خود سطح رایگان ثابت بوده است.

آیا می‌توانم از سطح رایگان در تولید استفاده کنم؟ می‌توانید، اما به محدودیت‌های نرخ (۱۵ RPM برای Flash) و سیاست استفاده از داده توجه کنید. برای اپلیکیشن‌های تولیدی با داده کاربری، سطح پولی Vertex AI را در نظر بگیرید.

آیا به حساب Google Cloud نیاز دارم؟ خیر. یک حساب معمولی Google/Gmail برای سطح رایگان از طریق AI Studio کافی است. برای سطح پولی Vertex AI به Google Cloud نیاز دارید.

آیا می‌توانم درخواست‌های رایگان بیشتری دریافت کنم؟ یک پروژه Google Cloud بسازید و billing را فعال کنید تا محدودیت‌های نرخ بالاتر و قیمت‌گذاری pay-as-you-go دریافت کنید. راهی برای افزایش محدودیت‌های سطح رایگان وجود ندارد.

کدام مدل Gemini برای کدنویسی بهتر است؟ Gemini 2.0 Flash بهترین تعادل سرعت و کیفیت را برای وظایف کدنویسی در سطح رایگان ارائه می‌دهد. برای چالش‌های پیچیده‌تر کد، Gemini 1.5 Pro (۵۰ درخواست رایگان/روز) استدلال بهتری دارد.

جمع‌بندی

سطح رایگان API Gemini از Google احتمالاً بهترین API رایگان هوش مصنوعی موجود در ۲۰۲۶ است. ترکیب ۱,۵۰۰ درخواست روزانه، پنجره context یک میلیون توکنی، پشتیبانی multimodal، و سازگاری OpenAI آن را گزینه عالی هم برای نمونه‌سازی و هم تولید می‌کند.

اگر پروژه‌هایتان علاوه بر قابلیت‌های متنی به تولید رسانه‌های هوش مصنوعی مثل تصویر، ویدیو یا آواتارهای سخنگو نیاز دارند، Hypereal AI را به پشته فنی‌تان اضافه کنید. توسعه‌دهندگان ایرانی می‌توانند از Hypereal بدون هیچ مانع تحریمی استفاده کنند.

Hypereal AI را رایگان امتحان کنید — ۳۵ اعتبار، بدون نیاز به کارت اعتباری.