v0.4.0

OpenAPI 3.1.0

Get a public model by name

Felo API Support

MIT

Server

https://openapi.felo.ai

Librerie client

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.

Parametri di query

model
Tipo: string
lunghezza minima:
1
lunghezza massima:
256
obbligatorio

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

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

Intestazioni

If-None-Match
Tipo: string

Previous ETag; matching content returns 304

Risposte

200
Tipo: object · ModelCatalogModelResponse

Public model details
data
Tipo: object · CatalogModel
obbligatorio
author
Tipo: string · Authorammette null
obbligatorio
author_display_name
Tipo: string · Author Display Nameammette null
obbligatorio
available_content_locales
Tipo: array string[] · Available Content Localesenum
obbligatorio
valori
en
zh-CN
zh-TW
ja
ko
best_for
Tipo: array string[] · Best For
obbligatorio
capabilities
Tipo: array string[] · Capabilities
obbligatorio
content_locale
Tipo: string · Content Localeenumammette null
obbligatorio
valori
en
zh-CN
zh-TW
ja
ko
context_length
Tipo: integer · Context Lengthammette null
obbligatorio

Integer numbers.

description
Tipo: string · Descriptionammette null
obbligatorio
document
Tipo: object · PublicDocumentammette null
obbligatorio

Solo la lingua selezionata; summary/description/best_for restano sul modello

extra
Tipo: object · Extra
obbligatorio
propertyName
Tipo: anything
notice
Tipo: object · CatalogNoticeammette null
obbligatorio
body
Tipo: string · Body
obbligatorio
link_text
Tipo: string · Link Textammette null
obbligatorio
target_slug
Tipo: string · Target Slugammette null
obbligatorio
title
Tipo: string · Titleammette null
obbligatorio
updated_at
Tipo: string · Updated At
obbligatorio

Ora di aggiornamento del documento nella lingua selezionata

icon_url
Tipo: string · Icon Urlammette null
obbligatorio
id
Tipo: string · Id
obbligatorio
input_modalities
Tipo: array string[] · Input Modalities
obbligatorio
latency_class
Tipo: string · Latency Classammette null
obbligatorio
max_completion_tokens
Tipo: integer · Max Completion Tokensammette null
obbligatorio

Integer numbers.

model_kind
Tipo: string · Model Kindenum
obbligatorio
valori
chat
image_generation
video_generation
decisions
name
Tipo: string · Name
obbligatorio
output_modalities
Tipo: array string[] · Output Modalities
obbligatorio
reasoning
Tipo: object · Reasoningammette null
obbligatorio

Oggetto JSON reasoning upstream; conserva i campi sconosciuti; null se non disponibile

propertyName
Tipo: anything
released_at
Tipo: string · Released Atammette null
obbligatorio

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

short_name
Tipo: string · Short Name
obbligatorio
slug
Tipo: string · Slug
obbligatorio
sort_order
Tipo: integer · Sort Order
obbligatorio

Integer numbers.

summary
Tipo: string · Summaryammette null
obbligatorio
supported_parameters
Tipo: array string[] · Supported Parameters
obbligatorio
trial_status
Tipo: string · Trial Status
obbligatorio
updated_at
Tipo: string · Updated Atammette null
obbligatorio
video_spec
Tipo: object · VideoSpecammette null
obbligatorio
aspect_ratios
Tipo: array string[] | null · Aspect Ratiosammette null
audio
Tipo: object · AudioSpecammette null
input
Tipo: boolean · Inputammette null
output
Tipo: boolean · Outputammette null
output_optional
Tipo: boolean · Output Optionalammette null
constraints
Tipo: object · Constraintsammette null

JSON Schema di soli dati per le combinazioni di richiesta valide

propertyName
Tipo: anything
duration_seconds
Tipo: object · DurationSpecammette null
max
Tipo: number · Max
maggiore di:
0
obbligatorio
min
Tipo: number · Min
min:
0
obbligatorio
step
Tipo: number · Step
maggiore di:
0
obbligatorio
example_request
Tipo: object · Example Requestammette null
propertyName
Tipo: anything
input_modes
Tipo: array string[] | null · Input Modesammette null
reference_limits
Tipo: object · Reference Limitsammette null
propertyName
ammette null
Tipo: integer

Integer numbers.

request_defaults
Tipo: object · Request Defaultsammette null
propertyName
Tipo: anything
resolutions
Tipo: array string[] | null · Resolutionsammette null
channels
Tipo: array object[] · Channels
code
Tipo: string · Code
obbligatorio
discount_multiplier
Tipo: string · Discount Multiplierammette null
obbligatorio

Moltiplicatore di vendita esatto da 0 a 1; applicare una sola volta alle tariffe configurate o al costo upstream

is_default
Tipo: boolean · Is Default
obbligatorio
name
Tipo: string · Name
obbligatorio
region
Tipo: string · Regionammette null
obbligatorio
runnable
Tipo: boolean · Runnable
obbligatorio
service_tier
Tipo: string · Service Tier
obbligatorio
standard_pricing
Tipo: object · CatalogPricingammette null
obbligatorio

Tariffe unitarie standard prima dello sconto di vendita; null per i canali upstream_cost

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

Conservare l'ordine; il primo livello corrispondente sostituisce le tariffe di base

conditions
Tipo: array object[] · Conditions
obbligatorio
field
Tipo: string · Field
obbligatorio

Contesto di tariffazione Felo, ad es. input_context_tokens

operator
Tipo: string · Operatorenum
obbligatorio
valori
eq
gt
gte
value
obbligatorio
Tipo: string · Value
overrides
Tipo: object · Overrides
obbligatorio
propertyName
Tipo: string
audio
Tipo: string · Audioammette null

USD per token audio di input

completion
Tipo: string · Completionammette null

USD per token di output

credit
Tipo: string · Creditammette null

USD per credit; billed using the upstream call multiplier

input_audio_cache
Tipo: string · Input Audio Cacheammette null

USD per token audio in cache

input_cache_read
Tipo: string · Input Cache Readammette null

USD per token di input in cache

input_cache_write
Tipo: string · Input Cache Writeammette null

USD per token di scrittura in cache

input_cache_write_12h
Tipo: string · Input Cache Write 12Hammette null

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

input_cache_write_1h
Tipo: string · Input Cache Write 1Hammette null

USD per token di scrittura in cache da 1 ora; separato dalle scritture con TTL predefinito

input_image
Tipo: string · Input Imageammette null

USD per immagine di input

input_image_cache
Tipo: string · Input Image Cacheammette null

USD per cached image token

input_image_token
Tipo: string · Input Image Tokenammette null

USD per token di immagine di input

input_video_second
Tipo: string · Input Video Secondammette null

USD per secondo di video di input

internal_reasoning
Tipo: string · Internal Reasoningammette null

USD per token di reasoning

output_image
Tipo: string · Output Imageammette null

USD per immagine generata

output_image_token
Tipo: string · Output Image Tokenammette null

USD per token di immagine di output

output_video_second
Tipo: string · Output Video Secondammette null

USD per secondo di video generato

output_video_token
Tipo: string · Output Video Tokenammette null

USD per generated video token

prompt
Tipo: string · Promptammette null

USD per token di input; null indica non disponibile, 0 indica gratuito

request
Tipo: string · Requestammette null

USD per richiesta

web_search
Tipo: string · Web Searchammette null

USD per richiesta di ricerca web

markup_multiplier
Tipo: string · Markup Multiplierammette null

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

pricing_mode
Tipo: string · Pricing Modeenum

Tariffe unitarie configurate oppure costo dei contenuti multimediali comunicato moltiplicato per lo sconto di vendita

valori
configured_rates
upstream_cost
reference_pricing
ammette null

Public video reference before discount; not a final charge

as_of
Tipo: string · As Of
obbligatorio
canonical_slug
Tipo: string · Canonical Slug
obbligatorio
pricing_type
const:
per_second
obbligatorio
request_defaults
Tipo: object · Request Defaults
obbligatorio
propertyName
Tipo: string
reservation
Tipo: object · VideoReservation
obbligatorio
max_duration_seconds
Tipo: integer · Max Duration Seconds
maggiore di:
0
obbligatorio

Integer numbers.

output_count
const:
1

Integer numbers.

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

Integer numbers.

sale_pricing
Tipo: object · VideoSalePricingammette 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
obbligatorio
currency
const:
USD
obbligatorio
rows
Tipo: array object[] · Rows
obbligatorio

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
Tipo: object · Conditions
obbligatorio

Equality-condition summary; predicates retain the complete rule semantics

propertyName
Tipo: anything
rates
Tipo: object · Rates
obbligatorio

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

propertyName
Tipo: string
predicates
Tipo: array object[] | null · Predicatesammette null

Ordered rule predicates including range comparisons

field
Tipo: string · Field
obbligatorio

Contesto di tariffazione Felo, ad es. input_context_tokens

operator
Tipo: string · Operatorenum
obbligatorio
valori
eq
gt
gte
value
obbligatorio
Tipo: string · Value
minimum_charge_usd
Tipo: string · Minimum Charge Usdammette 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
Tipo: string · Unitammette null

Primary billing unit, e.g. output_video_second or video_token

second_pricing
Tipo: object · VideoSecondPricingammette 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
obbligatorio
currency
const:
USD
obbligatorio
rows
Tipo: array object[] · Rows
obbligatorio
estimated
Tipo: boolean · Estimated
obbligatorio

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

per_second_usd
Tipo: string · Per Second Usd
obbligatorio

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

aspect_ratio
Tipo: string · Aspect Ratioammette null
generate_audio
Tipo: boolean · Generate Audioammette null
input_image_usd
Tipo: string · Input Image Usdammette null

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

input_mode
Tipo: string · Input Modeammette null
predicates
Tipo: array object[] | null · Predicatesammette null

Full conditions for this per-second price row

field
Tipo: string · Field
obbligatorio

Contesto di tariffazione Felo, ad es. input_context_tokens

operator
Tipo: string · Operatorenum
obbligatorio
valori
eq
gt
gte
value
obbligatorio
Tipo: string · Value
resolution
Tipo: string · Resolutionammette null
second_basis
Tipo: string · Second Basisenum
obbligatorio

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.

valori
exact
token_pixel_frames_estimate
pricing_type
Tipo: string · Pricing Typeammette null

per_second or video_token

settlement_policy
Tipo: object · PublicSettlementPolicyammette null

Published primary pricing and missing-usage fallback policy

fallback
Tipo: string · Fallbackenum
obbligatorio
valori
upstream_cost
review_required
primary
const:
configured_rates
obbligatorio
version
const:
1
obbligatorio

Integer numbers.

default_channel
Tipo: string · Default Channelammette null
parameter_definitions
Tipo: 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
Tipo: object
propertyName
Tipo: anything
recommended_protocol
Tipo: string · Recommended Protocolenumammette null

Solo un consiglio per il client valido per l'intero modello; null per i modelli non chat; non limita i protocolli chiamabili

valori
responses
messages
locale
Tipo: string · Localeenum
obbligatorio
valori
en
zh-CN
zh-TW
ja
ko
schema_version
const:
2
obbligatorio

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

Mostra schema

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

Serve aiuto?