v0.4.0

OpenAPI 3.1.0

Get a public model by name

Felo API Support

MIT

Serwer

https://openapi.felo.ai

Biblioteki klienckie

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.

Parametry zapytania

model
Typ: string
min. długość:
1
maks. długość:
256
wymagane

Exact case-sensitive public model name or registered alias
locale
Typ: string enum

Document language; falls back to English when unavailable
wartości
- en
- zh-CN
- zh-TW
- ja
- ko

Nagłówki

If-None-Match
Typ: string

Previous ETag; matching content returns 304

Odpowiedzi

200
Typ: object · ModelCatalogModelResponse

Public model details
data
Typ: object · CatalogModel
wymagane
author
Typ: string · Authordopuszcza null
wymagane
author_display_name
Typ: string · Author Display Namedopuszcza null
wymagane
available_content_locales
Typ: array string[] · Available Content Localesenum
wymagane
wartości
en
zh-CN
zh-TW
ja
ko
best_for
Typ: array string[] · Best For
wymagane
capabilities
Typ: array string[] · Capabilities
wymagane
content_locale
Typ: string · Content Localeenumdopuszcza null
wymagane
wartości
en
zh-CN
zh-TW
ja
ko
context_length
Typ: integer · Context Lengthdopuszcza null
wymagane

Integer numbers.

description
Typ: string · Descriptiondopuszcza null
wymagane
document
Typ: object · PublicDocumentdopuszcza null
wymagane

Dotyczy tylko wybranego języka; summary/description/best_for pozostają na modelu

extra
Typ: object · Extra
wymagane
propertyName
Typ: anything
notice
Typ: object · CatalogNoticedopuszcza null
wymagane
body
Typ: string · Body
wymagane
link_text
Typ: string · Link Textdopuszcza null
wymagane
target_slug
Typ: string · Target Slugdopuszcza null
wymagane
title
Typ: string · Titledopuszcza null
wymagane
updated_at
Typ: string · Updated At
wymagane

Czas aktualizacji dokumentu w wybranym języku

icon_url
Typ: string · Icon Urldopuszcza null
wymagane
id
Typ: string · Id
wymagane
input_modalities
Typ: array string[] · Input Modalities
wymagane
latency_class
Typ: string · Latency Classdopuszcza null
wymagane
max_completion_tokens
Typ: integer · Max Completion Tokensdopuszcza null
wymagane

Integer numbers.

model_kind
Typ: string · Model Kindenum
wymagane
wartości
chat
image_generation
video_generation
decisions
name
Typ: string · Name
wymagane
output_modalities
Typ: array string[] · Output Modalities
wymagane
reasoning
Typ: object · Reasoningdopuszcza null
wymagane

Obiekt JSON reasoning z upstream; zachowuje nieznane pola; null, jeśli niedostępny

propertyName
Typ: anything
released_at
Typ: string · Released Atdopuszcza null
wymagane

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

short_name
Typ: string · Short Name
wymagane
slug
Typ: string · Slug
wymagane
sort_order
Typ: integer · Sort Order
wymagane

Integer numbers.

summary
Typ: string · Summarydopuszcza null
wymagane
supported_parameters
Typ: array string[] · Supported Parameters
wymagane
trial_status
Typ: string · Trial Status
wymagane
updated_at
Typ: string · Updated Atdopuszcza null
wymagane
video_spec
Typ: object · VideoSpecdopuszcza null
wymagane
aspect_ratios
Typ: array string[] | null · Aspect Ratiosdopuszcza null
audio
Typ: object · AudioSpecdopuszcza null
input
Typ: boolean · Inputdopuszcza null
output
Typ: boolean · Outputdopuszcza null
output_optional
Typ: boolean · Output Optionaldopuszcza null
constraints
Typ: object · Constraintsdopuszcza null

Schemat JSON Schema zawierający wyłącznie dane dla prawidłowych kombinacji żądań

propertyName
Typ: anything
duration_seconds
Typ: object · DurationSpecdopuszcza null
max
Typ: number · Max
większe niż:
0
wymagane
min
Typ: number · Min
min.:
0
wymagane
step
Typ: number · Step
większe niż:
0
wymagane
example_request
Typ: object · Example Requestdopuszcza null
propertyName
Typ: anything
input_modes
Typ: array string[] | null · Input Modesdopuszcza null
reference_limits
Typ: object · Reference Limitsdopuszcza null
propertyName
dopuszcza null
Typ: integer

Integer numbers.

request_defaults
Typ: object · Request Defaultsdopuszcza null
propertyName
Typ: anything
resolutions
Typ: array string[] | null · Resolutionsdopuszcza null
channels
Typ: array object[] · Channels
code
Typ: string · Code
wymagane
discount_multiplier
Typ: string · Discount Multiplierdopuszcza null
wymagane

Dokładny mnożnik sprzedażowy od 0 do 1; zastosuj raz do skonfigurowanych stawek lub kosztu upstream

is_default
Typ: boolean · Is Default
wymagane
name
Typ: string · Name
wymagane
region
Typ: string · Regiondopuszcza null
wymagane
runnable
Typ: boolean · Runnable
wymagane
service_tier
Typ: string · Service Tier
wymagane
standard_pricing
Typ: object · CatalogPricingdopuszcza null
wymagane

Standardowe stawki jednostkowe przed rabatem sprzedażowym; null dla kanałów upstream_cost

basis
const:
standard
wymagane
billing_kind
Typ: string · Billing Kind
wymagane
channel
Typ: string · Channel
wymagane
currency
const:
USD
wymagane
tiers
Typ: array object[] · Tiers
wymagane

Zachowaj kolejność; pierwszy pasujący próg nadpisuje stawki bazowe

conditions
Typ: array object[] · Conditions
wymagane
field
Typ: string · Field
wymagane

Kontekst cenowy Felo, np. input_context_tokens

operator
Typ: string · Operatorenum
wymagane
wartości
eq
gt
gte
value
wymagane
Typ: string · Value
overrides
Typ: object · Overrides
wymagane
propertyName
Typ: string
audio
Typ: string · Audiodopuszcza null

USD za token wejściowego audio

completion
Typ: string · Completiondopuszcza null

USD za token wyjściowy

credit
Typ: string · Creditdopuszcza null

USD per credit; billed using the upstream call multiplier

input_audio_cache
Typ: string · Input Audio Cachedopuszcza null

USD za buforowany token audio

input_cache_read
Typ: string · Input Cache Readdopuszcza null

USD za buforowany token wejściowy

input_cache_write
Typ: string · Input Cache Writedopuszcza null

USD za token zapisu do pamięci podręcznej

input_cache_write_12h
Typ: string · Input Cache Write 12Hdopuszcza null

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

input_cache_write_1h
Typ: string · Input Cache Write 1Hdopuszcza null

USD za token zapisu do pamięci podręcznej z 1-godzinnym TTL; oddzielnie od zapisów z domyślnym TTL

input_image
Typ: string · Input Imagedopuszcza null

USD za obraz wejściowy

input_image_cache
Typ: string · Input Image Cachedopuszcza null

USD per cached image token

input_image_token
Typ: string · Input Image Tokendopuszcza null

USD za token obrazu wejściowego

input_video_second
Typ: string · Input Video Seconddopuszcza null

USD za sekundę wideo wejściowego

internal_reasoning
Typ: string · Internal Reasoningdopuszcza null

USD za token rozumowania

output_image
Typ: string · Output Imagedopuszcza null

USD za wygenerowany obraz

output_image_token
Typ: string · Output Image Tokendopuszcza null

USD za token obrazu wyjściowego

output_video_second
Typ: string · Output Video Seconddopuszcza null

USD za sekundę wygenerowanego wideo

output_video_token
Typ: string · Output Video Tokendopuszcza null

USD per generated video token

prompt
Typ: string · Promptdopuszcza null

USD za token wejściowy; null oznacza niedostępność, 0 oznacza bezpłatny dostęp

request
Typ: string · Requestdopuszcza null

USD za żądanie

web_search
Typ: string · Web Searchdopuszcza null

USD za żądanie wyszukiwania w sieci

markup_multiplier
Typ: string · Markup Multiplierdopuszcza null

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

pricing_mode
Typ: string · Pricing Modeenum

Skonfigurowane stawki jednostkowe lub zgłoszony koszt multimediów pomnożony przez rabat sprzedażowy

wartości
configured_rates
upstream_cost
reference_pricing
dopuszcza null

Public video reference before discount; not a final charge

as_of
Typ: string · As Of
wymagane
canonical_slug
Typ: string · Canonical Slug
wymagane
pricing_type
const:
per_second
wymagane
request_defaults
Typ: object · Request Defaults
wymagane
propertyName
Typ: string
reservation
Typ: object · VideoReservation
wymagane
max_duration_seconds
Typ: integer · Max Duration Seconds
większe niż:
0
wymagane

Integer numbers.

output_count
const:
1

Integer numbers.

strategy
const:
requested_duration_or_model_max
rows
Typ: array object[] · Rows
wymagane
input_image_billing
Typ: string · Input Image Billingenum
wymagane
wartości
per_image
included
not_applicable
input_mode
Typ: string · Input Modeenum
wymagane
wartości
text_to_video
image_to_video
first_last_frame
max_duration_output_estimate_usd
Typ: string · Max Duration Output Estimate Usd
wymagane
resolution
Typ: string · Resolution
wymagane
unit
Typ: string · Unitenum
wymagane
wartości
output_video_second
video_token
unit_price_usd
Typ: string · Unit Price Usd
wymagane
aspect_ratio
Typ: string · Aspect Ratiodopuszcza null
derived_output_second_usd
Typ: string · Derived Output Second Usddopuszcza null
generate_audio
Typ: boolean · Generate Audiodopuszcza null
input_image_price_usd
Typ: string · Input Image Price Usddopuszcza null
reservation_supported
const:
true
reservation_unavailable_reason
Typ: null · Reservation Unavailable Reason
size
Typ: string · Sizedopuszcza null
seed_supported
Typ: boolean · Seed Supported
wymagane
snapshot_id
Typ: string · Snapshot Id
wymagane
source_model_id
Typ: string · Source Model Id
wymagane
supported_aspect_ratios
Typ: array string[] · Supported Aspect Ratios
wymagane
supported_durations
Typ: array integer[] · Supported Durations
wymagane
supported_frame_images
Typ: array string[] · Supported Frame Images
wymagane
supported_resolutions
Typ: array string[] · Supported Resolutions
wymagane
basis
const:
public_reference_before_discount
currency
const:
USD
settlement_basis
const:
upstream_cost
version
const:
1

Integer numbers.

sale_pricing
Typ: object · VideoSalePricingdopuszcza null

Video sale unit prices (purchase price times markup_multiplier), before discount; null when no synchronized video rates are frozen

basis
const:
sale_before_discount
wymagane
currency
const:
USD
wymagane
rows
Typ: array object[] · Rows
wymagane

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
Typ: object · Conditions
wymagane

Equality-condition summary; predicates retain the complete rule semantics

propertyName
Typ: anything
rates
Typ: object · Rates
wymagane

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

propertyName
Typ: string
predicates
Typ: array object[] | null · Predicatesdopuszcza null

Ordered rule predicates including range comparisons

field
Typ: string · Field
wymagane

Kontekst cenowy Felo, np. input_context_tokens

operator
Typ: string · Operatorenum
wymagane
wartości
eq
gt
gte
value
wymagane
Typ: string · Value
minimum_charge_usd
Typ: string · Minimum Charge Usddopuszcza null

Marked-up minimum charge in USD, before discount; null if none

selection
const:
first_match

First matching rule wins; the final empty rule is the default

unit
Typ: string · Unitdopuszcza null

Primary billing unit, e.g. output_video_second or video_token

second_pricing
Typ: object · VideoSecondPricingdopuszcza 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
const:
sale_before_discount
wymagane
currency
const:
USD
wymagane
rows
Typ: array object[] · Rows
wymagane
estimated
Typ: boolean · Estimated
wymagane

True when derived from a video_token rate via the pixel-frame formula

per_second_usd
Typ: string · Per Second Usd
wymagane

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

aspect_ratio
Typ: string · Aspect Ratiodopuszcza null
generate_audio
Typ: boolean · Generate Audiodopuszcza null
input_image_usd
Typ: string · Input Image Usddopuszcza null

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

input_mode
Typ: string · Input Modedopuszcza null
predicates
Typ: array object[] | null · Predicatesdopuszcza null

Full conditions for this per-second price row

field
Typ: string · Field
wymagane

Kontekst cenowy Felo, np. input_context_tokens

operator
Typ: string · Operatorenum
wymagane
wartości
eq
gt
gte
value
wymagane
Typ: string · Value
resolution
Typ: string · Resolutiondopuszcza null
second_basis
Typ: string · Second Basisenum
wymagane

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.

wartości
exact
token_pixel_frames_estimate
pricing_type
Typ: string · Pricing Typedopuszcza null

per_second or video_token

settlement_policy
Typ: object · PublicSettlementPolicydopuszcza null

Published primary pricing and missing-usage fallback policy

fallback
Typ: string · Fallbackenum
wymagane
wartości
upstream_cost
review_required
primary
const:
configured_rates
wymagane
version
const:
1
wymagane

Integer numbers.

default_channel
Typ: string · Default Channeldopuszcza null
parameter_definitions
Typ: 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
Typ: object
propertyName
Typ: anything
recommended_protocol
Typ: string · Recommended Protocolenumdopuszcza null

Wyłącznie zalecenie dla klienta na poziomie całego modelu; null dla modeli innych niż czat; nie ogranicza protokołów, które można wywołać

wartości
responses
messages
locale
Typ: string · Localeenum
wymagane
wartości
en
zh-CN
zh-TW
ja
ko
schema_version
const:
2
wymagane

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

Pokaż schemat

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

Potrzebujesz pomocy?