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
longitud mín.:
1
longitud máx.:
256
obligatorio

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

Encabezados

If-None-Match
Tipo: string

Previous ETag; matching content returns 304

Respuestas

200
Tipo: object · ModelCatalogModelResponse

Public model details
data
Tipo: object · CatalogModel
obligatorio
author
Tipo: string · Authoradmite null
obligatorio
author_display_name
Tipo: string · Author Display Nameadmite null
obligatorio
available_content_locales
Tipo: array string[] · Available Content Localesenum
obligatorio
valores
en
zh-CN
zh-TW
ja
ko
best_for
Tipo: array string[] · Best For
obligatorio
capabilities
Tipo: array string[] · Capabilities
obligatorio
content_locale
Tipo: string · Content Localeenumadmite null
obligatorio
valores
en
zh-CN
zh-TW
ja
ko
context_length
Tipo: integer · Context Lengthadmite null
obligatorio

Integer numbers.

description
Tipo: string · Descriptionadmite null
obligatorio
document
Tipo: object · PublicDocumentadmite null
obligatorio

Solo en el idioma seleccionado; summary/description/best_for permanecen en el modelo

extra
Tipo: object · Extra
obligatorio
propertyName
Tipo: anything
notice
Tipo: object · CatalogNoticeadmite null
obligatorio
body
Tipo: string · Body
obligatorio
link_text
Tipo: string · Link Textadmite null
obligatorio
target_slug
Tipo: string · Target Slugadmite null
obligatorio
title
Tipo: string · Titleadmite null
obligatorio
updated_at
Tipo: string · Updated At
obligatorio

Hora de actualización del documento en el idioma seleccionado

icon_url
Tipo: string · Icon Urladmite null
obligatorio
id
Tipo: string · Id
obligatorio
input_modalities
Tipo: array string[] · Input Modalities
obligatorio
latency_class
Tipo: string · Latency Classadmite null
obligatorio
max_completion_tokens
Tipo: integer · Max Completion Tokensadmite null
obligatorio

Integer numbers.

model_kind
Tipo: string · Model Kindenum
obligatorio
valores
chat
image_generation
video_generation
decisions
name
Tipo: string · Name
obligatorio
output_modalities
Tipo: array string[] · Output Modalities
obligatorio
reasoning
Tipo: object · Reasoningadmite null
obligatorio

Objeto JSON de razonamiento del upstream; conserva los campos desconocidos; null si no está disponible

propertyName
Tipo: anything
released_at
Tipo: string · Released Atadmite null
obligatorio

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

Integer numbers.

summary
Tipo: string · Summaryadmite null
obligatorio
supported_parameters
Tipo: array string[] · Supported Parameters
obligatorio
trial_status
Tipo: string · Trial Status
obligatorio
updated_at
Tipo: string · Updated Atadmite null
obligatorio
video_spec
Tipo: object · VideoSpecadmite null
obligatorio
aspect_ratios
Tipo: array string[] | null · Aspect Ratiosadmite null
audio
Tipo: object · AudioSpecadmite null
input
Tipo: boolean · Inputadmite null
output
Tipo: boolean · Outputadmite null
output_optional
Tipo: boolean · Output Optionaladmite null
constraints
Tipo: object · Constraintsadmite null

Esquema JSON solo de datos para combinaciones de solicitud válidas

propertyName
Tipo: anything
duration_seconds
Tipo: object · DurationSpecadmite null
max
Tipo: number · Max
mayor que:
0
obligatorio
min
Tipo: number · Min
mín.:
0
obligatorio
step
Tipo: number · Step
mayor que:
0
obligatorio
example_request
Tipo: object · Example Requestadmite null
propertyName
Tipo: anything
input_modes
Tipo: array string[] | null · Input Modesadmite null
reference_limits
Tipo: object · Reference Limitsadmite null
propertyName
admite null
Tipo: integer

Integer numbers.

request_defaults
Tipo: object · Request Defaultsadmite null
propertyName
Tipo: anything
resolutions
Tipo: array string[] | null · Resolutionsadmite null
channels
Tipo: array object[] · Channels
code
Tipo: string · Code
obligatorio
discount_multiplier
Tipo: string · Discount Multiplieradmite null
obligatorio

Multiplicador de venta exacto de 0 a 1; se aplica una vez a las tarifas configuradas o al costo upstream

is_default
Tipo: boolean · Is Default
obligatorio
name
Tipo: string · Name
obligatorio
region
Tipo: string · Regionadmite null
obligatorio
runnable
Tipo: boolean · Runnable
obligatorio
service_tier
Tipo: string · Service Tier
obligatorio
standard_pricing
Tipo: object · CatalogPricingadmite null
obligatorio

Tarifas unitarias estándar antes del descuento de venta; null en los canales upstream_cost

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

Conserva el orden; el primer nivel coincidente sustituye las tarifas base

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

Contexto de precios de Felo, por ejemplo input_context_tokens

operator
Tipo: string · Operatorenum
obligatorio
valores
eq
gt
gte
value
obligatorio
Tipo: string · Value
overrides
Tipo: object · Overrides
obligatorio
propertyName
Tipo: string
audio
Tipo: string · Audioadmite null

USD por token de audio de entrada

completion
Tipo: string · Completionadmite null

USD por token de salida

credit
Tipo: string · Creditadmite null

USD per credit; billed using the upstream call multiplier

input_audio_cache
Tipo: string · Input Audio Cacheadmite null

USD por token de audio en caché

input_cache_read
Tipo: string · Input Cache Readadmite null

USD por token de entrada en caché

input_cache_write
Tipo: string · Input Cache Writeadmite null

USD por token de escritura de caché

input_cache_write_12h
Tipo: string · Input Cache Write 12Hadmite null

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

input_cache_write_1h
Tipo: string · Input Cache Write 1Hadmite null

USD por token de escritura de caché de 1 hora; independiente de las escrituras con el TTL predeterminado

input_image
Tipo: string · Input Imageadmite null

USD por imagen de entrada

input_image_cache
Tipo: string · Input Image Cacheadmite null

USD per cached image token

input_image_token
Tipo: string · Input Image Tokenadmite null

USD por token de imagen de entrada

input_video_second
Tipo: string · Input Video Secondadmite null

USD por segundo de vídeo de entrada

internal_reasoning
Tipo: string · Internal Reasoningadmite null

USD por token de razonamiento

output_image
Tipo: string · Output Imageadmite null

USD por imagen generada

output_image_token
Tipo: string · Output Image Tokenadmite null

USD por token de imagen de salida

output_video_second
Tipo: string · Output Video Secondadmite null

USD por segundo de vídeo generado

output_video_token
Tipo: string · Output Video Tokenadmite null

USD per generated video token

prompt
Tipo: string · Promptadmite null

USD por token de entrada; null significa no disponible, 0 significa gratis

request
Tipo: string · Requestadmite null

USD por solicitud

web_search
Tipo: string · Web Searchadmite null

USD por solicitud de búsqueda web

markup_multiplier
Tipo: string · Markup Multiplieradmite 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

Tarifas unitarias configuradas, o el costo de medio reportado multiplicado por el descuento de venta

valores
configured_rates
upstream_cost
reference_pricing
admite null

Public video reference before discount; not a final charge

as_of
Tipo: string · As Of
obligatorio
canonical_slug
Tipo: string · Canonical Slug
obligatorio
pricing_type
constante:
per_second
obligatorio
request_defaults
Tipo: object · Request Defaults
obligatorio
propertyName
Tipo: string
reservation
Tipo: object · VideoReservation
obligatorio
max_duration_seconds
Tipo: integer · Max Duration Seconds
mayor que:
0
obligatorio

Integer numbers.

output_count
constante:
1

Integer numbers.

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

Integer numbers.

sale_pricing
Tipo: object · VideoSalePricingadmite null

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

basis
constante:
sale_before_discount
obligatorio
currency
constante:
USD
obligatorio
rows
Tipo: array object[] · Rows
obligatorio

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
obligatorio

Equality-condition summary; predicates retain the complete rule semantics

propertyName
Tipo: anything
rates
Tipo: object · Rates
obligatorio

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

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

Ordered rule predicates including range comparisons

field
Tipo: string · Field
obligatorio

Contexto de precios de Felo, por ejemplo input_context_tokens

operator
Tipo: string · Operatorenum
obligatorio
valores
eq
gt
gte
value
obligatorio
Tipo: string · Value
minimum_charge_usd
Tipo: string · Minimum Charge Usdadmite null

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
Tipo: string · Unitadmite null

Primary billing unit, e.g. output_video_second or video_token

second_pricing
Tipo: object · VideoSecondPricingadmite 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
constante:
sale_before_discount
obligatorio
currency
constante:
USD
obligatorio
rows
Tipo: array object[] · Rows
obligatorio
estimated
Tipo: boolean · Estimated
obligatorio

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

per_second_usd
Tipo: string · Per Second Usd
obligatorio

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

aspect_ratio
Tipo: string · Aspect Ratioadmite null
generate_audio
Tipo: boolean · Generate Audioadmite null
input_image_usd
Tipo: string · Input Image Usdadmite null

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

input_mode
Tipo: string · Input Modeadmite null
predicates
Tipo: array object[] | null · Predicatesadmite null

Full conditions for this per-second price row

field
Tipo: string · Field
obligatorio

Contexto de precios de Felo, por ejemplo input_context_tokens

operator
Tipo: string · Operatorenum
obligatorio
valores
eq
gt
gte
value
obligatorio
Tipo: string · Value
resolution
Tipo: string · Resolutionadmite null
second_basis
Tipo: string · Second Basisenum
obligatorio

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

per_second or video_token

settlement_policy
Tipo: object · PublicSettlementPolicyadmite null

Published primary pricing and missing-usage fallback policy

fallback
Tipo: string · Fallbackenum
obligatorio
valores
upstream_cost
review_required
primary
constante:
configured_rates
obligatorio
version
constante:
1
obligatorio

Integer numbers.

default_channel
Tipo: string · Default Channeladmite 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 Protocolenumadmite null

Solo recomendación para el cliente a nivel de modelo; null en modelos que no son de chat; no restringe los protocolos que se pueden llamar

valores
responses
messages
locale
Tipo: string · Localeenum
obligatorio
valores
en
zh-CN
zh-TW
ja
ko
schema_version
constante:
2
obligatorio

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 esquema

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

¿Necesitas ayuda?