مدیریت هزینه

platform_price_irr   = usd_cost × exchange_rate × platform_markup
customer_billed_irr  = platform_price_irr × (1 + partner_margin / 100)
wallet_debited_irr   = max(customer_billed_irr, minimum_request_charge_irr)

• usd_cost: هزینۀ دلاری بر اساس توکن ورودی/خروجی و نرخ مدل.
• exchange_rate: نرخ دلار به ریال در لحظۀ ثبت مصرف.
• platform_markup: ضریب پلتفرم درواره.
• partner_margin: حاشیۀ سود همکار/نماینده (در صورت وجود).

نرخ ارز در لحظۀ ثبت مصرف ذخیره می‌شود. تغییر نرخ توسط مدیر پلتفرم فقط روی مصرف‌های آینده اثر می‌گذارد و سوابق قبلی تغییر نمی‌کند.

درخواست‌هایی که با خطای ۴۰۱، ۴۰۳، ۴۲۹ یا خطای ارائه‌دهنده رد شوند، هیچ هزینه‌ای از کیف پول کسر نمی‌کنند. فقط درخواست‌های موفقی که توکن مصرف کرده‌اند محاسبه می‌شوند.

{
  "usage": {
    "prompt_tokens": 132,
    "completion_tokens": 480,
    "total_tokens": 612,
    "cost_irr": 21500
  }
}

فیلد cost_irr افزودۀ درواره است و برابر مقدار کسرشده از کیف پول به ریال است.

مصرف تفکیکی به‌ازای کلید، مدل و روز در داشبورد /developers/usage و /billing در دسترس است. فایل CSV نیز قابل خروجی گرفتن است.

برای درخواست‌های خیلی کوچک، ممکن است حداقل هزینه‌ای (مثلاً چند ریال) لحاظ شود تا هزینۀ زیرساخت پوشش داده شود. مقدار دقیق در تنظیمات پلتفرم قابل مشاهده است.