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-об'єкт reasoning з апстріму; зберігає невідомі поля; 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; застосовуйте один раз до налаштованих ставок або вартості в апстрімі

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

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 за токен reasoning

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 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

Потрібна допомога?