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.

Query-параметры

model
Тип: string
мин. длина:
1
макс. длина:
256
обязательно

Exact case-sensitive public model name or registered alias
locale
Тип: string enum

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 Localesenum
обязательно
значения
en
zh-CN
zh-TW
ja
ko
best_for
Тип: array string[] · Best For
обязательно
capabilities
Тип: array string[] · Capabilities
обязательно
content_locale
Тип: string · Content Localeenumможет быть 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 Kindenum
обязательно
значения
chat
image_generation
video_generation
decisions
name
Тип: string · Name
обязательно
output_modalities
Тип: array string[] · Output Modalities
обязательно
reasoning
Тип: object · Reasoningможет быть null
обязательно

JSON-объект рассуждений от upstream; сохраняет неизвестные поля; 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 Schema только с данными для допустимых комбинаций запроса

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; применяйте один раз к настроенным тарифам или стоимости upstream

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 · Operatorenum
обязательно
значения
eq
gt
gte
value
обязательно
Тип: string · Value
overrides
Тип: object · Overrides
обязательно
propertyName
Тип: string
audio
Тип: string · Audioможет быть null

USD за входной аудиотокен

completion
Тип: string · Completionможет быть null

USD за выходной токен

credit
Тип: string · Creditможет быть null

USD per credit; billed using the upstream call multiplier

input_audio_cache
Тип: string · Input Audio Cacheможет быть null

USD за кэшированный аудиотокен

input_cache_read
Тип: string · Input Cache Readможет быть null

USD за кэшированный входной токен

input_cache_write
Тип: string · Input Cache Writeможет быть null

USD за токен записи в кэш

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

USD за токен записи в кэш на 1 час; отдельно от записей с TTL по умолчанию

input_image
Тип: string · Input Imageможет быть null

USD за входное изображение

input_image_cache
Тип: string · Input Image Cacheможет быть null

USD per cached image token

input_image_token
Тип: string · Input Image Tokenможет быть null

USD за входной токен изображения

input_video_second
Тип: string · Input Video Secondможет быть null

USD за секунду входного видео

internal_reasoning
Тип: string · Internal Reasoningможет быть null

USD за токен рассуждений

output_image
Тип: string · Output Imageможет быть null

USD за сгенерированное изображение

output_image_token
Тип: string · Output Image Tokenможет быть null

USD за выходной токен изображения

output_video_second
Тип: string · Output Video Secondможет быть null

USD за секунду сгенерированного видео

output_video_token
Тип: string · Output Video Tokenможет быть null

USD per generated video token

prompt
Тип: string · Promptможет быть null

USD за входной токен; null означает недоступность, 0 — бесплатно

request
Тип: string · Requestможет быть null

USD за запрос

web_search
Тип: string · Web Searchможет быть null

USD за запрос веб-поиска

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 Modeenum

Настроенные единичные тарифы или заявленная стоимость медиа, умноженная на торговую скидку

значения
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 Billingenum
обязательно
значения
per_image
included
not_applicable
input_mode
Тип: string · Input Modeenum
обязательно
значения
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 · Unitenum
обязательно
значения
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 · Operatorenum
обязательно
значения
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 · Operatorenum
обязательно
значения
eq
gt
gte
value
обязательно
Тип: string · Value
resolution
Тип: string · Resolutionможет быть null
second_basis
Тип: string · Second Basisenum
обязательно

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 · Fallbackenum
обязательно
значения
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 Protocolenumможет быть null

Только рекомендация для клиентов на уровне модели; null для моделей, отличных от чат-моделей; не ограничивает вызываемые протоколы

значения
responses
messages
locale
Тип: string · Localeenum
обязательно
значения
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

Нужна помощь?