قیمت‌گذاری و صورتحساب

نحوه‌ی محاسبه‌ی هزینه‌ی هر درخواست به تومان در هوشوانا، کیف پول، روش‌های شارژ ریالی و کارت‌به‌کارت، کد تخفیف، فاکتور، اعتبار هدیه و برآورد هزینه‌ی ماهانه.

آخرین به‌روزرسانی: ۲۲ مهر ۱۴۰۵

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

فرمول قیمت

هر مدل یک قیمت پایه به دلار دارد که ارائه‌دهنده‌ی آن اعلام کرده است:

مدل‌های متنی: به ازای هر یک میلیون توکن ورودی، خروجی و ورودی کش‌شده
مدل‌های تصویر: به ازای هر تصویر
تبدیل متن به گفتار: به ازای هر یک میلیون نویسه
تبدیل گفتار به متن: به ازای هر دقیقه

هزینه‌ی هر درخواست به ریال این‌طور محاسبه می‌شود:

cost_rial = ceil( usd_cost × dollar_rate_rial × markup )

usd_cost هزینه‌ی دلاری بر اساس مصرف واقعی (مثلاً توکن‌ها) است.
dollar_rate_rial نرخ دلار هوشواناست که همیشه به‌صورت عمومی در صفحه‌ی قیمت‌ها نمایش داده می‌شود.
markup ضریب مدل است که برای بیشتر مدل‌ها ۱ است. اگر برای مدلی ضریب دیگری اعمال شود، روی صفحه‌ی همان مدل در کاتالوگ نمایش داده می‌شود.

مبالغ در ریال ذخیره و در داشبورد به تومان (ریال تقسیم بر ۱۰) نمایش داده می‌شوند.

یک مثال عددی

توجه: اعداد این مثال فقط برای توضیح فرمول‌اند و قیمت یا نرخ واقعی نیستند. قیمت‌ها و نرخ روز را در صفحه‌ی قیمت‌ها ببینید.

فرض کنید:

قیمت مدل: ۰٫۱۵ دلار برای هر یک میلیون توکن ورودی و ۰٫۶۰ دلار برای هر یک میلیون توکن خروجی
نرخ دلار: ۲۹۵٬۰۰۰ تومان (یعنی ۲٬۹۵۰٬۰۰۰ ریال)
ضریب مدل: ۱
یک درخواست با ۲٬۰۰۰ توکن ورودی و ۵۰۰ توکن خروجی

محاسبه:

input  = 2,000 × 0.15 / 1,000,000 = 0.0003 USD
output =   500 × 0.60 / 1,000,000 = 0.0003 USD
usd_cost = 0.0006 USD

cost_rial = ceil(0.0006 × 2,950,000 × 1) = 1,770 rial
          = 177 toman

پس این درخواست ۱۷۷ تومان هزینه دارد. همین اعداد برای هر درخواست در لاگ درخواست‌ها نمایش داده می‌شود.

بررسی پیش و پس از درخواست

پیش از درخواست

قبل از ارسال درخواست به مدل، هوشوانا بررسی می‌کند موجودی کافی باشد. درخواست با خطای insufficient_balance (HTTP ۴۰۲) رد می‌شود اگر:

موجودی کیف پول کمتر از حداقل لازم باشد (به‌طور پیش‌فرض ۱٬۰۰۰ تومان)، یا
موجودی کمتر از بدترین حالت هزینه باشد، یعنی وقتی مدل به اندازه‌ی کامل max_tokens خروجی تولید کند.

برای همین، اگر موجودی‌تان کم است و max_tokens بزرگی گذاشته‌اید، کم کردن max_tokens می‌تواند درخواست را قابل اجرا کند.

پس از درخواست

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

کیف پول و دفتر تراکنش

در کیف پول موجودی فعلی و همه‌ی تراکنش‌ها را می‌بینید:

نوع تراکنش	توضیح
شارژ	افزایش موجودی با پرداخت
مصرف	کسر هزینه‌ی درخواست‌های API و پردازش پایگاه دانش
بازگشت وجه	برگشت مبلغ در موارد خاص
پاداش معرفی	سهم شما از شارژ کاربرانی که معرفی کرده‌اید
هدیه	اعتبار هدیه‌ی ثبت‌نام یا اعتبار ویژه
کد تخفیف	اعتبار اضافه‌شده با کد تخفیف

روش‌های شارژ

حداقل مبلغ هر شارژ ۵۰٬۰۰۰ تومان است.

درگاه پرداخت آنلاین

از طریق درگاه پارسیان یا زرین‌پال با هر کارت بانکی عضو شتاب پرداخت کنید. پس از پرداخت موفق، موجودی بلافاصله افزایش می‌یابد. اگر مبلغ از حسابتان کم شد ولی کیف پول شارژ نشد، بانک معمولاً طی ۷۲ ساعت مبلغ را برمی‌گرداند. در این صورت با تیکت و شماره‌ی پیگیری پرداخت با ما در تماس باشید.

کارت‌به‌کارت

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

این روش به بررسی دستی نیاز دارد و ممکن است کمی زمان ببرد. اگر شارژ فوری لازم دارید، از درگاه آنلاین استفاده کنید.

کد تخفیف

کد تخفیف را هنگام شارژ وارد کنید. کدها ممکن است مبلغ ثابت (مثلاً ۲۰٬۰۰۰ تومان) یا درصدی از مبلغ شارژ را به عنوان اعتبار اضافه به کیف پول شما بیفزایند. شرایط هر کد (حداقل مبلغ، تاریخ انقضا و تعداد دفعات استفاده) هنگام وارد کردن نمایش داده می‌شود.

فاکتور و رسید

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

اعتبار هدیه‌ی ثبت‌نام

هر حساب جدید ۲۰٬۰۰۰ تومان اعتبار هدیه می‌گیرد تا بتوانید بدون پرداخت، API و مدل‌های مختلف را امتحان کنید.

برنامه‌ی معرفی

با پیوند معرفی اختصاصی خود دوستانتان را دعوت کنید:

شما: ۱۰ درصد از مبلغ شارژهای پرداختی هر کاربر معرفی‌شده را تا ۱۲ ماه به عنوان پاداش می‌گیرید.
کاربر معرفی‌شده: پس از اولین شارژ پرداختی، ۵۰٬۰۰۰ تومان اعتبار هدیه می‌گیرد.

برآورد هزینه‌ی ماهانه

برای برآورد، به سه عدد نیاز دارید: میانگین توکن ورودی و خروجی هر درخواست و تعداد درخواست‌ها.

چند درخواست واقعی بفرستید و میانگین prompt_tokens و completion_tokens را از usage یا لاگ‌ها بخوانید.
هزینه‌ی یک درخواست را با فرمول بالا حساب کنید.
در تعداد درخواست‌های ماهانه ضرب کنید.

ادامه‌ی مثال بالا: اگر سرویس شما روزانه ۱٬۰۰۰ درخواست مشابه داشته باشد:

1,000 requests/day × 30 days = 30,000 requests
30,000 × 177 toman = 5,310,000 toman per month

یک اسکریپت ساده برای برآورد:

Python

def monthly_cost_toman(in_tokens, out_tokens, in_price, out_price,
                       dollar_rate_toman, requests_per_day, days=30):
    usd = (in_tokens * in_price + out_tokens * out_price) / 1_000_000
    per_request = usd * dollar_rate_toman
    return per_request * requests_per_day * days

# Example numbers only. Check /pricing for real prices and today's rate.
print(round(monthly_cost_toman(2000, 500, 0.15, 0.60, 295_000, 1000)))

راه‌های کم کردن هزینه:

برای کارهای ساده از مدل‌های گروه «اقتصادی» استفاده کنید.
پیام system و تاریخچه‌ی گفتگو را کوتاه نگه دارید. تاریخچه‌ی طولانی در هر درخواست دوباره هزینه دارد.
در مدل‌هایی که کش ورودی دارند، بخش ثابت prompt را در ابتدا بگذارید تا از قیمت کمتر توکن کش‌شده استفاده شود.
max_tokens را متناسب با نیاز تعیین کنید.

سقف هزینه

برای جلوگیری از هزینه‌های غیرمنتظره، سقف هزینه‌ی روزانه و ماهانه را هم در سطح حساب و هم برای هر کلید تعیین کنید. پس از رسیدن به سقف، درخواست‌ها با spend_cap_reached رد می‌شوند. همچنین آستانه‌ی هشدار موجودی کم را فعال کنید تا قبل از تمام شدن اعتبار باخبر شوید. جزئیات در قوانین کلید.