v0.4.0

OpenAPI 3.1.0

Leer el catálogo anónimo de modelos

Felo API Support

MIT

Servidor

https://openapi.felo.ai

Bibliotecas cliente

Shell Curl

Leer el catálogo anónimo de modelos

Catálogo anónimo de modelos, schema_version=2. Los canales exponen pricing_mode, standard_pricing y discount_multiplier. Los canales upstream_cost usan el costo de imagen o vídeo reportado multiplicado por el descuento congelado; su standard_pricing es null, no cero. default_channel identifica el código del canal predeterminado. recommended_protocol es una recomendación para el cliente a nivel de modelo (responses/messages, null en modelos que no son de chat), no una restricción de protocolo. No se devuelve configuración de protocolo ni metadatos de playground. reasoning conserva el objeto JSON del upstream, o null cuando no está disponible.

Parámetros de consulta

locale
Tipo: string enum
valores
- en
- zh-CN
- zh-TW
- ja
- ko
q
Tipo: string
id
Tipo: string
model_kind
Tipo: string enum
valores
- chat
- image_generation
- video_generation
- decisions
fmt
Tipo: string enum
valores
- cards
- full

Encabezados

If-None-Match
Tipo: string

Respuestas

200
Tipo: object · ModelCatalogResponse

Modelos visibles; un id desconocido exacto devuelve un array vacío.
data
Tipo: object · CatalogData
obligatorio
models
Tipo: array object[] · Models
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
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

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_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_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

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

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
default_channel
Tipo: string · Default Channeladmite null
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
total
Tipo: integer · Total
obligatorio

Integer numbers.

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

Integer numbers.
application/json
304

Representación sin cambios; cuerpo vacío
400

Idioma no compatible
422

Proyección o tipo no válidos
503

Catálogo no disponible temporalmente

get/api/platform/model-catalog

curl https://openapi.felo.ai/api/platform/model-catalog

Mostrar esquema

{
  "schema_version": 2,
  "locale": "en",
  "data": {
    "total": 1,
    "models": [
      {
        "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": "Modelo de ejemplo.",
        "description": "Texto ilustrativo, no es un modelo real.",
        "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",
              "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"
          }
        ]
      }
    ]
  }
}

Modelos visibles; un id desconocido exacto devuelve un array vacío.