پرسش‌های متداول
صورت‌حساب و اعتبار
نحوه محاسبه اعتبار سرویس، زمان شارژ و معنای پاسخ 402.
مصرف API در Felo API Platform پیش‌پرداخت است. شما اعتبار سرویس به دلار آمریکا می‌خرید و هر درخواست با نرخ قابل اعمال از همان مانده کسر می‌شود.
صورت‌حساب چگونه کار می‌کند
- یک شارژ اعتبار سرویس می‌خرد، نه مانده نقدی نگه‌داشته‌شده توسط پلتفرم.
- اعتبار به دلار آمریکا است تا هزینه‌ها را بتوان به دلار بیان کرد.
- شارژ از $1 شروع می‌شود. اشتراک لازم نیست.
- اعتبار فقط برای پوشش هزینه‌های API پلتفرم به کار می‌رود. قابل برداشت یا تبدیل به نقد نیست.
- شارژهای تکمیل‌شده، از جمله اعتبار استفاده‌نشده، بازگشت‌ناپذیرند، مگر آنکه قانون الزامی قابل اعمال خلاف آن را بخواهد.
همین مانده اعتبار هزینه فراخوانی مدل، فراخوانی Data API و فراخوانی Felo API را می‌پردازد. برای هر تأمین‌کننده به حساب یا مانده جداگانه نیاز ندارید.
هزینه یک درخواست
هزینه به endpoint بستگی دارد:
| سطح | مبنای صورت‌حساب |
|---|---|
| Model API | نرخ‌های توکن برای ورودی، خروجی و کش، به‌علاوه هر ابزار قابل صورت‌حساب؛ ضریب تخفیف کانال اعمال می‌شود |
| Data API | مبنای صورت‌حساب منتشرشده برای آن endpoint، که ممکن است برای هر درخواست موفق، برای هر مورد برگشتی یا بر پایه مصرف واقعی باشد |
Felo APIها (/v2) | نرخ خروجی آن گردش‌کار |
قیمت مدل‌ها بر حسب هر 1M توکن در صفحه قیمت‌گذاری و صفحه هر مدل نشان داده می‌شود. برای فرمول و برآورد نمونه مدل‌ها و قیمت‌گذاری را ببینید.
بررسی مانده و شارژ
Console Billing را باز کنید. کنسول مانده اعتبار جاری، مبلغ‌های شارژ و سوابق مصرف را نشان می‌دهد. روش‌های پرداخت در دسترس به منطقه شما بستگی دارد و هنگام پرداخت نمایش داده می‌شود.
پاسخ 402
402 یعنی مانده هزینه فراخوانی را پوشش نمی‌دهد:
{
"status": 402,
"code": "INSUFFICIENT_CREDITS",
"message": "...",
"request_id": "..."
}چه کاری کنید:
- مانده را در Console Billing بررسی کنید.
- شارژ کنید.
- درخواست را دوباره بفرستید. 402 محدودیت نرخ نیست، پس انتظار آن را برطرف نمی‌کند.
برای وظیفه ناهمگام، 402 هنگام ارسال یعنی وظیفه هرگز ساخته نشد. پیش از ارسال دوباره، endpoint وضعیت وظیفه را بررسی کنید.
صورت‌حساب در برابر محدودیت نرخ
این‌ها محدودیت‌های متفاوتی هستند:
- اعتبار محدود می‌کند چقدر می‌توانید خرج کنید. تمام‌شدن آن 402 برمی‌گرداند.
- محدودیت نرخ محدود می‌کند با چه سرعتی می‌توانید فراخوانی کنید. عبور از آن 429 برمی‌گرداند.
برای سرآیندهای 429 و قواعد تلاش دوباره خطاها، محدودیت‌ها و تلاش دوباره را ببینید.
اشتراک‌ها و اعتبار
مصرف API همیشه از اعتبار سرویس پرداخت می‌شود. تنها رفتار اشتراکی که در این مستندات توصیف شده، معافیت محدودیت نرخ /v2/chat برای حساب‌های دارای اشتراک مؤثر پولی Felo است؛ این معافیت جای اعتبار سرویس را نمی‌گیرد.
پرسش‌های صورت‌حساب
برای هزینه مورد اعتراض یا شارژی که نرسیده، با این اطلاعات با پشتیبانی تماس بگیرید:
- ایمیل حساب
- زمان تقریبی هزینه
request_idاز هر خطای مرتبط- مبلغ شارژ و مرجع پرداخت
هرگز کلید API کامل خود را نفرستید.