همه صفحه‌ها

صورتحساب و اعتبار

هرمز با مدل «بلوکه و تسویه» کار می‌کند: پیش از رسیدن درخواست به مدل، برآورد هزینه از اعتبار حساب بلوکه می‌شود؛ پس از پایان، هزینهٔ واقعی محاسبه و مابه‌التفاوت آزاد می‌گردد. اگر اعتبار کافی نباشد، درخواست همان ابتدا با 402 INSUFFICIENT_CREDITS رد می‌شود و هیچ هزینه‌ای ثبت نمی‌شود.

تکرار امن با Idempotency-Key

برای درخواست‌های POST هدر Idempotency-Key بفرستید (هر رشته تا ۲۰۰ کاراکتر). کلید تکراری با همان بدنه، پاسخ کش‌شده را برمی‌گرداند. بدون اجرای دوباره و بدون هزینهٔ مجدد. کلید تکراری با بدنهٔ متفاوت 409 CONFLICT می‌گیرد. کلیدها بعد از ۲۴ ساعت منقضی می‌شوند.

هزینهٔ هر درخواست را کجا ببینم؟

امبدینگ‌ها هزینه را همان لحظه در usage.cost برمی‌گردانند؛ در چتِ استریم، آخرین chunk پیش از [DONE] هزینهٔ قطعی را دارد. تاریخچهٔ کامل مصرف و صورتحساب در داشبورد هرمز در دسترس است.

به‌روزرسانی: 2026-10-13