قیمتگذاری و اعتبار API
نحوهٔ کسر اعتبار از پلن و pay-as-you-go، سهمیهها و روش بررسی مصرف.
منطق صورتحساب
اعتبار از کجا کسر میشود؟
هزینه بر اساس مدل و بهازای هر درخواست موفق محاسبه میشود.
- ۱
سهمیهٔ ماهانهٔ پلن
اگر سهمیهٔ Pro، Max یا Business کافی باشد، هزینه ابتدا از آن رزرو میشود.
- ۲
موجودی pay-as-you-go
اگر سهمیه کافی نباشد، سیستم موجودی مستقل API را بررسی میکند.
- ۳
بازپرداخت خطای upstream
اگر سرویس مدل با خطای upstream مواجه شود، اعتبار رزروشده برگردانده میشود.
سهمیهها
پلنها و Rate limit
| پلن | دسترسی API | اعتبار ماهانه | درخواست در دقیقه |
|---|---|---|---|
| Free | خیر* | ۰ | — |
| Starter | خیر* | ۰ | — |
| Pro | بله | ۱٬۰۰۰ | ۲۴۰ |
| Max | بله | ۳٬۰۰۰ | ۶۰۰ |
| Business | بله | ۰ | ۱٬۰۰۰ |
* حساب بدون پلن API نیز با موجودی مثبت pay-as-you-go دسترسی دارد و rate limit سطح Pro برای آن اعمال میشود.
Pay as you go
شارژ و محاسبهٔ هزینه
کنترل هزینه
مصرف را از API بخوانید
قبل یا بعد از عملیات پرهزینه میتوانید سهمیه و موجودی را کنترل کنید.
GET /usageJSON
{
"object": "usage",
"plan": "pro",
"period": "2026-08",
"api_credits": {
"used": 128,
"limit": 1000,
"remaining": 872
},
"pay_as_you_go": { "balance": 2400 },
"rate_limit": {
"limit_per_minute": 240,
"remaining": 238,
"resets_at": "2026-08-13T18:32:00.000Z"
},
"key": { "id": "...", "name": "Production" }
}