ایران ناتیفیکیشن

موجودی اعتبار هوش مصنوعی

اعتبار قابل‌مصرف، اعتبار رزروشده و تخفیف شما.

GEThttps://api.irnoti.com/v1/ai/balance
scope: ai.read

balance اعتبار آزاد، held اعتبار رزروشدهٔ درخواست‌های در جریان، discountPercent تخفیف گروه شما و walletFallback نشان می‌دهد وقتی اعتبار تمام شود از کیف پول (ریال) کسر شود یا نه. مقادیر عددی به‌صورت رشته برمی‌گردند.

خطاهای خاص این endpoint

401unauthorizedکلید API نامعتبر یا بدون دامنهٔ لازم.

اجرای زنده (محیط تست)

باز کردن در کنسول کامل ←

این endpoint در محیط تست پشتیبانی نمی‌شود؛ برای اجرا، کلید واقعی را در حالت «اجرای واقعی» وارد کنید.

curl -X GET 'https://api.irnoti.com/v1/ai/balance' \
  -H "Authorization: Bearer $IRNOTI_KEY"
پاسخ نمونه200 OK
{
  "held": "0",
  "balance": "120000",
  "walletFallback": true,
  "discountPercent": 10
}
موجودی اعتبار هوش مصنوعی — مستندات API | ایران ناتیفیکیشن