این راهنما مروری بر گزینههای مختلف پرداخت Gemini API ارائه میدهد، نحوه فعالسازی پرداخت و نظارت بر استفاده را توضیح میدهد و به سوالات متداول (FAQs) در مورد پرداخت پاسخ میدهد.
درباره صورتحساب و سطوح آن
صورتحساب برای API جمینی بر اساس سابقه پرداخت شما محاسبه میشود.
| ردیف استفاده | صلاحیت | سقف ردیف صورتحساب |
|---|---|---|
| رایگان | پروژه فعال یا دوره آزمایشی رایگان | ناموجود |
| ردیف ۱ | یک حساب صورتحساب فعال راهاندازی و پیوند دهید | ۲۵۰ دلار |
| ردیف ۲ | پرداخت ۱۰۰ دلار + ۳ روز پس از اولین پرداخت موفق | ۲۰۰۰ دلار |
| ردیف ۳ | پرداخت ۱۰۰۰ دلار + ۳۰ روز از اولین پرداخت موفق | ۲۰،۰۰۰ تا ۱۰۰،۰۰۰ دلار + |
حسابهای جدید از سطح رایگان شروع میشوند که امکان دسترسی به مدلهای خاصی را در Gemini API و AI Studio، تا سقف نرخ سطح رایگان مدلها، فراهم میکند.
برای استقرار برنامههای خود مستقیماً از حالت ساخت (Build mode)، میتوانید از Google Cloud Starter Tier استفاده کنید. این سطح به شما امکان میدهد تا حداکثر ۲ برنامه کامل را بدون راهاندازی یک پروژه Google Cloud یا حساب صورتحساب منتشر کنید. برای جزئیات بیشتر به بخش «استقرار از Google AI Studio» مراجعه کنید و برای اطلاعات بیشتر به مستندات Google Cloud Starter Tier مراجعه کنید.
برای دسترسی به محدودیتهای نرخ بالاتر، استفاده از مدلهای پیشرفته و اطمینان از اینکه پیامها و پاسخهای شما برای بهبود محصولات گوگل استفاده نمیشوند ، میتوانید یک حساب صورتحساب و پیشپرداخت را به سطوح پرداختشده پیوند دهید. سپس، بر اساس مجموع هزینهها و سن حساب، به سطوح بالاتر منتقل خواهید شد.
سطوح، محدودیتهای نرخ و سقف حسابهای صورتحساب، همگی در سطح حساب صورتحساب تعیین میشوند.
* حریم خصوصی دادهها در سطح سازمانی: برای اطلاعات بیشتر در مورد استفاده از دادهها برای سرویسهای پولی، به شرایط خدمات مراجعه کنید.
برای دسترسی به ردیف پرداختشده، صورتحساب تنظیم کنید
شما میتوانید یک پروژه ایجاد کنید و صورتحساب را تنظیم کنید، یا یک پروژه موجود را وارد کنید تا به سطح پولی در Google AI Studio ارتقا دهید. ارتقا از سطح رایگان به سطح پولی به معنای پیوند دادن یک حساب صورتحساب و پیشپرداخت برای اضافه کردن حداقل 10 دلار (یا معادل آن به ارزهای دیگر) اعتبار به حساب شما است.
- به صفحه کلیدهای API AI Studio، صفحه پروژهها یا هر جایی که دکمه تنظیم صورتحساب را در AI Studio میبینید، بروید.
- کاربران جدید به طور پیشفرض یک پروژه و کلید API برای آنها ایجاد میشود.
- اگر به یک کلید جدید نیاز دارید، روی «ایجاد کلید API» کلیک کنید و کادر محاورهای را دنبال کنید تا یک جفت کلید-پروژه به جدول اضافه شود.
- پروژه Free Tier که میخواهید به Paid Tier ارتقا دهید را پیدا کنید و در زیر ستون Billing Tier روی Set up billing کلیک کنید.
- اگر قبلاً حساب پرداخت گوگل راهاندازی نکردهاید:
- از شما خواسته میشود کشور خود را برای موافقت با شرایط خدمات انتخاب کنید.
- سپس، برای ادامه، اطلاعات تماس و روش پرداخت خود را پر یا تأیید کنید.
- اگر قبلاً حسابهای پرداخت گوگل راهاندازی کردهاید:
- از شما خواسته میشود از بین حسابهای صورتحساب موجود خود، یکی را انتخاب کنید.
- اگر نمیخواهید از هیچ یک از حسابهای موجود خود استفاده کنید، روی «افزودن حساب صورتحساب جدید» کلیک کنید و اطلاعات تماس و روش پرداخت خود را برای ادامه وارد یا تأیید کنید.
- در مرحله بعد، شما یکی از موارد زیر خواهید بود:
- از شما خواسته میشود برای تکمیل تنظیمات صورتحساب، حداقل 10 دلار پیشپرداخت کنید (به این معنی که حساب شما به طور خودکار به طرح صورتحساب پیشپرداخت اختصاص داده شده است)،
- با توجه به انتخاب بین طرحهای صورتحساب Prepay و Postpay برای حساب شما.
- برای یک دوره واسطه به یک طرح صورتحساب Postpay اختصاص داده شده است تا زمانی که سیستم جدید Prepay برای همه کاربران منتشر شود (از ۲۳ مارس ۲۰۲۶).
- پس از پیشپرداخت یا انتخاب Postpay، راهاندازی حساب شما کامل شده است.
به سطح پولی بعدی ارتقا دهید
اگر از قبل در یک سطح پولی هستید و معیارهای تغییر طرح را دارید، به طور خودکار به سطح بعدی ارتقا خواهید یافت (البته بسته به زمان پردازش ).
تأیید وضعیت صورتحساب
پس از اینکه یک حساب پرداخت را به پروژه خود متصل کردید، میتوانید وضعیت آن را در صفحه پرداخت AI Studio مشاهده کنید. برخلاف سطح رایگان، وضعیت سطح پولی پویا است؛ در حالی که سطح استفاده شما توسط سابقه حساب شما تعیین میشود، API Gemini فقط در صورتی درخواستها را ارائه میدهد که مانده اعتبار Prepay مثبتی داشته باشید.
در صفحه پروژهها ، میتوانید سطح و طرح صورتحساب پروژه خود را در زیر ستون سطح صورتحساب مشاهده کنید. هرگونه اقدام مربوط به وضعیت صورتحساب که ممکن است برای نمایش پروژه در ستونهای سطح صورتحساب یا وضعیت لازم باشد، عبارتند از:
- اگر پروژه حساب صورتحساب ندارد، « تنظیم صورتحساب » را انتخاب کنید.
- « تنظیم پیشپرداخت » اگر پروژه حساب صورتحساب متصل دارد، اما ملزم به استفاده از یک طرح صورتحساب پیشپرداخت است که نیاز به تنظیم دارد.
- اگر حساب صورتحساب برای خرید اعتبار لازم باشد اما حساب پرداختهای پیشپرداخت راهاندازی نشده باشد یا موجودی اعتبار موجود تمام شده باشد، « اعتباری وجود ندارد »
برای انجام اقدامات لازم، روی هر یک از پیامها کلیک کنید.
نظارت بر میزان استفاده
شما میتوانید میزان استفاده خود از رابط برنامهنویسی کاربردی Gemini را در Google AI Studio و در مسیر Dashboard > Usage رصد کنید.
طرحهای صورتحساب
طرحهای پرداخت برای Gemini API و AI Studio به دو دسته تقسیم میشوند که زمان پرداخت هزینه استفاده را تعیین میکنند: پیشپرداخت و پسپرداخت. میتوانید طرح پرداخت اختصاص داده شده به خود را بررسی کرده و روشهای پرداخت را در صفحه صورتحساب AI Studio مدیریت کنید.
پیشپرداخت
در طرح پرداخت پیشپرداخت (Prepay)، شما قبل از استفاده از API Gemini، اعتبارهایی را برای موجودی پیشپرداخت خود خریداری میکنید و هزینههای استفاده از API شما تقریباً به صورت آنی از موجودی اعتبار پیشپرداخت شما کسر میشود. میتوانید با اضافه کردن اعتبار به حساب خود یا تنظیم شارژ مجدد خودکار ، پیشپرداخت را انجام دهید. پس از خرید اعتبار، اعتبارهای استفاده نشده پس از ۱۲ ماه منقضی میشوند و قابل استرداد نیستند ، مگر پس از تغییر به حساب Postpay .
وقتی موجودی اعتبار Prepay شما در حساب صورتحساب به 0 دلار برسد، تمام کلیدهای API در تمام پروژههای مرتبط با آن حساب صورتحساب به طور همزمان از کار میافتند. اعتبارات Prepay فقط برای هزینههای استفاده از API Gemini اعمال میشود؛ شما نمیتوانید از آنها برای پرداخت سایر سرویسهای Google Cloud استفاده کنید.
کاربران جدید به طور پیشفرض از طرح صورتحساب Prepay استفاده میکنند. پروژههایی که قبل از معرفی طرحهای صورتحساب Prepay و Postpay فعالیت میکنند، ممکن است قبل از ادامه استفاده از API Gemini، نیاز به بهروزرسانی جزئیات صورتحساب پروژه خود داشته باشند.
توجه داشته باشید که پیشپرداخت برای حسابهای فاکتوردار (یا آفلاین) در دسترس نیست.
افزودن پیشپرداخت به حساب پسپرداخت موجود
اگر حساب Cloud Billing فعلی شما از طرح Postpay استفاده میکند، میتوانید قابلیتهای Prepay را برای خرید اعتبار از قبل اضافه کنید. این اعتبارات پیشپرداخت به شما امکان میدهند بدون ایجاد یک حساب Cloud Billing جدید، از API Gemini استفاده کنید.
در طول تنظیمات برای افزودن Prepay به یک حساب موجود، یک صفحه تأیید اجباری به شما نمایش داده میشود که توضیح میدهد حساب Cloud Billing انتخابی شما اصلاح خواهد شد.
سیستم باید قبل از ارسال پیشپرداخت، وضعیت حساب شما را تغییر دهد. بنابراین، لغو فرآیند پس از تأیید اصلاح اما قبل از تکمیل تنظیمات پیشپرداخت ممکن است منجر به اختلالات موقت در سرویس پروژههایی شود که از قبل به آن حساب Cloud Billing مرتبط هستند. قبل از تأیید انتقال، مطمئن شوید که برای تکمیل فرآیند پیشپرداخت آماده هستید. اگر با مشکلی مواجه شدید، به بخش «خدمات پس از لغو تنظیمات پیشپرداخت مختل شد» مراجعه کنید.
اگر واجد شرایط باشید و به صورت دستی از چرخه پیشپرداخت به چرخه پسپرداخت تغییر دهید، هرگونه اعتبار پیشپرداخت باقیمانده به طور خودکار به روش پرداخت اصلی مورد استفاده برای پیشپرداخت بازپرداخت میشود. با این حال، اگر به هر دلیل دیگری حساب Cloud Billing خود را ببندید، هرگونه اعتبار پیشپرداخت باقیمانده از بین میرود و بازپرداخت نمیشود.
خرید اعتبار
شما میتوانید قبل از استفاده از API Gemini، به صورت دستی اعتبار خریداری کنید تا آنها را به موجودی اعتبار حساب Prepay خود اضافه کنید.
برای خرید اعتبار، به صفحه صورتحساب AI Studio بروید و گزینه خرید اعتبار را انتخاب کنید. حداقل خرید 10 دلار است. حداکثر مبلغ اعتباری که میتوانید پیشپرداخت کنید 5000 دلار است.
بارگیری مجدد خودکار
شارژ مجدد خودکار یک ویژگی اختیاری است که به طور خودکار موجودی اعتبار Prepay شما را در صورت کم شدن، افزایش میدهد. این ویژگی برای جلوگیری از وقفه در سرویس مفید است.
میتوانید شارژ خودکار را تنظیم کنید و وضعیت شارژ خودکار خود را در کارت اعتباری موجود در صفحه صورتحساب AI Studio مشاهده کنید. برای تنظیم روش پرداخت، مبلغ شارژ مجدد و حداقل موجودی که باعث شارژ مجدد میشود، روی تنظیم شارژ خودکار یا مدیریت شارژ خودکار کلیک کنید.
محدودیت شارژ خودکار ماهانه
محدودیت شارژ خودکار ماهانه برای کاربران Prepay در دسترس است و به جلوگیری از هزینههای غیرمنتظره ناشی از شارژ مجدد خودکار مکرر اعتبار کمک میکند. از این ویژگی برای تعیین حداکثر محدودیت برای شارژ مجدد خودکار اعتبار در یک چرخه صورتحساب استفاده کنید. هنگامی که کل مبلغ شارژ مجدد خودکار در یک چرخه صورتحساب به این حد برسد، سیستم شارژ مجدد خودکار را تا شروع ماه بعد غیرفعال میکند. پرداختهای یکبارهای که به صورت دستی انجام میدهید، جزو این محدودیت محسوب نمیشوند.
برای تنظیم محدودیت شارژ خودکار ماهانه هنگام فعال بودن شارژ مجدد خودکار:
- به صفحه صورتحساب استودیوی هوش مصنوعی بروید.
- روی مدیریت بارگذاری خودکار کلیک کنید.
- بخش محدودیت ماهانه را باز کنید و حداکثر محدودیت ماهانه برای بارگذاری خودکار را وارد کنید.
- روی ذخیره کلیک کنید.
پستپی
در طرح پرداخت Postpay، حساب Cloud Billing شما هزینهها را جمع میکند و در پایان ماه یا زمانی که هزینههای شما به سقف هزینهای که به طور خودکار بر اساس سطح حساب شما تعیین شده است ، برسد، به طور خودکار از شما کسر میشود. پرداخت از روش پرداختی که به حساب پرداختهای Postpay شما متصل است، انجام میشود که میتوانید آن را در صفحه صورتحساب AI Studio مدیریت کنید. در صفحه صورتحساب میتوانید موجودی، تاریخهای سررسید و پرداختهای گذشته خود را مشاهده کنید، همچنین پرداختها را انجام داده و روشهای پرداخت را مدیریت کنید.
هنگام تنظیم صورتحساب برای یک پروژه جدید، اگر واجد شرایط Postpay باشید، میتوانید در کادر گفتگوی تنظیم صورتحساب، بین Prepay و Postpay یکی را انتخاب کنید.
پس از اینکه حساب Cloud Billing خود را به طرح Postpay تغییر دادید، تمام پروژههای مرتبط با آن حساب به طرح Postpay منتقل میشوند. میتوانید با دنبال کردن مراحل موجود در Migrate to prepay ، یک حساب واجد شرایط را به Prepay منتقل کنید. همچنین میتوانید یک پروژه را به یک حساب Billing با طرح صورتحساب متفاوت منتقل کنید تا چرخه شارژ آن پروژه تغییر کند؛ به مستندات Cloud در مورد مدیریت صورتحساب برای پروژهها مراجعه کنید.
میتوانید اطلاعات بیشتری در مورد چرخه شارژ Postpay را در راهنمای Cloud Billing کسب کنید.
مهاجرت به پیشپرداخت
گوگل هوش مصنوعی استودیو در حال انتقال حسابهای توسعهدهندگان از Postpay به Prepay برای استفاده از Gemini API است. این تغییر فقط برای Gemini API اعمال میشود؛ سایر سرویسهای Google Cloud مرتبط با حساب صورتحساب شما همچنان در Postpay باقی میمانند.
برای جلوگیری از وقفه در سرویس، قبل از تاریخ پایان اعتبار در اطلاعیه حساب خود، به پیشپرداخت (Prepay) تغییر دهید و اعتبار اضافه کنید. حسابهایی که فقط از ویژگیهای Free Tier استفاده میکنند، نیازی به انجام اقدامی ندارند.