Get a public model by name
Anonymous exact lookup by public name or registered alias. Returns the canonical model ID and the same model object as the catalog. Unknown or unlisted models return 404. locale controls document selection only.
- نوع: stringmodelحداقل طول:1حداکثر طول:256الزامی
Exact case-sensitive public model name or registered alias
- نوع: string فهرست مقادیرlocale
Document language; falls back to English when unavailable
مقادیر- en
- zh
- C N - zh
- T W - ja
- ko
- نوع: stringIf
- None - Match Previous ETag; matching content returns 304
- نوع: object · ModelCatalogModelResponse200
Public model details
- نوع: object · CatalogModeldataالزامی
- 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 الزامیModel release date in ISO 8601 UTC; may use the OpenRouter listing time. Manual overrides take precedence; null means unknown.
- 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تهی‌پذیر
دلار آمریکا به ازای هر توکن خروجی
- creditنوع: string · Creditتهی‌پذیر
USD per credit; billed using the upstream call multiplier
- 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 12Hتهی‌پذیر
_cache _write _12h USD per 12-hour cache write token; separate from default TTL writes
- inputنوع: string · Input Cache Write 1Hتهی‌پذیر
_cache _write _1h دلار آمریکا به ازای هر توکن نوشتن کش 1 ساعته؛ جدا از نوشتن‌های TTL پیش‌فرض
- inputنوع: string · Input Imageتهی‌پذیر
_image دلار آمریکا به ازای هر تصویر ورودی
- inputنوع: string · Input Image Cacheتهی‌پذیر
_image _cache USD per cached image token
- 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 دلار آمریکا به ازای هر ثانیه ویدیوی تولیدشده
- outputنوع: string · Output Video Tokenتهی‌پذیر
_video _token USD per generated video token
- promptنوع: string · Promptتهی‌پذیر
دلار آمریکا به ازای هر توکن ورودی؛ null یعنی در دسترس نیست، 0 یعنی رایگان
- requestنوع: string · Requestتهی‌پذیر
دلار آمریکا به ازای هر درخواست
- webنوع: string · Web Searchتهی‌پذیر
_search دلار آمریکا به ازای هر درخواست جستجوی وب
- markupنوع: string · Markup Multiplierتهی‌پذیر
_multiplier Sale markup (>= 1) applied to the purchase price or upstream cost to form the sale price, before discount_multiplier
- pricingنوع: string · Pricing Modeفهرست مقادیر
_mode نرخ‌های واحد پیکربندی‌شده، یا هزینه رسانه گزارش‌شده ضرب‌در تخفیف فروش
مقادیر- configured
_rates - upstream
_cost
- referenceتهی‌پذیر
_pricing Public video reference before discount; not a final charge
- asنوع: string · As Of
_of الزامی - canonicalنوع: string · Canonical Slug
_slug الزامی - pricing
_type مقدار ثابت:per_secondالزامی - requestنوع: object · Request Defaults
_defaults الزامی- property
Name - نوع: string
- reservationنوع: object · VideoReservationالزامی
- maxنوع: integer · Max Duration Seconds
_duration _seconds بزرگ‌تر از:0الزامیInteger numbers.
- output
_count مقدار ثابت:1Integer numbers.
- strategyمقدار ثابت:requested_duration_or_model_max
- rowsنوع: array object[] · Rowsالزامی
- inputنوع: string · Input Image Billingفهرست مقادیر
_image _billing الزامیمقادیر- per
_image - included
- not
_applicable
- inputنوع: string · Input Modeفهرست مقادیر
_mode الزامیمقادیر- text
_to _video - image
_to _video - first
_last _frame
- maxنوع: string · Max Duration Output Estimate Usd
_duration _output _estimate _usd الزامی - resolutionنوع: string · Resolutionالزامی
- unitنوع: string · Unitفهرست مقادیرالزامیمقادیر
- output
_video _second - video
_token
- unitنوع: string · Unit Price Usd
_price _usd الزامی - aspectنوع: string · Aspect Ratioتهی‌پذیر
_ratio - derivedنوع: string · Derived Output Second Usdتهی‌پذیر
_output _second _usd - generateنوع: boolean · Generate Audioتهی‌پذیر
_audio - inputنوع: string · Input Image Price Usdتهی‌پذیر
_image _price _usd - reservation
_supported مقدار ثابت:true - reservationنوع: null · Reservation Unavailable Reason
_unavailable _reason - sizeنوع: string · Sizeتهی‌پذیر
- seedنوع: boolean · Seed Supported
_supported الزامی - snapshotنوع: string · Snapshot Id
_id الزامی - sourceنوع: string · Source Model Id
_model _id الزامی - supportedنوع: array string[] · Supported Aspect Ratios
_aspect _ratios الزامی - supportedنوع: array integer[] · Supported Durations
_durations الزامی - supportedنوع: array string[] · Supported Frame Images
_frame _images الزامی - supportedنوع: array string[] · Supported Resolutions
_resolutions الزامی - basisمقدار ثابت:public_reference_before_discount
- currencyمقدار ثابت:USD
- settlement
_basis مقدار ثابت:upstream_cost - versionمقدار ثابت:1
Integer numbers.
- saleنوع: object · VideoSalePricingتهی‌پذیر
_pricing Video sale unit prices (purchase price times markup_multiplier), before discount; null when no synchronized video rates are frozen
- basisمقدار ثابت:sale_before_discountالزامی
- currencyمقدار ثابت:USDالزامی
- rowsنوع: array object[] · Rowsالزامی
Per-spec sale unit prices. Final charge uses the upstream-reported usage, so the billed amount is upstream cost times markup_multiplier times discount_multiplier; a minimum billable duration may apply.
- conditionsنوع: object · Conditionsالزامی
Equality-condition summary; predicates retain the complete rule semantics
- propertyنوع: anything
Name
- ratesنوع: object · Ratesالزامی
USD sale unit prices (purchase price times markup_multiplier), before discount
- propertyنوع: string
Name
- predicatesنوع: array object[] | null · Predicatesتهی‌پذیر
Ordered rule predicates including range comparisons
- fieldنوع: string · Fieldالزامی
بافت قیمت‌گذاری Felo، مثلاً input_context_tokens
- operatorنوع: string · Operatorفهرست مقادیرالزامیمقادیر
- eq
- gt
- gte
- valueالزامی
- نوع: string · Value
- minimumنوع: string · Minimum Charge Usdتهی‌پذیر
_charge _usd Marked-up minimum charge in USD, before discount; null if none
- selectionمقدار ثابت:first_match
First matching rule wins; the final empty rule is the default
- unitنوع: string · Unitتهی‌پذیر
Primary billing unit, e.g. output_video_second or video_token
- secondنوع: object · VideoSecondPricingتهی‌پذیر
_pricing Per-second sale prices by resolution/mode (markup applied, before discount). For video_token models the per-second value is an estimate; settlement uses token usage
- basisمقدار ثابت:sale_before_discountالزامی
- currencyمقدار ثابت:USDالزامی
- rowsنوع: array object[] · Rowsالزامی
- estimatedنوع: boolean · Estimatedالزامی
True when derived from a video_token rate via the pixel-frame formula
- perنوع: string · Per Second Usd
_second _usd الزامیUSD per output second (sale price before discount); markup already applied
- aspectنوع: string · Aspect Ratioتهی‌پذیر
_ratio - generateنوع: boolean · Generate Audioتهی‌پذیر
_audio - inputنوع: string · Input Image Usdتهی‌پذیر
_image _usd USD per input image (sale price before discount); null if none
- inputنوع: string · Input Modeتهی‌پذیر
_mode - predicatesنوع: array object[] | null · Predicatesتهی‌پذیر
Full conditions for this per-second price row
- fieldنوع: string · Fieldالزامی
بافت قیمت‌گذاری Felo، مثلاً input_context_tokens
- operatorنوع: string · Operatorفهرست مقادیرالزامیمقادیر
- eq
- gt
- gte
- valueالزامی
- نوع: string · Value
- resolutionنوع: string · Resolutionتهی‌پذیر
- secondنوع: string · Second Basisفهرست مقادیر
_basis الزامیexact for per-second models; token_pixel_frames_estimate when per_second_usd is derived from the video_token rate (token price x resolution pixels x fps 24 / 1024). Token models still settle on reported token usage; per-second price is for display.
مقادیر- exact
- token
_pixel _frames _estimate
- pricingنوع: string · Pricing Typeتهی‌پذیر
_type per_second or video_token
- settlementنوع: object · PublicSettlementPolicyتهی‌پذیر
_policy Published primary pricing and missing-usage fallback policy
- fallbackنوع: string · Fallbackفهرست مقادیرالزامیمقادیر
- upstream
_cost - review
_required
- primaryمقدار ثابت:configured_ratesالزامی
- versionمقدار ثابت:1الزامی
Integer numbers.
- defaultنوع: string · Default Channelتهی‌پذیر
_channel - parameterنوع: object · Parameter Definitions
_definitions Supported parameters keyed by name, using OpenRouter type/values/min/max format (not JSON Schema); preserves unknown fields; an empty definition means supported with unspecified constraints. An empty object means no parameter metadata. No defaults or options are inferred.
- propertyنوع: object
Name - propertyنوع: anything
Name
- recommendedنوع: string · Recommended Protocolفهرست مقادیرتهی‌پذیر
_protocol فقط توصیه کلاینت در سطح مدل؛ برای مدل‌های غیرچت null؛ پروتکل‌های قابل فراخوانی را محدود نمی‌کند
مقادیر- responses
- messages
- نوع: string · Localeفهرست مقادیرlocaleالزامیمقادیر
- en
- zh
- C N - zh
- T W - ja
- ko
- schema
_version مقدار ثابت:2الزامیInteger numbers.
application/json - 304
Unchanged representation; empty body
- 400
Invalid model name or locale
- 404
Model not found
- 422
Missing model query parameter
- 503
Model catalog unavailable
curl 'https://openapi.felo.ai/api/platform/model-catalog/model?model='
{
"schema_version": 2,
"locale": "en",
"data": {
"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": "Example model.",
"description": "Illustrative text, not a real model.",
"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",
"input_cache_write_12h": "0.000004",
"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"
}
],
"parameter_definitions": {
"temperature": {}
}
}
}