این راهنما مروری بر گزینههای مختلف پرداخت Gemini API ارائه میدهد، نحوه فعالسازی پرداخت و نظارت بر استفاده را توضیح میدهد و به سوالات متداول (FAQs) در مورد پرداخت پاسخ میدهد.
درباره صورتحساب و سطوح آن
هزینه استفاده از رابط برنامهنویسی نرمافزار Gemini بر اساس دو سطح قیمتگذاری است: سطح رایگان و سطح پولی ( پرداخت در ازای استفاده یا پرداخت فقط برای آنچه استفاده میکنید ). سطح رایگان برای مدلهای خاصی در دسترس است که در صفحه قیمتگذاری مستند شدهاند. قیمتگذاری و محدودیتهای نرخ بین سطوح مختلف و بر اساس مدل متفاوت است.
گوگل هوش مصنوعی استودیو همچنین برای برخی مدلها، جدا از سطح رایگان API، تا سقف مشخصی استفاده رایگان ارائه میدهد. برای دسترسی به مدلها و ویژگیهای پولی در AI Studio، میتوانید یک کلید API پولی را متصل کنید. میتوانید برای بازگشت به سهمیه رایگان AIS، کلید API را لغو اتصال کنید.
چرا از ردیف پولی استفاده کنیم؟
ارتقا به سطح پولی به شما امکان میدهد به محدودیتهای نرخ بالاتر دسترسی داشته باشید، از مدلهای پیشرفته استفاده کنید و اطمینان حاصل کنید که از پیامها و پاسخهای شما برای بهبود محصولات گوگل (حریم خصوصی دادههای سازمانی) استفاده نمیشود . برای اطلاعات بیشتر در مورد استفاده از دادهها برای سرویسهای پولی، به شرایط خدمات مراجعه کنید.
برای دسترسی به ردیف پرداختشده، صورتحساب تنظیم کنید
شما میتوانید یک پروژه ایجاد کنید و صورتحساب را تنظیم کنید، یا یک پروژه موجود را برای ارتقاء به سطح پولی مستقیماً در Google AI Studio و بدون نیاز به رفتن به کنسول Google Cloud وارد کنید. شما بدون هیچ هزینه اولیهای، فوراً به وضعیت قابل پرداخت دست خواهید یافت و بعداً فقط برای منابع خاصی که در طول چرخه صورتحساب مصرف میکنید، پرداخت خواهید کرد (برای اطلاعات بیشتر، تنظیمات صورتحساب خودکار Cloud را بخوانید).
- به صفحه کلیدهای API استودیو AI (یا هر جایی که «تنظیم صورتحساب» را در استودیو AI میبینید) بروید.
- کاربران جدید به طور پیشفرض یک پروژه و کلید API برای آنها ایجاد میشود.
- اگر به یک کلید جدید نیاز دارید، روی «ایجاد کلید API» کلیک کنید و کادر محاورهای را دنبال کنید تا یک جفت کلید-پروژه به جدول اضافه شود.
- پروژهای را که میخواهید به سطح پرداختشده ارتقا دهید، پیدا کنید و در ستون سطح سهمیه، روی تنظیم صورتحساب کلیک کنید.
- اگر پروژهای از قبل در سطح پولی باشد، ممکن است گزینه ارتقا (Upgrade) را ببینید.
- تنظیمات برای کاربران جدید و فعلی Cloud Billing متفاوت است:
کاربران جدید
این گردش کار برای کاربرانی است که حساب پرداخت گوگل ندارند.
- مراحل انتخاب پروژه و کلید API خود را برای راهاندازی دنبال کنید .
- کشور خود را برای موافقت با شرایط خدمات در پنجره «تنظیم حساب پرداخت Google Cloud» انتخاب کنید.
- اگر از قبل پروفایل پرداختی به حساب خود متصل دارید، اطلاعات تماس و روش پرداخت خود را در پنجره «افزودن جزئیات حساب صورتحساب» مشاهده خواهید کرد. برای ویرایش هر یک از فیلدها، روی «تغییر» کلیک کنید.
- اگر نمایه پرداخت ندارید، روی دکمه + برای اطلاعات تماس و روش پرداخت کلیک کنید و دستورالعملها را برای پر کردن جزئیات خود در پنجرههای مربوطه دنبال کنید.
- روی «پایان تنظیم حساب» کلیک کنید.
- پنجره بعدی وضعیت صورتحساب شما را به شما اطلاع میدهد.
کاربران موجود
این گردش کار برای کاربرانی است که قبلاً صورتحساب گوگل را با حساب خود تنظیم کردهاند.
- مراحل انتخاب پروژه و کلید API خود را برای راهاندازی دنبال کنید .
- در پنجره «تنظیم حساب ابری خود» چندین گزینه خواهید داشت:
- اگر چندین حساب صورتحساب دارید، روی منوی «انتخاب حساب صورتحساب» کلیک کنید تا حسابی را که میخواهید به پروژه انتخابی خود پیوند دهید، انتخاب کنید.
- اگر فقط یک حساب صورتحساب داشته باشید، آن حساب به طور خودکار در منو انتخاب میشود.
- اگر نمیخواهید از هیچ یک از حسابهای موجود خود استفاده کنید، روی «افزودن حساب صورتحساب جدید» در زیر منو کلیک کنید. این کار مرحله ۳ را در بخش «کاربران جدید صورتحساب ابری» آغاز میکند.
- روی پایان راهاندازی کلیک کنید.
- پنجره بعدی وضعیت صورتحساب شما را به شما اطلاع میدهد.
به سطح پولی بعدی ارتقا دهید
اگر از قبل در سطح پولی هستید و معیارهای تغییر طرح را دارید، به صفحه کلیدهای API استودیو AI بروید و در ستون سطح سهمیه از ردیف پروژه کلیدی که در آن موجود است، گزینه ارتقا را انتخاب کنید.
سیستم به طور خودکار واجد شرایط بودن پروژه شما را تأیید میکند. اگر پروژه شما تمام شرایط را داشته باشد، فوراً به سطح بعدی ارتقا مییابد.
تأیید وضعیت صورتحساب
پس از تنظیم صورتحساب برای سطح پولی ، بلافاصله از موفقیتآمیز بودن راهاندازی مطلع خواهید شد. همچنین میتوانید در صفحه کلیدهای API تأیید کنید که پروژه Google Cloud شما به حساب Google Cloud Billing متصل شده و آماده استفاده پولی است. وضعیت صورتحساب کلید شما در ستون سطح سهمیه ممکن است موارد زیر را نشان دهد:
- سطح ۱، ۲ یا ۳ : تأیید میکند که پروژه شما مرتبط و بلافاصله قابل پرداخت است.
- اقدام مورد نیاز : شما باید یک پیشپرداخت یکباره که مربوط به میزان استفاده از حساب شما باشد، ارائه دهید.
تأیید پیشپرداخت یکباره
گوگل ممکن است برای فعال کردن سطح پولی رابط برنامهنویسی کاربردی Gemini، پیشپرداخت یکباره را الزامی کند. این اقدام به حفظ امنیت و در دسترس بودن پلتفرم ما برای همه کاربران کمک میکند. این یک هزینه نیست؛ بلکه اعتباری است که مستقیماً برای استفادههای بعدی به حساب شما اعمال میشود.
فرآیند پیش پرداخت
- تنظیم صورتحساب : وقتی API Gemini را در پروژهای که به یک حساب صورتحساب واجد شرایط متصل است فعال میکنید، در صورت نیاز به پیشپرداخت به شما اطلاع خواهیم داد.
- مطلع شوید : پس از تنظیم حساب صورتحساب، در AI Studio پنجرهای خواهید دید و ایمیلی دریافت خواهید کرد که شما را از این الزام مطلع میکند.
- پرداخت را انجام دهید : در صفحه کلیدهای API، برای کلید جدید لینک شده خود، روی اقدام مورد نیاز در زیر Quota tier کلیک کنید.
- ارتقا پیدا کنید : پس از پردازش موفقیتآمیز پرداخت شما (که برای اکثر روشهای پرداخت فوری است)، پروژه شما به سطح پرداختشده ارتقا مییابد و محدودیتهای نرخ جدید شما اعمال خواهد شد.
پرداخت ابری
رابط برنامهنویسی نرمافزار Gemini از Cloud Billing برای خدمات صدور صورتحساب استفاده میکند که میتوانید آن را مستقیماً در AI Studio تنظیم کنید . پس از فعال کردن Cloud Billing، میتوانید از ابزارهای Cloud Billing برای پیگیری هزینهها، درک هزینهها، انجام پرداختها و دسترسی به پشتیبانی Cloud Billing استفاده کنید.
کاربران جدید بلافاصله با یک حساب پرداخت شده Google Cloud Billing راهاندازی میشوند و 300 دلار اعتبار خوشامدگویی دریافت میکنند.
کاربران فعلی که از قبل یک حساب کاربری پولی یا آزمایشی رایگان Google Cloud Billing دارند، میتوانند بدون نیاز به مراجعه به کنسول Google Cloud، یک حساب کاربری Google Cloud Billing موجود را در AI Studio انتخاب کنند. به کاربران فعلی، اعتبار خوشامدگویی ۳۰۰ دلاری اعطا نمیشود.
درباره تنظیمات صورتحساب خودکار ابری بیشتر بخوانید .
نظارت بر میزان استفاده
پس از فعال کردن پرداخت ابری، میتوانید میزان استفاده از API Gemini را در Google AI Studio در داشبورد > میزان استفاده و محدودیتها رصد کنید.
سوالات متداول
این بخش پاسخ به سوالات متداول را ارائه میدهد.
برای چه چیزی از من صورتحساب گرفته شده است؟
قیمتگذاری API جمینی بر اساس موارد زیر است:
- تعداد توکنهای ورودی
- تعداد توکنهای خروجی
- تعداد توکنهای ذخیرهشده
- مدت زمان ذخیره توکن ذخیره شده
برای اطلاعات قیمت، به صفحه قیمتگذاری مراجعه کنید.
سهمیهام را از کجا میتوانم ببینم؟
میتوانید سهمیه و محدودیتهای سیستم خود را در AI Studio یا کنسول Google Cloud مشاهده کنید.
چطور میتوانم سهمیه بیشتری درخواست کنم؟
برای درخواست سهمیه بیشتر، دستورالعملهای زیر «ارتقا به سطح پولی بعدی» را دنبال کنید.
آیا میتوانم از رابط برنامهنویسی کاربردی Gemini به صورت رایگان در منطقه اقتصادی اروپا (شامل اتحادیه اروپا)، بریتانیا و جمهوری خلق چین استفاده کنم؟
بله، ما نسخه رایگان و پولی را در بسیاری از مناطق در دسترس قرار میدهیم.
اگر صورتحساب را با رابط برنامهنویسی نرمافزار Gemini تنظیم کنم، آیا هزینهای بابت استفاده از Google AI Studio از من دریافت میشود؟
استفاده از AI Studio رایگان باقی میماند، مگر اینکه کاربران برای دسترسی به ویژگیهای پولی، یک کلید API پولی را لینک کنند. به محض اینکه یک کلید API پولی را به عنوان بخشی از یک پروژه پولی در AI Studio لینک کنید، هزینه استفاده از AI Studio برای آن کلید از شما دریافت میشود. در صورت نیاز میتوانید در AI Studio بین پروژههای پولی و رایگان جابهجا شوید.
آیا میتوانم از ۱ میلیون توکن در سطح رایگان استفاده کنم؟
سطح رایگان برای API Gemini بسته به مدل انتخاب شده متفاوت است. در حال حاضر، میتوانید پنجره زمینه توکن ۱M را به روشهای زیر امتحان کنید:
- در استودیوی هوش مصنوعی گوگل
- با طرحهای پرداخت در محل
- با طرحهای رایگان برای مدلهای منتخب
چطور میتوانم تعداد توکنهایی که استفاده میکنم را محاسبه کنم؟
از متد GenerativeModel.count_tokens برای شمارش تعداد توکنها استفاده کنید. برای کسب اطلاعات بیشتر در مورد توکنها، به راهنمای توکنها مراجعه کنید.
آیا میتوانم از اعتبار گوگل کلود خود با رابط برنامهنویسی Gemini استفاده کنم؟
بله، اعتبارهای Google Cloud میتوانند برای استفاده از API Gemini استفاده شوند.
نحوه رسیدگی به صورتحساب چگونه است؟
صدور صورتحساب برای رابط برنامهنویسی نرمافزار Gemini توسط سیستم صورتحساب ابری (Cloud Billing ) انجام میشود. برای کسب اطلاعات بیشتر در مورد تنظیمات صورتحساب خودکار، به مستندات صورتحساب ابری مراجعه کنید.
آیا برای درخواستهای ناموفق هزینهای از من دریافت میشود؟
اگر درخواست شما با خطای ۴۰۰ یا ۵۰۰ ناموفق باشد، هزینه توکنهای استفاده شده از شما کسر نخواهد شد. با این حال، درخواست همچنان جزو سهمیه شما محسوب میشود.
آیا برای تنظیم دقیق مدلها هزینهای دریافت میشود؟
تنظیم مدل دیگر در API یا AIS جمینی پشتیبانی نمیشود.
آیا GetTokens هزینه دارد؟
درخواستهای ارسالی به API GetTokens هزینهای دریافت نمیکنند و جزو سهمیه استنتاج محسوب نمیشوند.
اگر حساب API پولی داشته باشم، دادههای Google AI Studio من چگونه مدیریت میشوند؟
برای جزئیات بیشتر در مورد نحوه مدیریت دادهها هنگام فعال بودن پرداخت ابری، به شرایط خدمات مراجعه کنید (به بخش «نحوه استفاده گوگل از دادههای شما» در بخش «خدمات پولی» مراجعه کنید). توجه داشته باشید که درخواستهای Google AI Studio شما تحت همان شرایط «خدمات پولی» رفتار میشوند، مادامی که حداقل یک پروژه API پرداخت را فعال کرده باشد، که میتوانید در صورت مشاهده پروژههایی که در بخش «طرح» با عنوان «پرداخت شده» علامتگذاری شدهاند، آن را در صفحه کلید API Gemini تأیید کنید.
تکلیف پیشپرداخت من چه میشود؟
کل مبلغ به عنوان اعتبار به حساب Cloud Billing شما اضافه میشود. این اعتبار به طور خودکار برای پرداخت هرگونه استفادهای که از Google Cloud، از جمله Gemini API یا سایر خدمات مانند Compute Engine و Cloud Storage، انجام میدهید، استفاده خواهد شد. این اعتبار تاثیری بر اعتبارهای دوره آزمایشی رایگان شما نخواهد داشت.
اگر پیشپرداخت نکنم چه میشود؟
مشکلی نیست. پروژه شما در سطح رایگان Gemini API باقی خواهد ماند. شما هیچ دسترسی را از دست نخواهید داد، اما مشمول محدودیتهای نرخ سطح رایگان خواهید بود. میتوانید در هر زمانی در آینده، پیشپرداخت را برای ارتقا تکمیل کنید.
آیا میتوانم مبلغ پیشپرداخت خود را پس بگیرم؟
بله. اگر در حساب خود موجودی دارید، میتوانید از طریق Cloud Console درخواست بازپرداخت وجه دهید، البته طبق سیاستهای استاندارد بازپرداخت ما.
آیا پیشپرداخت روی اعتبار آزمایشی رایگان ۳۰۰ دلاری من تأثیر میگذارد؟
خیر. این جدا از اعتبار دوره آزمایشی رایگان شماست. شما همچنان میتوانید از اعتبار دوره آزمایشی رایگان خود برای محصولات واجد شرایط استفاده کنید.
اگر بیشتر از مبلغ پیشپرداخت خرج کنم، چه اتفاقی میافتد؟
به محض اینکه موجودی اعتبار پیشپرداخت شما تمام شود، حساب شما به حالت صورتحساب استاندارد منتقل میشود. هرگونه استفاده اضافی از روش پرداخت اصلی مرتبط با حساب صورتحساب ابری شما کسر خواهد شد.
از کجا میتوانم در مورد صورتحساب کمک بگیرم؟
برای دریافت کمک در مورد صورتحساب، به پشتیبانی «دریافت صورتحساب ابری» مراجعه کنید.