صورتحساب و قیمتگذاری API
هزینهٔ هر تماس برابر است با قیمت رسمی دلاری سازندهٔ مدل، بهعلاوهٔ کارمزد ما (۱۵٪ برای مدلهای پرچمدار، ۳۰٪ برای مدلهای کوچک و ارزان، ۲۰٪ برای بقیه)، ضرب در نرخ روز دلار به تومان. این مبلغ از کیف پول پیشپرداخت تومانی کم میشود. روی هر شارژ ۱۰٪ مالیات بر ارزش افزوده اضافه میشود. درخواست ناموفق هزینهای ندارد و اعتباری که خودت شارژ میکنی منقضی نمیشود.
آخرین بهروزرسانی:
فهرست مستندات
مسیرهای API
حساب، کلید و تیم
صورتحساب و قیمت · ۱
فرمول
cost_toman = usage × vendor_list_price_usd × (1 + markup) × toman_per_usdusageبسته به مسیر توکن، ثانیه، نویسه یا تعداد تصویر است.vendor_list_price_usdقیمت رسمی و منتشرشدهٔ خود سازندهٔ مدل است. توکن ورودی، خروجی و کششده هر کدام نرخ خودشان را دارند.- مبلغ هر تماس به بالا گرد میشود و دستکم یک تومان است.
- قیمت تومانی هر مدل در صفحهٔ قیمتها و در فهرست مدلها است.
صورتحساب و قیمت · ۲
کارمزد بر اساس مدل
| دسته | کارمزد | کدام مدلها |
|---|---|---|
| پرچمدار | ۱۵٪ | Claude Opus، Fable و Mythos، GPT-5.5، GPT-6 Astra، مدلهای -pro، Gemini Pro، o1 و deep-research |
| کوچک و ارزان | ۳۰٪ | deepseek-v4-flash، gemini-2.5-flash، gemini-2.5-flash-lite، gpt-4o-mini، gpt-5-nano، gpt-5.6-luna، gpt-6-luna |
| بقیهٔ مدلها | ۲۰٪ | هر مدل دیگر، از جمله مدلهای تصویر، صدا، ویدیو و صوت زنده |
- تخفیف حجمی: حسابی که در ۳۰ روز گذشته بیش از ۵٬۰۰۰٬۰۰۰ تومان از کیف پول خرج کرده باشد، روی همهٔ مدلها حداکثر ۱۵٪ کارمزد میپردازد. بهصورت خودکار اعمال میشود.
- این دستهبندی از ۵ آبان ۱۴۰۵ برقرار است؛ پیش از آن کارمزد همهٔ مدلها ۲۰٪ بود.
- کارمزد به مسیر بستگی ندارد: یک مدل روی
/v1،/anthropicو/geminiیک قیمت دارد.
صورتحساب و قیمت · ۳
نرخ دلار
نرخ تبدیل دلار به تومان هر روز ساعت ۹ صبح به وقت تهران بهروز میشود، به بالا تا ۱۰۰ تومان گرد میشود و در یک روز بیش از ۱۵٪ جابهجا نمیشود. نرخ امروز و زمان اعمالش در صفحهٔ قیمتها نوشته شده است. هر تماس با نرخ همان لحظه حساب میشود و نرخی که به کار رفته در ردیف گزارش مصرف آن تماس میماند. موجودی کیف پول تومانی است و با تغییر نرخ کم و زیاد نمیشود.
صورتحساب و قیمت · ۴
شارژ کیف پول و مالیات
| چه چیزی | مقدار |
|---|---|
| روشهای پرداخت | درگاه زرینپال، درگاه دیجیپی و کارتبهکارت با ثبت رسید |
| کمترین مبلغ هر شارژ | ۱٬۰۰۰ تومان |
| بیشترین مبلغ هر شارژ | ۲۵٬۰۰۰٬۰۰۰ تومان |
| مالیات بر ارزش افزوده | ۱۰٪، روی مبلغ شارژ اضافه میشود |
| هدیهٔ کارتبهکارت | ۱۰٪ اعتبار بیشتر |
- مالیات روی مبلغ اضافه میشود: همان مبلغی که انتخاب میکنی به کیف پول میرسد و مالیات جدا از آن پرداخت میشود. صفحهٔ پرداخت پیش از رفتن به درگاه مبلغ پایه، مالیات و جمع را نشان میدهد.
- کف و سقف شارژ برای همهٔ روشها یکی است. برای مبلغ بالاتر از فرم تماس استفاده کن.
- پرداخت با درگاه بلافاصله به کیف پول مینشیند. کارتبهکارت پس از بررسی رسید تأیید میشود.
- شارژ از داشبورد، صفحهٔ شارژ، انجام میشود. راهی برای شارژ از API نیست.
صورتحساب و قیمت · ۵
رزرو مبلغ پیش از هر تماس
- پیش از فرستادن هر درخواست، بیشترین هزینهٔ ممکن آن (پرامپت بهعلاوهٔ سقف خروجی) از اعتبار رزرو میشود. پس از پاسخ، هزینهٔ واقعی کم میشود و باقی رزرو همان لحظه آزاد میشود.
- اگر
max_tokensبیشتر از چیزی باشد که اعتبار میرساند، درخواست رد نمیشود: دروازه سقف خروجی را تا اندازهٔ اعتبار پایین میآورد و تماس انجام میشود. در این حالت پاسخ ممکن است باfinish_reason: "length"تمام شود. - اگر سقف خروجی نفرستاده باشی و اعتبار کفاف سقف پیشفرض را ندهد، دروازه خودش سقفی تا ۴٬۰۹۶ توکن میگذارد.
- خطای
402با کدinsufficient_balanceفقط وقتی برمیگردد که اعتبار حتی کفاف پرامپت بهعلاوهٔ یک توکن خروجی را ندهد. /v1/responsesاستثناست: سقف خروجیاش بازنویسی نمیشود.- دستهٔ OpenAI (
POST /v1/batches) رزرو خودش را دارد: بیشترین هزینهٔ تخمینی کل فایل بهعلاوهٔ ۱۰٪، فقط از کیف پول، تا وقتی دسته تسویه شود (رزرو دسته).
صورتحساب و قیمت · ۶
درخواست ناموفق، قطعشده و نیمهتمام
| حالت | هزینه |
|---|---|
| پاسخ موفق | مصرفی که سازنده گزارش میدهد |
خطا از دروازه یا از سازندهٔ مدل (وضعیت 4xx یا 5xx) | ندارد؛ فقط ثبت میشود |
| خودت اتصال را وسط استریم میبندی | کامل؛ تولید در سمت سازنده تا آخر ادامه پیدا میکند |
| سازنده تا ۱۰ دقیقه پاسخی نمیدهد | ندارد |
| پاسخ نیمهکاره رسیده و بعد از سمت ما قطع شده | فقط بخش رسیده، و هرگز بیشتر از مبلغ رزروشده |
| ساخت تصویر یا ویدیو که قطع میشود یا شکست میخورد | ندارد؛ اگر کم شده باشد برمیگردد |
صورتحساب و قیمت · ۷
کش پرامپت و ابزارها
- توکنهای ورودی که از کش خوانده میشوند با نرخ ارزانتر کش همان مدل حساب میشوند. این برای کش خودکار OpenAI و Gemini و برای
cache_controlدر Anthropic برقرار است. - در Anthropic نوشتن کش نرخ خودش را دارد (جدا برای کش پنجدقیقهای و یکساعته)، همانطور که سازنده قیمت گذاشته است.
- جستوجوی وب بهازای هر جستوجو و با نرخ جستوجوی همان مدل حساب میشود، جدا از توکنها (ابزارهای سمت سرور).
صورتحساب و قیمت · ۸
پلن چت و اعتبار هدیه
- API پرداخت بهاندازهٔ مصرف است و به پلن نیاز ندارد. اگر پلن چت پولی داشته باشی، تماسهای API اول از اعتبار پلن پرداخت میشوند، تا ۴۰٪ اعتبار ماهانهٔ پلن، و بعد از کیف پول. حساب رایگان تماسهای API را فقط از کیف پول میپردازد. پلنها.
- حساب تازه یک بار گردونهٔ هدیه را میچرخاند: از ۱۰۰٬۰۰۰ تومان تا ۱٬۰۰۰٬۰۰۰ تومان اعتبار هدیه برای مدلهای سریع و ارزان، بهعلاوهٔ ۳۰٬۰۰۰ تومان برای هر مدلی. هر دو ۱۴ روز پس از چرخاندن اعتبار دارند و روی تماسهای API هم خرج میشوند.
- اعتبار هدیه پول نقد نیست: برداشت نمیشود، برگشت داده نمیشود و تاریخ انقضای ثابت دارد.
- پردازش دستهای OpenAI استثناست: هزینهٔ دسته فقط از کیف پول پرداخت میشود و اعتبار پلن و اعتبار هدیه آن را نمیپردازند.
صورتحساب و قیمت · ۹
برگشت وجه و انقضای اعتبار
- اعتباری که خودت شارژ میکنی تاریخ انقضا ندارد.
- موجودی استفادهنشده را میتوانی تا ۳۰ روز پس از آخرین شارژ، از فرم تماس، پس بگیری. کارمزد درگاهی که با آن پرداخت کردهای از مبلغ برگشتی کم میشود.
- متن کامل در شرایط استفاده است و همان متن مرجع است.
صورتحساب و قیمت · ۱۰
خواندن صورتحساب خودت
هر تماس یک ردیف در گزارش مصرف دارد با مدل، توکنها، توکنهای کششده، قیمت پایهٔ دلاری (base_cost_usd) و مبلغ تومانی کمشده (cost_toman). همین ردیفها را با همان کلید از API حساب هم میخوانی، یک بازهٔ کامل را بهصورت فایل CSV میگیری، و تراکنشهای کیف پول را از GET /v1/wallet/transactions. پاسخ غیراستریم هر تماس حسابشونده مبلغ همان تماس را در هدر X-1xai-Cost-Toman هم دارد (متادیتای پاسخ).