مستنداتقیمت‌گذاری
مدیریت API
مستندات API / قیمت‌گذاری

قیمت‌گذاری و اعتبار API

نحوهٔ کسر اعتبار از پلن و pay-as-you-go، سهمیه‌ها و روش بررسی مصرف.

منطق صورتحساب

اعتبار از کجا کسر می‌شود؟

هزینه بر اساس مدل و به‌ازای هر درخواست موفق محاسبه می‌شود.
  1. ۱

    سهمیهٔ ماهانهٔ پلن

    اگر سهمیهٔ Pro، Max یا Business کافی باشد، هزینه ابتدا از آن رزرو می‌شود.

  2. ۲

    موجودی pay-as-you-go

    اگر سهمیه کافی نباشد، سیستم موجودی مستقل API را بررسی می‌کند.

  3. ۳

    بازپرداخت خطای 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" }
}