سوال از هوش مصنوعی گوگل آنلاین در ۱۴۰۵: راهنمای رایگان و API

برای پرسیدن سؤال و آزمودن ایده، همان اپ Google Gemini یا AI Studio کافی است و لازم نیست پولی بدهید. اما وقتی کاربر واقعی دارید، به سقف روزانه برمی‌خورید یا پایداری برایتان مهم است، باید به API بروید. ما در 1xAi خودمان گیت‌وی API را اداره می‌کنیم، و در ادامه نشان می‌دهیم دقیقاً کجا باید از یکی به دیگری بروید.

سوال از هوش مصنوعی گوگل آنلاین رایگان تا کجا کافی است؟

چت رایگان Gemini و AI Studio برای پرسش، آزمودن پرامپت و پروژه شخصی کافی‌اند. اگر قرار است کاربران دیگر به محصول شما تکیه کنند، پیش از استفاده شرایط و تعهدات همان سطح رایگان را از منابع رسمی گوگل بررسی کنید (این یک راهنمای عمومی است، نه نقل از تعهد رسمی گوگل).

اپ چت و AI Studio یکی نیستند

• اپ چت Gemini: با حساب گوگل وارد می‌شوید و بدون کد سؤال می‌پرسید. این ابزار برای استفاده مستقیم انسان است. اگر می‌پرسید «چگونه از هوش مصنوعی سوال کنیم»، شروع کار از همین‌جاست.
• AI Studio: محیطی برای آزمودن پرامپت است و کلید رایگان هم از آن گرفته می‌شود. کلید به کار وقتی می‌آید که یک برنامه باید خودش سؤال بپرسد، یعنی همان چیزی که در جستجوی «api هوش مصنوعی» دنبالش هستند.

پرسیدن با عکس

در اپ Gemini می‌توان همراه سؤال، عکس هم فرستاد. جزئیاتش، از نوع فایل تا امکانات در دسترس، به حساب شما و امکانات فعال آن بستگی دارد. برای سوال از هوش مصنوعی گوگل آنلاین با عکس، همان صفحه رسمی را مرجع بگیرید و بیش از این از جایی تقلید نکنید.

داده و شرایط استفاده

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

سطح رایگان خود 1xAi

ما در 1xAi هم چت فارسی داریم: چت فارسی 1xAi در پلن رایگان هر ۳۰ روز یک سهمیه چت می‌دهد و برای هفته هم سقفی دارد. این سهمیه روی gemini-2.5-flash، gpt-4o-mini و claude-haiku-4-5 مصرف می‌شود. سهمیه تمام‌شدنی است و برای چت در نظر گرفته شده؛ مقدار دقیق آن و سطح‌های پولی در صفحه پلن‌ها آمده است.

محدودیت‌های رایگان در عمل چه شکلی‌اند: RPM، RPD و حجم توکن؟

سقف رایگان با سه شمارنده سنجیده می‌شود: درخواست در دقیقه، درخواست در روز و توکن در دقیقه؛ هر کدام زودتر پر شد، بقیه فرقی ندارند. این بخش راهنمای عمومی است و عمداً عدد نمی‌دهد.

• RPM تعداد درخواست در یک دقیقه است. رباتی که چند کاربر هم‌زمان دارد، اول به همین می‌خورد.
• RPD تعداد درخواست در یک روز است. برای محصولی با کاربران ثابت، معمولاً همین سقف پایدارتر از بقیه تنگ می‌شود.
• TPM مجموع توکن‌های ورودی در دقیقه است. پیام‌های بلند، فایل یا عکس سنگین آن را زودتر پر می‌کنند، حتی اگر تعداد درخواست‌ها کم باشد.

عدد رسمی را فقط از صفحه محدودیت‌ها (rate limits) در حساب AI Studio خودتان بخوانید. سقف‌ها از مدلی به مدل دیگر فرق دارند و ممکن است عوض شوند، پس عدد نقل‌شده در مقاله‌ها قابل اتکا نیست.

برای برآورد، این فرمول کافی است:

درخواست‌های روزانه ≈ کاربران فعال × پیام‌ها در هر نشست

اگر نتیجه به RPD مدلِ انتخابی‌تان نزدیک شد، سطح رایگان برای شما کافی نیست. تلاش‌های مجدد پس از خطا هم درخواست حساب می‌شوند، پس کمی حاشیه اطمینان بگذارید.

درباره پایداری هم صریح بگوییم: ما برای سطح رایگان هیچ SLA یا آپ‌تایم تضمین‌شده‌ای سراغ نداریم و عددی از خودمان نمی‌سازیم. برای کار واقعی، برنامه جایگزین داشته باشید.

کدام سناریو رایگان می‌ماند و کدام به API می‌رسد؟ (جدول تصمیم)

نمونه‌سازی رایگان می‌ماند، ربات و اپ استارتاپ باید به API پولی برسند، و تولید محتوای روزانه به حجم دسته‌ای شما بستگی دارد.

	نمونه‌سازی	ربات یا اپ استارتاپ	تولید محتوای روزانه
رایگان کافی است؟	بله، تا وقتی فقط خودتان و تیم کوچک استفاده می‌کنید	خیر	فقط برای حجم کم
گلوگاه اصلی	سقف درخواست در دقیقه (RPM)	ترافیک غیرقابل‌پیش‌بینی و خطای ۴۲۹	حجم دسته‌ای و توکن خروجی
پیشنهاد	کلید رایگان AI Studio	API پولی با gemini-2.5-flash یا gemini-2.5-pro	اول حجم را بسنجید، بعد تصمیم بگیرید

در ربات یا اپ، ترافیک را نمی‌توانید پیش‌بینی کنید. وقتی سقف رد شود، کاربر خطای ۴۲۹ می‌بیند و همین تجربه را خراب می‌کند. برای این سناریو gemini-2.5-flash مدل ارزان‌تر است و مارک‌آپ ۳۰٪ دارد. برای کارهای سنگین‌تر، gemini-2.5-pro با مارک‌آپ ۱۵٪ گزینه بعدی است. نرخ لحظه‌ای هر دو را در صفحه مدل‌ها ببینید، چون قیمت‌ها با نرخ بازار هر صبح به‌روز می‌شوند.

تولید محتوای روزانه مرز روشنی ندارد. هرچه دسته‌ها بزرگ‌تر شوند و خروجی بلندتری بخواهید، هزینه توکن خروجی مهم‌تر می‌شود. ترجمه با هوش مصنوعی نمونه‌ای از همین کار دسته‌ای است؛ اینجا درباره کیفیت ترجمه ادعایی نمی‌کنیم و فقط الگوی مصرف را مقایسه می‌کنیم.

اگر حجم شما کم است، رایگان‌ماندن منطقی است و خرید API ضروری نیست.

هزینه ماهانه تومانی هر سناریو چطور حساب می‌شود؟

هزینه ماهانه از جمع دو بخش به‌دست می‌آید: توکن ورودی و توکن خروجی هر کدام در قیمت هر ۱ میلیون توکن همان مدل ضرب می‌شوند.

هزینه ماهانه = (توکن ورودی ماهانه ÷ ۱ میلیون × قیمت ورودی هر ۱ میلیون) + (توکن خروجی ماهانه ÷ ۱ میلیون × قیمت خروجی هر ۱ میلیون)

حجم توکن را از سناریوی خودتان برآورد کنید و قیمت‌ها را از جدول زیر بردارید. خروجی معمولاً گران‌تر از ورودی است، پس سناریوهایی با پاسخ‌های بلند را جداگانه حساب کنید.

مدل	هر ۱ میلیون توکن ورودی	هر ۱ میلیون توکن خروجی
claude-3-5-haiku	۳۲۳٬۲۸۰ تومان	۱٬۶۱۶٬۴۰۰ تومان
claude-3-7-sonnet-20250219	۹۶۹٬۸۴۰ تومان	۴٬۸۴۹٬۲۰۰ تومان

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

قیمت از کجا می‌آید

قیمت هر مدل برابر است با قیمت رسمی ارائه‌دهنده به‌علاوه مارک‌آپ مخصوص همان مدل. کارمزد ۱۵ تا ۳۰٪ بسته به مدل است. نرخ تومان هر روز ساعت ۹ صبح تهران با بازار همگام می‌شود، پس قیمت تومانی با نرخ روز تغییر می‌کند. قیمت امروز را در صفحه قیمت‌ها ببینید.

شارژ و شروع بدون هزینه

پرداخت پیش‌پرداخت و تومانی است و با زرین‌پال انجام می‌شود. حداقل مبلغ شارژ هنگام پرداخت نمایش داده می‌شود و ۱۰٪ ارزش‌افزوده هم در همان مرحله اضافه می‌شود.

اگر نمی‌خواهید با پرداخت شروع کنید، چرخ هدیه را امتحان کنید. هر حساب یک چرخش دارد و اعتبار هدیه به کیف پول اضافه می‌شود و منقضی نمی‌شود. مبلغ دقیق را قرعه‌کشی سرور تعیین می‌کند و قابل تضمین نیست.

خطای ۴۲۹ و «سهمیه تمام شد» یعنی چه و چه باید کرد؟

خطای ۴۲۹ معمولاً یعنی از یک سقف نرخ گذشته‌اید. اگر سقف دقیقه‌ای باشد با صبر برطرف می‌شود، اما اگر پیام از پر شدن سهمیه روزانه خبر بدهد، تلاش مجدد کمکی نمی‌کند.

دو سقف، دو درمان

این تقسیم‌بندی یک راهنمای عمومی است و جزئیات سقف‌ها به مدل و حساب شما بستگی دارد. اگر از سقف تعداد درخواست در دقیقه (RPM) یا توکن در دقیقه (TPM) رد شده باشید، چند ثانیه تأخیر و تلاش مجدد معمولاً کافی است. اگر به سقف درخواست در روز (RPD) رسیده باشید، تا بازنشدن سهمیه هر تلاشی احتمالاً همان خطا را برمی‌گرداند. علت را از متن پیام خطا تشخیص دهید و فقط برای محدودیت موقت دوباره تلاش کنید.

نمونه کد با تلاش مجدد و عقب‌نشینی نمایی

پیش‌نیاز: pip install "openai>=1" و تنظیم کلید 1xai-… در متغیر محیطی ONEXAI_API_KEY. تلاش مجدد داخلی SDK را خاموش کرده‌ایم تا با حلقه ما دوباره‌کاری نشود. تابع is_daily_quota یک تشخیص تقریبی بر پایه کلمات پیام است و قالب پیام ممکن است بسته به مدل فرق کند، پس آن را با پیام‌های واقعی خودتان تطبیق دهید.

import os
import random
import time

from openai import OpenAI, RateLimitError

client = OpenAI(
    api_key=os.environ["ONEXAI_API_KEY"],  # کلید 1xai-... از متغیر محیطی
    base_url="https://1xai.ir/v1",
    max_retries=0,
)


def is_daily_quota(err: Exception) -> bool:
    # تشخیص تقریبی: اگر پیام از سقف روزانه حرف بزند، تلاش مجدد بی‌فایده است
    text = str(err).lower()
    return any(k in text for k in ("daily", "per day", "rpd", "روزانه"))


def ask(prompt: str, max_attempts: int = 5) -> str:
    delay = 2.0
    for attempt in range(1, max_attempts + 1):
        try:
            resp = client.chat.completions.create(
                model="gemini-2.5-flash",
                messages=[{"role": "user", "content": prompt}],
            )
            return resp.choices[0].message.content
        except RateLimitError as e:
            if is_daily_quota(e):
                raise RuntimeError(f"به نظر سهمیه روزانه پر شده است: {e}") from e
            if attempt == max_attempts:
                raise RuntimeError(f"پس از {max_attempts} تلاش هنوز ۴۲۹: {e}") from e
            wait = delay + random.uniform(0, 1)
            print(f"۴۲۹؛ تلاش {attempt} ناموفق بود، {wait:.1f} ثانیه صبر می‌کنیم")
            time.sleep(wait)
            delay *= 2


if __name__ == "__main__":
    print(ask("تفاوت RPM و RPD را در دو جمله توضیح بده."))

خروجی مورد انتظار: متن پاسخ مدل چاپ می‌شود. اگر پیام خطا به سقف روزانه اشاره کند، کد بدون تلاش مجدد متوقف می‌شود. در غیر این صورت و با ادامه ۴۲۹، پس از پنج تلاش (با فاصله‌های حدود ۲، ۴، ۸ و ۱۶ ثانیه به‌علاوه مقدار تصادفی) پیام خطا می‌آید.

سه راه برای کم‌شدن خطا

• صف و کنترل هم‌زمانی: تعداد درخواست‌های هم‌زمان را با صف یا سمافور محدود کنید تا موج ناگهانی به سقف دقیقه‌ای نخورد.
• کوتاه‌کردن ورودی: تاریخچه گفتگو و متن‌های تکراری را حذف کنید، چون سقف TPM با طول ورودی پر می‌شود.
• کش پرامپت: اگر بخش بزرگی از پرامپت ثابت است (مثلاً دستورالعمل سیستمی بلند)، کش پرامپت هزینه و حجم پردازش آن بخش را کم می‌کند. روی اندپوینت‌های اختصاصی گیت‌وی، مانند /anthropic، قابلیت کش Anthropic حفظ می‌شود.

درباره پایداری گیت‌وی

آمار ۳۰ روز اخیر را فقط برای مدل‌هایی داریم که در پایگاه داده‌مان داده دارند: gpt-4.1 با ۱۰۳ درخواست و gpt-5.5 با ۳۲۵ درخواست، هر دو با نرخ موفقیت ۱۰۰٪ (جزئیات در صفحه مدل‌ها). برای gemini-2.5-flash آماری نداریم که بخواهیم عدد بدهیم. این ارقام گزارش عملکرد گذشته‌اند. اگر محصول شما به سطح خدمت مشخصی نیاز دارد، پیش از استفاده در تولید شرایط موردنظرتان را جداگانه بررسی کنید و کد خود را برای ۴۲۹ آماده نگه دارید.

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

چگونه از هوش مصنوعی سوال کنیم

با حساب گوگل وارد Google Gemini شوید و سوال را کامل بنویسید: موضوع، هدف، سطح یا پایه تحصیلی و قالب پاسخ دلخواه. مثلاً بنویسید «این تست شیمی دوازدهم را مرحله‌به‌مرحله حل کن». اگر پاسخ کلی بود، در همان گفتگو جزئیات بیشتری بدهید.

آیا سوال از هوش مصنوعی گوگل آنلاین رایگان کافی است؟

برای پرسیدن، یادگیری و آزمودن پرامپت، بله. اگر کاربر واقعی، سقف روزانه یا نیاز به پایداری دارید، باید به API بروید. سقف‌های رایگان بسته به مدل و زمان تغییر می‌کنند و عدد دقیق را فقط در حساب AI Studio خودتان می‌بینید.

چه زمانی باید از نسخه رایگان به API پولی بروم؟

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

از ایران چطور به Gemini API دسترسی بگیرم؟

ما در 1xAi خودمان گیت‌وی API را اداره می‌کنیم. کلید 1xai-… را از داشبورد می‌گیرید و با آدرس https://1xai.ir/v1 یا SDK رسمی Google GenAI و بدون VPN و کارت خارجی وصل می‌شوید. پیش از کدنویسی می‌توانید مدل‌ها را در پلی‌گراند وب امتحان کنید.

هزینه API در 1xAi چطور حساب می‌شود؟

هزینه برابر قیمت رسمی هر ارائه‌دهنده به‌علاوه کارمزد ۱۵ تا ۳۰٪ بسته به مدل است. پرداخت پیش‌پرداخت و تومانی از طریق زرین‌پال انجام می‌شود و حداقل مبلغ شارژ را هنگام شارژ کیف پول می‌بینید. قیمت‌ها با نرخ بازار هر روز به‌روز می‌شوند؛ برای مبلغ دقیق هر مدل قیمت و مدل‌های زنده را ببینید.