v0.4.0

OpenAPI 3.1.0

Get a public model by name

Felo API Support

MIT

Servidor

https://openapi.felo.ai

Bibliotecas Cliente

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.

Parâmetros de Consulta

model
Tipo: string
tamanho mínimo:
1
tamanho máximo:
256
obrigatório

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

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

Cabeçalhos

If-None-Match
Tipo: string

Previous ETag; matching content returns 304

Respostas

200
Tipo: object · ModelCatalogModelResponse

Public model details
data
Tipo: object · CatalogModel
obrigatório
author
Tipo: string · Authoraceita nulo
obrigatório
author_display_name
Tipo: string · Author Display Nameaceita nulo
obrigatório
available_content_locales
Tipo: array string[] · Available Content Localesenum
obrigatório
valores
en
zh-CN
zh-TW
ja
ko
best_for
Tipo: array string[] · Best For
obrigatório
capabilities
Tipo: array string[] · Capabilities
obrigatório
content_locale
Tipo: string · Content Localeenumaceita nulo
obrigatório
valores
en
zh-CN
zh-TW
ja
ko
context_length
Tipo: integer · Context Lengthaceita nulo
obrigatório

Integer numbers.

description
Tipo: string · Descriptionaceita nulo
obrigatório
document
Tipo: object · PublicDocumentaceita nulo
obrigatório

Somente o idioma selecionado; summary/description/best_for permanecem no modelo

extra
Tipo: object · Extra
obrigatório
propertyName
Tipo: anything
notice
Tipo: object · CatalogNoticeaceita nulo
obrigatório
body
Tipo: string · Body
obrigatório
link_text
Tipo: string · Link Textaceita nulo
obrigatório
target_slug
Tipo: string · Target Slugaceita nulo
obrigatório
title
Tipo: string · Titleaceita nulo
obrigatório
updated_at
Tipo: string · Updated At
obrigatório

Horário de atualização do documento no idioma selecionado

icon_url
Tipo: string · Icon Urlaceita nulo
obrigatório
id
Tipo: string · Id
obrigatório
input_modalities
Tipo: array string[] · Input Modalities
obrigatório
latency_class
Tipo: string · Latency Classaceita nulo
obrigatório
max_completion_tokens
Tipo: integer · Max Completion Tokensaceita nulo
obrigatório

Integer numbers.

model_kind
Tipo: string · Model Kindenum
obrigatório
valores
chat
image_generation
video_generation
decisions
name
Tipo: string · Name
obrigatório
output_modalities
Tipo: array string[] · Output Modalities
obrigatório
reasoning
Tipo: object · Reasoningaceita nulo
obrigatório

Objeto JSON de reasoning do upstream; preserva campos desconhecidos; null se indisponível

propertyName
Tipo: anything
released_at
Tipo: string · Released Ataceita nulo
obrigatório

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
obrigatório
slug
Tipo: string · Slug
obrigatório
sort_order
Tipo: integer · Sort Order
obrigatório

Integer numbers.

summary
Tipo: string · Summaryaceita nulo
obrigatório
supported_parameters
Tipo: array string[] · Supported Parameters
obrigatório
trial_status
Tipo: string · Trial Status
obrigatório
updated_at
Tipo: string · Updated Ataceita nulo
obrigatório
video_spec
Tipo: object · VideoSpecaceita nulo
obrigatório
aspect_ratios
Tipo: array string[] | null · Aspect Ratiosaceita nulo
audio
Tipo: object · AudioSpecaceita nulo
input
Tipo: boolean · Inputaceita nulo
output
Tipo: boolean · Outputaceita nulo
output_optional
Tipo: boolean · Output Optionalaceita nulo
constraints
Tipo: object · Constraintsaceita nulo

JSON Schema somente de dados para combinações de requisição válidas

propertyName
Tipo: anything
duration_seconds
Tipo: object · DurationSpecaceita nulo
max
Tipo: number · Max
maior que:
0
obrigatório
min
Tipo: number · Min
mín:
0
obrigatório
step
Tipo: number · Step
maior que:
0
obrigatório
example_request
Tipo: object · Example Requestaceita nulo
propertyName
Tipo: anything
input_modes
Tipo: array string[] | null · Input Modesaceita nulo
reference_limits
Tipo: object · Reference Limitsaceita nulo
propertyName
aceita nulo
Tipo: integer

Integer numbers.

request_defaults
Tipo: object · Request Defaultsaceita nulo
propertyName
Tipo: anything
resolutions
Tipo: array string[] | null · Resolutionsaceita nulo
channels
Tipo: array object[] · Channels
code
Tipo: string · Code
obrigatório
discount_multiplier
Tipo: string · Discount Multiplieraceita nulo
obrigatório

Multiplicador comercial exato de 0 a 1; aplique uma vez às tarifas configuradas ou ao custo upstream

is_default
Tipo: boolean · Is Default
obrigatório
name
Tipo: string · Name
obrigatório
region
Tipo: string · Regionaceita nulo
obrigatório
runnable
Tipo: boolean · Runnable
obrigatório
service_tier
Tipo: string · Service Tier
obrigatório
standard_pricing
Tipo: object · CatalogPricingaceita nulo
obrigatório

Tarifas unitárias padrão antes do desconto comercial; null para canais upstream_cost

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

Preserve a ordem; a primeira faixa correspondente substitui as tarifas base

conditions
Tipo: array object[] · Conditions
obrigatório
field
Tipo: string · Field
obrigatório

Contexto de preço da Felo, por exemplo input_context_tokens

operator
Tipo: string · Operatorenum
obrigatório
valores
eq
gt
gte
value
obrigatório
Tipo: string · Value
overrides
Tipo: object · Overrides
obrigatório
propertyName
Tipo: string
audio
Tipo: string · Audioaceita nulo

USD por token de áudio de entrada

completion
Tipo: string · Completionaceita nulo

USD por token de saída

credit
Tipo: string · Creditaceita nulo

USD per credit; billed using the upstream call multiplier

input_audio_cache
Tipo: string · Input Audio Cacheaceita nulo

USD por token de áudio em cache

input_cache_read
Tipo: string · Input Cache Readaceita nulo

USD por token de entrada em cache

input_cache_write
Tipo: string · Input Cache Writeaceita nulo

USD por token de gravação em cache

input_cache_write_12h
Tipo: string · Input Cache Write 12Haceita nulo

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

input_cache_write_1h
Tipo: string · Input Cache Write 1Haceita nulo

USD por token de gravação em cache de 1 hora; separado das gravações com TTL padrão

input_image
Tipo: string · Input Imageaceita nulo

USD por imagem de entrada

input_image_cache
Tipo: string · Input Image Cacheaceita nulo

USD per cached image token

input_image_token
Tipo: string · Input Image Tokenaceita nulo

USD por token de imagem de entrada

input_video_second
Tipo: string · Input Video Secondaceita nulo

USD por segundo de vídeo de entrada

internal_reasoning
Tipo: string · Internal Reasoningaceita nulo

USD por token de reasoning

output_image
Tipo: string · Output Imageaceita nulo

USD por imagem gerada

output_image_token
Tipo: string · Output Image Tokenaceita nulo

USD por token de imagem de saída

output_video_second
Tipo: string · Output Video Secondaceita nulo

USD por segundo de vídeo gerado

output_video_token
Tipo: string · Output Video Tokenaceita nulo

USD per generated video token

prompt
Tipo: string · Promptaceita nulo

USD por token de entrada; null significa indisponível, 0 significa gratuito

request
Tipo: string · Requestaceita nulo

USD por requisição

web_search
Tipo: string · Web Searchaceita nulo

USD por requisição de pesquisa na web

markup_multiplier
Tipo: string · Markup Multiplieraceita nulo

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

Tarifas unitárias configuradas, ou o custo de mídia reportado multiplicado pelo desconto comercial

valores
configured_rates
upstream_cost
reference_pricing
aceita nulo

Public video reference before discount; not a final charge

as_of
Tipo: string · As Of
obrigatório
canonical_slug
Tipo: string · Canonical Slug
obrigatório
pricing_type
const:
per_second
obrigatório
request_defaults
Tipo: object · Request Defaults
obrigatório
propertyName
Tipo: string
reservation
Tipo: object · VideoReservation
obrigatório
max_duration_seconds
Tipo: integer · Max Duration Seconds
maior que:
0
obrigatório

Integer numbers.

output_count
const:
1

Integer numbers.

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

Integer numbers.

sale_pricing
Tipo: object · VideoSalePricingaceita nulo

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

basis
const:
sale_before_discount
obrigatório
currency
const:
USD
obrigatório
rows
Tipo: array object[] · Rows
obrigatório

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
obrigatório

Equality-condition summary; predicates retain the complete rule semantics

propertyName
Tipo: anything
rates
Tipo: object · Rates
obrigatório

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

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

Ordered rule predicates including range comparisons

field
Tipo: string · Field
obrigatório

Contexto de preço da Felo, por exemplo input_context_tokens

operator
Tipo: string · Operatorenum
obrigatório
valores
eq
gt
gte
value
obrigatório
Tipo: string · Value
minimum_charge_usd
Tipo: string · Minimum Charge Usdaceita nulo

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 · Unitaceita nulo

Primary billing unit, e.g. output_video_second or video_token

second_pricing
Tipo: object · VideoSecondPricingaceita nulo

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
obrigatório
currency
const:
USD
obrigatório
rows
Tipo: array object[] · Rows
obrigatório
estimated
Tipo: boolean · Estimated
obrigatório

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

per_second_usd
Tipo: string · Per Second Usd
obrigatório

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

aspect_ratio
Tipo: string · Aspect Ratioaceita nulo
generate_audio
Tipo: boolean · Generate Audioaceita nulo
input_image_usd
Tipo: string · Input Image Usdaceita nulo

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

input_mode
Tipo: string · Input Modeaceita nulo
predicates
Tipo: array object[] | null · Predicatesaceita nulo

Full conditions for this per-second price row

field
Tipo: string · Field
obrigatório

Contexto de preço da Felo, por exemplo input_context_tokens

operator
Tipo: string · Operatorenum
obrigatório
valores
eq
gt
gte
value
obrigatório
Tipo: string · Value
resolution
Tipo: string · Resolutionaceita nulo
second_basis
Tipo: string · Second Basisenum
obrigatório

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.

valores
exact
token_pixel_frames_estimate
pricing_type
Tipo: string · Pricing Typeaceita nulo

per_second or video_token

settlement_policy
Tipo: object · PublicSettlementPolicyaceita nulo

Published primary pricing and missing-usage fallback policy

fallback
Tipo: string · Fallbackenum
obrigatório
valores
upstream_cost
review_required
primary
const:
configured_rates
obrigatório
version
const:
1
obrigatório

Integer numbers.

default_channel
Tipo: string · Default Channelaceita nulo
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 Protocolenumaceita nulo

Apenas uma recomendação de cliente para todo o modelo; null para modelos que não são de chat; não restringe os protocolos chamáveis

valores
responses
messages
locale
Tipo: string · Localeenum
obrigatório
valores
en
zh-CN
zh-TW
ja
ko
schema_version
const:
2
obrigatório

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

Mostrar 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

Precisa de ajuda?