راهنماها
مدل‌ها و قیمت‌گذاری
شناسه‌های مدل، ارائه‌دهندگان، نرخ‌های منتشرشده، تخفیف‌ها، واحدهای صورت‌حساب و نحوه قیمت‌گذاری یک درخواست را بفهمید.
قیمت مدل‌ها به دلار آمریکا منتشر می‌شود. یک مدل می‌تواند از بیش از یک ارائه‌دهنده بالادستی در دسترس باشد و هر ارائه‌دهنده می‌تواند قیمت مشتری متفاوتی منتشر کند. این راهنما توضیح می‌دهد این قیمت‌ها از کجا می‌آیند و چگونه هزینه یک درخواست را پیش از ارسال محاسبه کنید.
یافتن شناسه مدل
از شناسه مدلی که API برمی‌گرداند استفاده کنید. شناسه را از نام نمایشی یا slug صفحه نسازید.
| Endpoint | بازمی‌گرداند |
|---|---|
GET /api/v1/models | هر دسته مدل فعال |
GET /api/v1/videos/models | مدل‌های تولید ویدیو |
GET /api/v1/decisions/models | مدل‌های تصمیم‌گیری |
GET /api/v1/models همچنین exclude_video_and_decisions=true و یک فیلتر اختیاری provider را می‌پذیرد. کشف، کاتالوگ را می‌خواند و برای فراخوانی مدل هزینه‌ای نمی‌گیرد.
مدل‌های تصویری endpoint فهرست اختصاصی ندارند. GET /api/v1/models را بر اساس model_kind: "image_generation" فیلتر کنید؛ تولید تصویر را ببینید.
برای نمای قابل مرور، کاتالوگ مدل یا صفحه قیمت‌گذاری را باز کنید. صفحه‌های جزئیات مدل محدودیت‌های زمینه، پروتکل‌ها و هر قیمت منتشرشده تأمین‌کننده را نشان می‌دهند.
ارائه‌دهندگان و کانال‌ها
هر مدل فهرستی از کانال‌های عمومی دارد. یک کانال، یک پیکربندی ارائه‌دهنده بالادستی برای آن مدل است، مانند Anthropic، Azure، Google یا یک کانال Claude با تخفیف.
is_defaultکانالی را نشان می‌دهد که برای قیمت سرفصل و مسیر پیش‌فرض به کار می‌رود.runnableنشان می‌دهد کانال در حال حاضر برای درخواست‌ها در دسترس است یا نه.standard_pricingنرخ‌های استاندارد ارائه‌دهنده را در بر دارد.discount_multiplierضریب فروش از 0 تا 1 است.pricing_modeیاconfigured_ratesاست یاupstream_cost.
صفحه مدل تأمین‌کنندگان را با پیش‌فرض در ابتدا، سپس بر اساس قیمت ورودی مشتری از کم به زیاد مرتب می‌کند. برای انتخاب صریح یک تأمین‌کننده، کانال‌ها و مسیریابی ارائه‌دهنده را ببینید.
قیمت مشتری چگونه محاسبه می‌شود
برای کانال configured_rates:
customer price = standard rate × discount multiplierبرای نمونه، کانالی با نرخ ورودی استاندارد $1.00 برای هر 1M توکن و ضریب 0.8، برای هر 1M توکن $0.80 می‌گیرد.
برای کانال upstream_cost، مقدار standard_pricing برابر null است، نه صفر. صورت‌حساب بر پایه هزینه تولید گزارش‌شده ضرب‌در تخفیف منجمد محاسبه می‌شود. صفحه مدل قاعده واقعی آن کانال را نشان می‌دهد.
نرخ‌های توکن برای خوانایی بر حسب هر 1 میلیون توکن نمایش داده می‌شوند. صورت‌حساب از دقت هر توکن در تصویر قیمت جاری استفاده می‌کند.
واحدهای صورت‌حساب
| واحد | کاربرد معمول | چگونه اندازه‌گیری می‌شود |
|---|---|---|
| توکن‌ها | چت، استدلال، embeddingها، تولید متن | توکن‌های ورودی و خروجی جداگانه؛ خواندن و نوشتن کش می‌تواند نرخ خودش را داشته باشد |
| توکن‌های تصویر | تولید و ویرایش تصویر | توکن‌های تصویر ورودی و خروجی جداگانه؛ شمار توکن خروجی هر تصویر به تفکیک‌پذیری بستگی دارد |
| درخواست‌ها | برخی endpointهای تصویر و ابزاری | هزینه ثابت برای هر فراخوانی |
| ثانیه یا پله‌ها | تولید ویدیو | مدت، تفکیک‌پذیری، ورودی‌های مرجع یا شرط منتشرشده دیگر |
اگر چند شرط قیمت مطابقت داشته باشد، نخستین شرط منطبق که در جزئیات قیمت‌گذاری مدل فهرست شده اعمال می‌شود. پیش از برآورد یک وظیفه بزرگ، پله‌ها را در صفحه جزئیات مدل بررسی کنید.
نرخ‌های کش
وقتی مدلی input_cache_read یا input_cache_write را منتشر می‌کند، آن نرخ‌ها در کاتالوگ و صفحه مدل ظاهر می‌شوند. استفاده از کش توسط پاسخ پروتکل گزارش می‌شود؛ برخورد با کش تضمین‌شده نیست و به ارائه‌دهنده بالادستی و درخواست بستگی دارد. Felo کلید جداگانه‌ای برای کش اضافه نمی‌کند.
کجا قیمت‌ها را بررسی کنید
- صفحه قیمت‌گذاری — مدل‌ها و تأمین‌کنندگان را مقایسه کنید.
- صفحه جزئیات مدل — جدول کامل نرخ‌ها، پله‌ها و شرایط.
- API کاتالوگ مدل — همان داده به‌صورت JSON، به‌روزشده در 60 ثانیه.
قیمت‌ها را در برنامه خود سخت‌کد نکنید. کاتالوگ را بخوانید یا پیوندی به صفحه قیمت‌گذاری نشان دهید تا تغییر قیمت، برآورد هزینه شما را بی‌صدا نشکند.
برآورد یک درخواست
- شناسه مدل و کانالی را که می‌خواهید به کار ببرید پیدا کنید.
- نرخ‌های ورودی، خروجی و کش آن کانال را بخوانید.
- در شمار توکن مورد انتظار خود ضرب کنید، یا برای مدل‌های غیرتوکنی از نرخ درخواست یا مدت استفاده کنید.
- هر پله شرطی که اعمال می‌شود را اضافه کنید.
- برای تلاش‌های دوباره و نوسان خروجی حاشیه بگذارید.