v0.4.0

OpenAPI 3.1.0

Ler o catálogo anônimo de modelos

Felo API Support

MIT

Servidor

https://openapi.felo.ai

Bibliotecas Cliente

Shell Curl

Ler o catálogo anônimo de modelos

Catálogo anônimo de modelos, schema_version=2. Os canais expõem pricing_mode, standard_pricing e discount_multiplier. Canais upstream_cost usam o custo de imagem ou vídeo reportado multiplicado pelo desconto congelado; o standard_pricing deles é null, não zero. default_channel identifica o código do canal padrão. recommended_protocol é uma recomendação de cliente para todo o modelo (responses/messages, null para modelos que não são de chat), não uma restrição de protocolo. Nenhuma configuração de protocolo ou metadado de playground é retornado. reasoning preserva o objeto JSON upstream, ou null quando indisponível.

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

Cabeçalhos

If-None-Match
Tipo: string

Respostas

200
Tipo: object · ModelCatalogResponse

Modelos visíveis; um id desconhecido exato retorna um array vazio.
data
Tipo: object · CatalogData
obrigatório
models
Tipo: array object[] · Models
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
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

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

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

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
default_channel
Tipo: string · Default Channelaceita nulo
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
total
Tipo: integer · Total
obrigatório

Integer numbers.

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

Representação inalterada; corpo vazio
400

Idioma não suportado
422

Projeção ou kind inválidos
503

Catálogo temporariamente indisponível

get/api/platform/model-catalog

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

Mostrar Schema

{
  "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 exemplo.",
        "description": "Texto ilustrativo, não é um 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 visíveis; um id desconhecido exato retorna um array vazio.