v0.4.0

OpenAPI 3.1.0

Get a public model by name

Felo API Support

MIT

الخادم

https://openapi.felo.ai

مكتبات العملاء

Shell Curl

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.

معاملات الاستعلام

model
النوع: string
أدنى طول:
1
أقصى طول:
256
مطلوب

Exact case-sensitive public model name or registered alias
locale
النوع: string تعداد

Document language; falls back to English when unavailable
القيم
- en
- zh-CN
- zh-TW
- ja
- ko

الرؤوس

If-None-Match
النوع: string

Previous ETag; matching content returns 304

الاستجابات

200
النوع: object · ModelCatalogModelResponse

Public model details
data
النوع: object · CatalogModel
مطلوب
author
النوع: string · Authorيقبل null
مطلوب
author_display_name
النوع: string · Author Display Nameيقبل null
مطلوب
available_content_locales
النوع: array string[] · Available Content Localesتعداد
مطلوب
القيم
en
zh-CN
zh-TW
ja
ko
best_for
النوع: array string[] · Best For
مطلوب
capabilities
النوع: array string[] · Capabilities
مطلوب
content_locale
النوع: string · Content Localeتعداديقبل null
مطلوب
القيم
en
zh-CN
zh-TW
ja
ko
context_length
النوع: integer · Context Lengthيقبل null
مطلوب

Integer numbers.

description
النوع: string · Descriptionيقبل null
مطلوب
document
النوع: object · PublicDocumentيقبل null
مطلوب

اللغة المحددة فقط؛ تبقى summary/description/best_for على النموذج

extra
النوع: object · Extra
مطلوب
propertyName
النوع: anything
notice
النوع: object · CatalogNoticeيقبل null
مطلوب
body
النوع: string · Body
مطلوب
link_text
النوع: string · Link Textيقبل null
مطلوب
target_slug
النوع: string · Target Slugيقبل null
مطلوب
title
النوع: string · Titleيقبل null
مطلوب
updated_at
النوع: string · Updated At
مطلوب

وقت تحديث مستند اللغة المحددة

icon_url
النوع: string · Icon Urlيقبل null
مطلوب
id
النوع: string · Id
مطلوب
input_modalities
النوع: array string[] · Input Modalities
مطلوب
latency_class
النوع: string · Latency Classيقبل null
مطلوب
max_completion_tokens
النوع: integer · Max Completion Tokensيقبل null
مطلوب

Integer numbers.

model_kind
النوع: string · Model Kindتعداد
مطلوب
القيم
chat
image_generation
video_generation
decisions
name
النوع: string · Name
مطلوب
output_modalities
النوع: array string[] · Output Modalities
مطلوب
reasoning
النوع: object · Reasoningيقبل null
مطلوب

كائن JSON لاستدلال المنبع؛ يحافظ على الحقول غير المعروفة؛ null إذا لم يتوفر

propertyName
النوع: anything
released_at
النوع: string · Released Atيقبل null
مطلوب

Model release date in ISO 8601 UTC; may use the OpenRouter listing time. Manual overrides take precedence; null means unknown.

short_name
النوع: string · Short Name
مطلوب
slug
النوع: string · Slug
مطلوب
sort_order
النوع: integer · Sort Order
مطلوب

Integer numbers.

summary
النوع: string · Summaryيقبل null
مطلوب
supported_parameters
النوع: array string[] · Supported Parameters
مطلوب
trial_status
النوع: string · Trial Status
مطلوب
updated_at
النوع: string · Updated Atيقبل null
مطلوب
video_spec
النوع: object · VideoSpecيقبل null
مطلوب
aspect_ratios
النوع: array string[] | null · Aspect Ratiosيقبل null
audio
النوع: object · AudioSpecيقبل null
input
النوع: boolean · Inputيقبل null
output
النوع: boolean · Outputيقبل null
output_optional
النوع: boolean · Output Optionalيقبل null
constraints
النوع: object · Constraintsيقبل null

مخطط JSON للبيانات فقط لمجموعات الطلبات الصالحة

propertyName
النوع: anything
duration_seconds
النوع: object · DurationSpecيقبل null
max
النوع: number · Max
أكبر من:
0
مطلوب
min
النوع: number · Min
الحد الأدنى:
0
مطلوب
step
النوع: number · Step
أكبر من:
0
مطلوب
example_request
النوع: object · Example Requestيقبل null
propertyName
النوع: anything
input_modes
النوع: array string[] | null · Input Modesيقبل null
reference_limits
النوع: object · Reference Limitsيقبل null
propertyName
يقبل null
النوع: integer

Integer numbers.

request_defaults
النوع: object · Request Defaultsيقبل null
propertyName
النوع: anything
resolutions
النوع: array string[] | null · Resolutionsيقبل null
channels
النوع: array object[] · Channels
code
النوع: string · Code
مطلوب
discount_multiplier
النوع: string · Discount Multiplierيقبل null
مطلوب

مضاعف بيع دقيق من 0 إلى 1؛ يُطبَّق مرة واحدة على المعدلات المُهيَّأة أو تكلفة المنبع

is_default
النوع: boolean · Is Default
مطلوب
name
النوع: string · Name
مطلوب
region
النوع: string · Regionيقبل null
مطلوب
runnable
النوع: boolean · Runnable
مطلوب
service_tier
النوع: string · Service Tier
مطلوب
standard_pricing
النوع: object · CatalogPricingيقبل null
مطلوب

معدلات الوحدة القياسية قبل خصم البيع؛ null لقنوات upstream_cost

basis
ثابت:
standard
مطلوب
billing_kind
النوع: string · Billing 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
مطلوب
propertyName
النوع: string
audio
النوع: string · Audioيقبل null

دولار أمريكي لكل رمز صوت إدخال

completion
النوع: string · Completionيقبل null

دولار أمريكي لكل رمز إخراج

credit
النوع: string · Creditيقبل null

USD per credit; billed using the upstream call multiplier

input_audio_cache
النوع: string · Input Audio Cacheيقبل null

دولار أمريكي لكل رمز صوت مخزّن مؤقتًا

input_cache_read
النوع: string · Input Cache Readيقبل null

دولار أمريكي لكل رمز إدخال مخزّن مؤقتًا

input_cache_write
النوع: string · Input Cache Writeيقبل null

دولار أمريكي لكل رمز كتابة ذاكرة تخزين مؤقت

input_cache_write_12h
النوع: string · Input Cache Write 12Hيقبل null

USD per 12-hour cache write token; separate from default TTL writes

input_cache_write_1h
النوع: string · Input Cache Write 1Hيقبل null

دولار أمريكي لكل رمز كتابة ذاكرة تخزين مؤقت لمدة ساعة واحدة؛ منفصل عن كتابات TTL الافتراضية

input_image
النوع: string · Input Imageيقبل null

دولار أمريكي لكل صورة إدخال

input_image_cache
النوع: string · Input Image Cacheيقبل null

USD per cached image token

input_image_token
النوع: string · Input Image Tokenيقبل null

دولار أمريكي لكل رمز صورة إدخال

input_video_second
النوع: string · Input Video Secondيقبل null

دولار أمريكي لكل ثانية فيديو إدخال

internal_reasoning
النوع: string · Internal Reasoningيقبل null

دولار أمريكي لكل رمز استدلال

output_image
النوع: string · Output Imageيقبل null

دولار أمريكي لكل صورة مولّدة

output_image_token
النوع: string · Output Image Tokenيقبل null

دولار أمريكي لكل رمز صورة إخراج

output_video_second
النوع: string · Output Video Secondيقبل null

دولار أمريكي لكل ثانية فيديو مولّدة

output_video_token
النوع: string · Output Video Tokenيقبل null

USD per generated video token

prompt
النوع: string · Promptيقبل null

دولار أمريكي لكل رمز إدخال؛ null يعني غير متاح، و0 يعني مجاني

request
النوع: string · Requestيقبل null

دولار أمريكي لكل طلب

web_search
النوع: string · Web Searchيقبل null

دولار أمريكي لكل طلب بحث على الويب

markup_multiplier
النوع: string · Markup Multiplierيقبل null

Sale markup (>= 1) applied to the purchase price or upstream cost to form the sale price, before discount_multiplier

pricing_mode
النوع: string · Pricing Modeتعداد

معدلات الوحدة المُهيَّأة، أو تكلفة الوسائط المُبلَّغ عنها مضروبة في خصم البيع

القيم
configured_rates
upstream_cost
reference_pricing
يقبل null

Public video reference before discount; not a final charge

as_of
النوع: string · As Of
مطلوب
canonical_slug
النوع: string · Canonical Slug
مطلوب
pricing_type
ثابت:
per_second
مطلوب
request_defaults
النوع: object · Request Defaults
مطلوب
propertyName
النوع: string
reservation
النوع: object · VideoReservation
مطلوب
max_duration_seconds
النوع: integer · Max Duration Seconds
أكبر من:
0
مطلوب

Integer numbers.

output_count
ثابت:
1

Integer numbers.

strategy
ثابت:
requested_duration_or_model_max
rows
النوع: array object[] · Rows
مطلوب
input_image_billing
النوع: string · Input Image Billingتعداد
مطلوب
القيم
per_image
included
not_applicable
input_mode
النوع: string · Input Modeتعداد
مطلوب
القيم
text_to_video
image_to_video
first_last_frame
max_duration_output_estimate_usd
النوع: string · Max Duration Output Estimate Usd
مطلوب
resolution
النوع: string · Resolution
مطلوب
unit
النوع: string · Unitتعداد
مطلوب
القيم
output_video_second
video_token
unit_price_usd
النوع: string · Unit Price Usd
مطلوب
aspect_ratio
النوع: string · Aspect Ratioيقبل null
derived_output_second_usd
النوع: string · Derived Output Second Usdيقبل null
generate_audio
النوع: boolean · Generate Audioيقبل null
input_image_price_usd
النوع: string · Input Image Price Usdيقبل null
reservation_supported
ثابت:
true
reservation_unavailable_reason
النوع: null · Reservation Unavailable Reason
size
النوع: string · Sizeيقبل null
seed_supported
النوع: boolean · Seed Supported
مطلوب
snapshot_id
النوع: string · Snapshot Id
مطلوب
source_model_id
النوع: string · Source Model Id
مطلوب
supported_aspect_ratios
النوع: array string[] · Supported Aspect Ratios
مطلوب
supported_durations
النوع: array integer[] · Supported Durations
مطلوب
supported_frame_images
النوع: array string[] · Supported Frame Images
مطلوب
supported_resolutions
النوع: array string[] · Supported Resolutions
مطلوب
basis
ثابت:
public_reference_before_discount
currency
ثابت:
USD
settlement_basis
ثابت:
upstream_cost
version
ثابت:
1

Integer numbers.

sale_pricing
النوع: object · VideoSalePricingيقبل null

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

propertyName
النوع: anything
rates
النوع: object · Rates
مطلوب

USD sale unit prices (purchase price times markup_multiplier), before discount

propertyName
النوع: string
predicates
النوع: array object[] | null · Predicatesيقبل null

Ordered rule predicates including range comparisons

field
النوع: string · Field
مطلوب

سياق تسعير Felo، مثل input_context_tokens

operator
النوع: string · Operatorتعداد
مطلوب
القيم
eq
gt
gte
value
مطلوب
النوع: string · Value
minimum_charge_usd
النوع: string · Minimum Charge Usdيقبل null

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يقبل null

Primary billing unit, e.g. output_video_second or video_token

second_pricing
النوع: object · VideoSecondPricingيقبل null

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_second_usd
النوع: string · Per Second Usd
مطلوب

USD per output second (sale price before discount); markup already applied

aspect_ratio
النوع: string · Aspect Ratioيقبل null
generate_audio
النوع: boolean · Generate Audioيقبل null
input_image_usd
النوع: string · Input Image Usdيقبل null

USD per input image (sale price before discount); null if none

input_mode
النوع: string · Input Modeيقبل null
predicates
النوع: array object[] | null · Predicatesيقبل null

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يقبل null
second_basis
النوع: string · Second 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_type
النوع: string · Pricing Typeيقبل null

per_second or video_token

settlement_policy
النوع: object · PublicSettlementPolicyيقبل null

Published primary pricing and missing-usage fallback policy

fallback
النوع: string · Fallbackتعداد
مطلوب
القيم
upstream_cost
review_required
primary
ثابت:
configured_rates
مطلوب
version
ثابت:
1
مطلوب

Integer numbers.

default_channel
النوع: string · Default Channelيقبل null
parameter_definitions
النوع: object · Parameter 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.

propertyName
النوع: object
propertyName
النوع: anything
recommended_protocol
النوع: string · Recommended Protocolتعداديقبل null

توصية عميل على مستوى النموذج فقط؛ null للنماذج غير الخاصة بالدردشة؛ ولا تقيّد البروتوكولات القابلة للاستدعاء

القيم
responses
messages
locale
النوع: string · Localeتعداد
مطلوب
القيم
en
zh-CN
zh-TW
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

get/api/platform/model-catalog/model

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": {}
    }
  }
}

Public model details

Get a public model by name

Get a public model by name

هل تحتاج إلى مساعدة؟