خواندن فهرست ناشناس مدلها
فهرست ناشناس مدلها، schema_version=2. کانالها pricing_mode، standard_pricing و discount_multiplier را افشا میکنند. کانالهای upstream_cost از هزینه تصویر یا ویدیوی گزارششده ضربدر تخفیف ثابتشده استفاده میکنند؛ standard_pricing آنها null است، نه صفر. default_channel کد کانال پیشفرض را مشخص میکند. recommended_protocol یک توصیه کلاینت در سطح مدل است (responses/messages، برای مدلهای غیرچت null)، نه محدودیت پروتکل. هیچ پیکربندی پروتکل یا فراداده Playground برگردانده نمیشود. reasoning شیء JSON بالادست را حفظ میکند، یا در صورت عدم دسترسی null است.
- نوع: string فهرست مقادیرlocaleمقادیر
- en
- zh
- C N - zh
- T W - ja
- ko
- نوع: stringq
- نوع: stringid
- نوع: string فهرست مقادیرmodel
_kind مقادیر- chat
- image
_generation - video
_generation - decisions
- نوع: string فهرست مقادیرfmtمقادیر
- cards
- full
- نوع: stringIf
- None - Match
- نوع: object · ModelCatalogResponse200
مدلهای قابل مشاهده؛ شناسه ناشناخته دقیق آرایه خالی برمیگرداند.
- نوع: object · CatalogDatadataالزامی
- modelsنوع: array object[] · Modelsالزامی
- authorنوع: string · Authorتهیپذیرالزامی
- authorنوع: string · Author Display Nameتهیپذیر
_display _name الزامی - availableنوع: array string[] · Available Content Localesفهرست مقادیر
_content _locales الزامیمقادیر- en
- zh
- C N - zh
- T W - ja
- ko
- bestنوع: array string[] · Best For
_for الزامی - capabilitiesنوع: array string[] · Capabilitiesالزامی
- contentنوع: string · Content Localeفهرست مقادیرتهیپذیر
_locale الزامیمقادیر- en
- zh
- C N - zh
- T W - ja
- ko
- contextنوع: integer · Context Lengthتهیپذیر
_length الزامیInteger numbers.
- descriptionنوع: string · Descriptionتهیپذیرالزامی
- documentنوع: object · PublicDocumentتهیپذیرالزامی
فقط زبان انتخابشده؛ summary/description/best_for روی مدل میمانند
- extraنوع: object · Extraالزامی
- propertyنوع: anything
Name
- noticeنوع: object · CatalogNoticeتهیپذیرالزامی
- bodyنوع: string · Bodyالزامی
- linkنوع: string · Link Textتهیپذیر
_text الزامی - targetنوع: string · Target Slugتهیپذیر
_slug الزامی - titleنوع: string · Titleتهیپذیرالزامی
- updatedنوع: string · Updated At
_at الزامیزمان بهروزرسانی سند زبان انتخابشده
- iconنوع: string · Icon Urlتهیپذیر
_url الزامی - idنوع: string · Idالزامی
- inputنوع: array string[] · Input Modalities
_modalities الزامی - latencyنوع: string · Latency Classتهیپذیر
_class الزامی - maxنوع: integer · Max Completion Tokensتهیپذیر
_completion _tokens الزامیInteger numbers.
- modelنوع: string · Model Kindفهرست مقادیر
_kind الزامیمقادیر- chat
- image
_generation - video
_generation - decisions
- nameنوع: string · Nameالزامی
- outputنوع: array string[] · Output Modalities
_modalities الزامی - reasoningنوع: object · Reasoningتهیپذیرالزامی
شیء JSON استدلال بالادست؛ فیلدهای ناشناخته را حفظ میکند؛ در صورت عدم دسترسی null
- propertyنوع: anything
Name
- releasedنوع: string · Released Atتهیپذیر
_at الزامی - shortنوع: string · Short Name
_name الزامی - slugنوع: string · Slugالزامی
- sortنوع: integer · Sort Order
_order الزامیInteger numbers.
- summaryنوع: string · Summaryتهیپذیرالزامی
- supportedنوع: array string[] · Supported Parameters
_parameters الزامی - trialنوع: string · Trial Status
_status الزامی - updatedنوع: string · Updated Atتهیپذیر
_at الزامی - videoنوع: object · VideoSpecتهیپذیر
_spec الزامی- aspectنوع: array string[] | null · Aspect Ratiosتهیپذیر
_ratios - audioنوع: object · AudioSpecتهیپذیر
- inputنوع: boolean · Inputتهیپذیر
- outputنوع: boolean · Outputتهیپذیر
- outputنوع: boolean · Output Optionalتهیپذیر
_optional
- constraintsنوع: object · Constraintsتهیپذیر
JSON Schema فقطداده برای ترکیبهای معتبر درخواست
- propertyنوع: anything
Name
- durationنوع: object · DurationSpecتهیپذیر
_seconds - maxنوع: number · Maxبزرگتر از:0الزامی
- minنوع: number · Minحداقل:0الزامی
- stepنوع: number · Stepبزرگتر از:0الزامی
- exampleنوع: object · Example Requestتهیپذیر
_request - propertyنوع: anything
Name
- inputنوع: array string[] | null · Input Modesتهیپذیر
_modes - referenceنوع: object · Reference Limitsتهیپذیر
_limits - propertyتهیپذیر
Name - نوع: integer
Integer numbers.
- requestنوع: object · Request Defaultsتهیپذیر
_defaults - propertyنوع: anything
Name
- resolutionsنوع: array string[] | null · Resolutionsتهیپذیر
- channelsنوع: array object[] · Channels
- codeنوع: string · Codeالزامی
- discountنوع: string · Discount Multiplierتهیپذیر
_multiplier الزامیضریب فروش دقیق از 0 تا 1؛ یکبار روی نرخهای پیکربندیشده یا هزینه بالادست اعمال شود
- isنوع: boolean · Is Default
_default الزامی - nameنوع: string · Nameالزامی
- regionنوع: string · Regionتهیپذیرالزامی
- runnableنوع: boolean · Runnableالزامی
- serviceنوع: string · Service Tier
_tier الزامی - standardنوع: object · CatalogPricingتهیپذیر
_pricing الزامینرخهای واحد استاندارد پیش از تخفیف فروش؛ برای کانالهای upstream_cost مقدار null
- basisمقدار ثابت:standardالزامی
- billingنوع: string · Billing Kind
_kind الزامی - channelنوع: string · Channelالزامی
- currencyمقدار ثابت:USDالزامی
- tiersنوع: array object[] · Tiersالزامی
ترتیب را حفظ کنید؛ اولین سطح منطبق نرخهای پایه را بازنویسی میکند
- conditionsنوع: array object[] · Conditionsالزامی
- fieldنوع: string · Fieldالزامی
بافت قیمتگذاری Felo، مثلاً input_context_tokens
- operatorنوع: string · Operatorفهرست مقادیرالزامیمقادیر
- eq
- gt
- gte
- valueالزامی
- نوع: string · Value
- overridesنوع: object · Overridesالزامی
- propertyنوع: string
Name
- audioنوع: string · Audioتهیپذیر
دلار آمریکا به ازای هر توکن صدای ورودی
- completionنوع: string · Completionتهیپذیر
دلار آمریکا به ازای هر توکن خروجی
- inputنوع: string · Input Audio Cacheتهیپذیر
_audio _cache دلار آمریکا به ازای هر توکن صدای کششده
- inputنوع: string · Input Cache Readتهیپذیر
_cache _read دلار آمریکا به ازای هر توکن ورودی کششده
- inputنوع: string · Input Cache Writeتهیپذیر
_cache _write دلار آمریکا به ازای هر توکن نوشتن کش
- inputنوع: string · Input Cache Write 1Hتهیپذیر
_cache _write _1h دلار آمریکا به ازای هر توکن نوشتن کش 1 ساعته؛ جدا از نوشتنهای TTL پیشفرض
- inputنوع: string · Input Imageتهیپذیر
_image دلار آمریکا به ازای هر تصویر ورودی
- inputنوع: string · Input Image Tokenتهیپذیر
_image _token دلار آمریکا به ازای هر توکن تصویر ورودی
- inputنوع: string · Input Video Secondتهیپذیر
_video _second دلار آمریکا به ازای هر ثانیه ویدیوی ورودی
- internalنوع: string · Internal Reasoningتهیپذیر
_reasoning دلار آمریکا به ازای هر توکن استدلال
- outputنوع: string · Output Imageتهیپذیر
_image دلار آمریکا به ازای هر تصویر تولیدشده
- outputنوع: string · Output Image Tokenتهیپذیر
_image _token دلار آمریکا به ازای هر توکن تصویر خروجی
- outputنوع: string · Output Video Secondتهیپذیر
_video _second دلار آمریکا به ازای هر ثانیه ویدیوی تولیدشده
- promptنوع: string · Promptتهیپذیر
دلار آمریکا به ازای هر توکن ورودی؛ null یعنی در دسترس نیست، 0 یعنی رایگان
- requestنوع: string · Requestتهیپذیر
دلار آمریکا به ازای هر درخواست
- webنوع: string · Web Searchتهیپذیر
_search دلار آمریکا به ازای هر درخواست جستجوی وب
- pricingنوع: string · Pricing Modeفهرست مقادیر
_mode نرخهای واحد پیکربندیشده، یا هزینه رسانه گزارششده ضربدر تخفیف فروش
مقادیر- configured
_rates - upstream
_cost
- defaultنوع: string · Default Channelتهیپذیر
_channel - recommendedنوع: string · Recommended Protocolفهرست مقادیرتهیپذیر
_protocol فقط توصیه کلاینت در سطح مدل؛ برای مدلهای غیرچت null؛ پروتکلهای قابل فراخوانی را محدود نمیکند
مقادیر- responses
- messages
- totalنوع: integer · Totalالزامی
Integer numbers.
- نوع: string · Localeفهرست مقادیرlocaleالزامیمقادیر
- en
- zh
- C N - zh
- T W - ja
- ko
- schema
_version مقدار ثابت:2الزامیInteger numbers.
application/json - 304
بازنمایی بدون تغییر؛ بدنه خالی
- 400
زبان پشتیبانینشده
- 422
projection یا kind نامعتبر
- 503
فهرست موقتاً در دسترس نیست
curl https://openapi.felo.ai/api/platform/model-catalog
{
"schema_version": 2,
"locale": "en",
"data": {
"total": 1,
"models": [
{
"id": "example-model",
"slug": "example/example-model",
"name": "Example model",
"short_name": "Example",
"author": "example",
"author_display_name": "Example",
"icon_url": null,
"model_kind": "chat",
"recommended_protocol": "messages",
"summary": "مدل نمونه.",
"description": "متن توضیحی، نه یک مدل واقعی.",
"best_for": [],
"content_locale": "en",
"available_content_locales": [
"en"
],
"document": {
"notice": null,
"extra": {},
"updated_at": "2026-10-14T00:00:00Z"
},
"latency_class": null,
"trial_status": "unknown",
"released_at": null,
"sort_order": 0,
"updated_at": "2026-10-14T00:00:00Z",
"context_length": 32768,
"max_completion_tokens": 4096,
"input_modalities": [
"text"
],
"output_modalities": [
"text"
],
"capabilities": [],
"supported_parameters": [
"temperature"
],
"reasoning": null,
"video_spec": null,
"default_channel": "standard",
"channels": [
{
"code": "standard",
"name": "Standard",
"service_tier": "standard",
"region": null,
"is_default": true,
"runnable": true,
"standard_pricing": {
"channel": "standard",
"currency": "USD",
"basis": "standard",
"billing_kind": "token",
"prompt": "0.000001",
"completion": "0.000002",
"input_cache_write": "0.00000125",
"input_cache_write_1h": "0.000002",
"tiers": []
},
"discount_multiplier": "0.8",
"pricing_mode": "configured_rates"
},
{
"code": "priority",
"name": "Priority",
"service_tier": "priority",
"region": null,
"is_default": false,
"runnable": false,
"standard_pricing": null,
"discount_multiplier": null,
"pricing_mode": "configured_rates"
}
]
}
]
}
}