v0.4.0

OpenAPI 3.1.0

Get a public model by name

Felo API Support

MIT

Serveur

https://openapi.felo.ai

Bibliothèques clientes

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.

Paramètres de requête

model
Type: string
longueur min.:
1
longueur max.:
256
obligatoire

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

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

En-têtes

If-None-Match
Type: string

Previous ETag; matching content returns 304

Réponses

200
Type: object · ModelCatalogModelResponse

Public model details
data
Type: object · CatalogModel
obligatoire
author
Type: string · Authornullable
obligatoire
author_display_name
Type: string · Author Display Namenullable
obligatoire
available_content_locales
Type: array string[] · Available Content Localesenum
obligatoire
valeurs
en
zh-CN
zh-TW
ja
ko
best_for
Type: array string[] · Best For
obligatoire
capabilities
Type: array string[] · Capabilities
obligatoire
content_locale
Type: string · Content Localeenumnullable
obligatoire
valeurs
en
zh-CN
zh-TW
ja
ko
context_length
Type: integer · Context Lengthnullable
obligatoire

Integer numbers.

description
Type: string · Descriptionnullable
obligatoire
document
Type: object · PublicDocumentnullable
obligatoire

Langue sélectionnée uniquement ; summary/description/best_for restent sur le modèle

extra
Type: object · Extra
obligatoire
propertyName
Type: anything
notice
Type: object · CatalogNoticenullable
obligatoire
body
Type: string · Body
obligatoire
link_text
Type: string · Link Textnullable
obligatoire
target_slug
Type: string · Target Slugnullable
obligatoire
title
Type: string · Titlenullable
obligatoire
updated_at
Type: string · Updated At
obligatoire

Date de mise à jour du document dans la langue sélectionnée

icon_url
Type: string · Icon Urlnullable
obligatoire
id
Type: string · Id
obligatoire
input_modalities
Type: array string[] · Input Modalities
obligatoire
latency_class
Type: string · Latency Classnullable
obligatoire
max_completion_tokens
Type: integer · Max Completion Tokensnullable
obligatoire

Integer numbers.

model_kind
Type: string · Model Kindenum
obligatoire
valeurs
chat
image_generation
video_generation
decisions
name
Type: string · Name
obligatoire
output_modalities
Type: array string[] · Output Modalities
obligatoire
reasoning
Type: object · Reasoningnullable
obligatoire

Objet JSON de raisonnement amont ; conserve les champs inconnus ; null s'il est indisponible

propertyName
Type: anything
released_at
Type: string · Released Atnullable
obligatoire

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

short_name
Type: string · Short Name
obligatoire
slug
Type: string · Slug
obligatoire
sort_order
Type: integer · Sort Order
obligatoire

Integer numbers.

summary
Type: string · Summarynullable
obligatoire
supported_parameters
Type: array string[] · Supported Parameters
obligatoire
trial_status
Type: string · Trial Status
obligatoire
updated_at
Type: string · Updated Atnullable
obligatoire
video_spec
Type: object · VideoSpecnullable
obligatoire
aspect_ratios
Type: array string[] | null · Aspect Ratiosnullable
audio
Type: object · AudioSpecnullable
input
Type: boolean · Inputnullable
output
Type: boolean · Outputnullable
output_optional
Type: boolean · Output Optionalnullable
constraints
Type: object · Constraintsnullable

Schéma JSON de données uniquement pour les combinaisons de requêtes valides

propertyName
Type: anything
duration_seconds
Type: object · DurationSpecnullable
max
Type: number · Max
supérieur à:
0
obligatoire
min
Type: number · Min
min.:
0
obligatoire
step
Type: number · Step
supérieur à:
0
obligatoire
example_request
Type: object · Example Requestnullable
propertyName
Type: anything
input_modes
Type: array string[] | null · Input Modesnullable
reference_limits
Type: object · Reference Limitsnullable
propertyName
nullable
Type: integer

Integer numbers.

request_defaults
Type: object · Request Defaultsnullable
propertyName
Type: anything
resolutions
Type: array string[] | null · Resolutionsnullable
channels
Type: array object[] · Channels
code
Type: string · Code
obligatoire
discount_multiplier
Type: string · Discount Multipliernullable
obligatoire

Multiplicateur commercial exact de 0 à 1 ; à appliquer une seule fois aux tarifs configurés ou au coût amont

is_default
Type: boolean · Is Default
obligatoire
name
Type: string · Name
obligatoire
region
Type: string · Regionnullable
obligatoire
runnable
Type: boolean · Runnable
obligatoire
service_tier
Type: string · Service Tier
obligatoire
standard_pricing
Type: object · CatalogPricingnullable
obligatoire

Tarifs unitaires standard avant remise commerciale ; null pour les canaux upstream_cost

basis
constante:
standard
obligatoire
billing_kind
Type: string · Billing Kind
obligatoire
channel
Type: string · Channel
obligatoire
currency
constante:
USD
obligatoire
tiers
Type: array object[] · Tiers
obligatoire

Conserve l'ordre ; le premier palier correspondant remplace les tarifs de base

conditions
Type: array object[] · Conditions
obligatoire
field
Type: string · Field
obligatoire

Contexte de tarification Felo, par exemple input_context_tokens

operator
Type: string · Operatorenum
obligatoire
valeurs
eq
gt
gte
value
obligatoire
Type: string · Value
overrides
Type: object · Overrides
obligatoire
propertyName
Type: string
audio
Type: string · Audionullable

USD par token audio d'entrée

completion
Type: string · Completionnullable

USD par token de sortie

credit
Type: string · Creditnullable

USD per credit; billed using the upstream call multiplier

input_audio_cache
Type: string · Input Audio Cachenullable

USD par token audio mis en cache

input_cache_read
Type: string · Input Cache Readnullable

USD par token d'entrée mis en cache

input_cache_write
Type: string · Input Cache Writenullable

USD par token écrit en cache

input_cache_write_12h
Type: string · Input Cache Write 12Hnullable

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

input_cache_write_1h
Type: string · Input Cache Write 1Hnullable

USD par token écrit dans le cache de 1 heure ; distinct des écritures avec la durée de vie par défaut

input_image
Type: string · Input Imagenullable

USD par image d'entrée

input_image_cache
Type: string · Input Image Cachenullable

USD per cached image token

input_image_token
Type: string · Input Image Tokennullable

USD par token d'image d'entrée

input_video_second
Type: string · Input Video Secondnullable

USD par seconde de vidéo d'entrée

internal_reasoning
Type: string · Internal Reasoningnullable

USD par token de raisonnement

output_image
Type: string · Output Imagenullable

USD par image générée

output_image_token
Type: string · Output Image Tokennullable

USD par token d'image de sortie

output_video_second
Type: string · Output Video Secondnullable

USD par seconde de vidéo générée

output_video_token
Type: string · Output Video Tokennullable

USD per generated video token

prompt
Type: string · Promptnullable

USD par token d'entrée ; null signifie indisponible, 0 signifie gratuit

request
Type: string · Requestnullable

USD par requête

web_search
Type: string · Web Searchnullable

USD par requête de recherche web

markup_multiplier
Type: string · Markup Multipliernullable

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

pricing_mode
Type: string · Pricing Modeenum

Tarifs unitaires configurés, ou coût média déclaré multiplié par la remise commerciale

valeurs
configured_rates
upstream_cost
reference_pricing
nullable

Public video reference before discount; not a final charge

as_of
Type: string · As Of
obligatoire
canonical_slug
Type: string · Canonical Slug
obligatoire
pricing_type
constante:
per_second
obligatoire
request_defaults
Type: object · Request Defaults
obligatoire
propertyName
Type: string
reservation
Type: object · VideoReservation
obligatoire
max_duration_seconds
Type: integer · Max Duration Seconds
supérieur à:
0
obligatoire

Integer numbers.

output_count
constante:
1

Integer numbers.

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

Integer numbers.

sale_pricing
Type: object · VideoSalePricingnullable

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

basis
constante:
sale_before_discount
obligatoire
currency
constante:
USD
obligatoire
rows
Type: array object[] · Rows
obligatoire

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
Type: object · Conditions
obligatoire

Equality-condition summary; predicates retain the complete rule semantics

propertyName
Type: anything
rates
Type: object · Rates
obligatoire

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

propertyName
Type: string
predicates
Type: array object[] | null · Predicatesnullable

Ordered rule predicates including range comparisons

field
Type: string · Field
obligatoire

Contexte de tarification Felo, par exemple input_context_tokens

operator
Type: string · Operatorenum
obligatoire
valeurs
eq
gt
gte
value
obligatoire
Type: string · Value
minimum_charge_usd
Type: string · Minimum Charge Usdnullable

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

selection
constante:
first_match

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

unit
Type: string · Unitnullable

Primary billing unit, e.g. output_video_second or video_token

second_pricing
Type: object · VideoSecondPricingnullable

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
constante:
sale_before_discount
obligatoire
currency
constante:
USD
obligatoire
rows
Type: array object[] · Rows
obligatoire
estimated
Type: boolean · Estimated
obligatoire

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

per_second_usd
Type: string · Per Second Usd
obligatoire

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

aspect_ratio
Type: string · Aspect Rationullable
generate_audio
Type: boolean · Generate Audionullable
input_image_usd
Type: string · Input Image Usdnullable

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

input_mode
Type: string · Input Modenullable
predicates
Type: array object[] | null · Predicatesnullable

Full conditions for this per-second price row

field
Type: string · Field
obligatoire

Contexte de tarification Felo, par exemple input_context_tokens

operator
Type: string · Operatorenum
obligatoire
valeurs
eq
gt
gte
value
obligatoire
Type: string · Value
resolution
Type: string · Resolutionnullable
second_basis
Type: string · Second Basisenum
obligatoire

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.

valeurs
exact
token_pixel_frames_estimate
pricing_type
Type: string · Pricing Typenullable

per_second or video_token

settlement_policy
Type: object · PublicSettlementPolicynullable

Published primary pricing and missing-usage fallback policy

fallback
Type: string · Fallbackenum
obligatoire
valeurs
upstream_cost
review_required
primary
constante:
configured_rates
obligatoire
version
constante:
1
obligatoire

Integer numbers.

default_channel
Type: string · Default Channelnullable
parameter_definitions
Type: 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
Type: object
propertyName
Type: anything
recommended_protocol
Type: string · Recommended Protocolenumnullable

Simple recommandation destinée aux clients, à l'échelle du modèle ; null pour les modèles non conversationnels ; ne restreint pas les protocoles appelables

valeurs
responses
messages
locale
Type: string · Localeenum
obligatoire
valeurs
en
zh-CN
zh-TW
ja
ko
schema_version
constante:
2
obligatoire

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

Afficher le schéma

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

Besoin d'aide ?