v0.4.0

OpenAPI 3.1.0

Read the anonymous model catalog

Felo API Support

MIT

Server

https://openapi.felo.ai

Client Libraries

Shell Curl

Read the anonymous model catalog

Anonymous model catalog, schema_version=2. Channels expose pricing_mode, standard_pricing and discount_multiplier. upstream_cost channels use reported video cost times the frozen discount; their standard_pricing is null, not zero. default_channel identifies the default channel code. recommended_protocol is a model-wide client recommendation (responses/messages, null for non-chat models), not a protocol restriction. No protocol configuration or playground metadata is returned. reasoning preserves the upstream JSON object, or null when unavailable.

Query Parameters

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

Headers

If-None-Match
Type: string

Responses

200
Type: object · ModelCatalogResponse

Visible models; exact unknown id returns an empty array.
data
Type: object · CatalogData
required
models
Type: array object[] · Models
required
author
Type: string · Authornullable
required
author_display_name
Type: string · Author Display Namenullable
required
available_content_locales
Type: array string[] · Available Content Localesenum
required
values
en
zh-CN
zh-TW
ja
ko
ru
best_for
Type: array string[] · Best For
required
capabilities
Type: array string[] · Capabilities
required
content_locale
Type: string · Content Localeenumnullable
required
values
en
zh-CN
zh-TW
ja
ko
ru
context_length
Type: integer · Context Lengthnullable
required

Integer numbers.

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

Selected language only; summary/description/best_for stay on the model

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

Selected language document update time

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

Integer numbers.

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

Upstream reasoning JSON object; preserves unknown fields; null if unavailable

propertyName
Type: anything
released_at
Type: string · Released Atnullable
required
short_name
Type: string · Short Name
required
slug
Type: string · Slug
required
sort_order
Type: integer · Sort Order
required

Integer numbers.

summary
Type: string · Summarynullable
required
supported_parameters
Type: array string[] · Supported Parameters
required
trial_status
Type: string · Trial Status
required
updated_at
Type: string · Updated Atnullable
required
video_spec
Type: object · VideoSpecnullable
required
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

Data-only JSON Schema for valid request combinations

propertyName
Type: anything
duration_seconds
Type: object · DurationSpecnullable
max
Type: number · Max
greater than:
0
required
min
Type: number · Min
min:
0
required
step
Type: number · Step
greater than:
0
required
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
required
discount_multiplier
Type: string · Discount Multipliernullable
required

Exact sales multiplier from 0 to 1; apply once to configured rates or upstream cost

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

Standard unit rates before sales discount; null for upstream_cost channels

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

Preserve order; first matching tier overrides base rates

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

Felo pricing context, e.g. input_context_tokens

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

USD per input audio token

completion
Type: string · Completionnullable

USD per output token

input_audio_cache
Type: string · Input Audio Cachenullable

USD per cached audio token

input_cache_read
Type: string · Input Cache Readnullable

USD per cached input token

input_cache_write
Type: string · Input Cache Writenullable

USD per cache write token

input_cache_write_1h
Type: string · Input Cache Write 1Hnullable

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

input_image
Type: string · Input Imagenullable

USD per input image

input_video_second
Type: string · Input Video Secondnullable

USD per input video second

internal_reasoning
Type: string · Internal Reasoningnullable

USD per reasoning token

output_image
Type: string · Output Imagenullable

USD per generated image

output_video_second
Type: string · Output Video Secondnullable

USD per generated video second

prompt
Type: string · Promptnullable

USD per input token; null means unavailable, 0 means free

request
Type: string · Requestnullable

USD per request

web_search
Type: string · Web Searchnullable

USD per web search request

pricing_mode
Type: string · Pricing Modeenum

Configured unit rates, or reported video cost times the sales discount

values
configured_rates
upstream_cost
default_channel
Type: string · Default Channelnullable
recommended_protocol
Type: string · Recommended Protocolenumnullable

Model-wide client recommendation only; null for non-chat models; does not restrict callable protocols

values
responses
messages
total
Type: integer · Total
required

Integer numbers.

locale
Type: string · Localeenum
required
values
en
zh-CN
zh-TW
ja
ko
ru
schema_version
const:
2
required

Integer numbers.
application/json
304

Unchanged representation; empty body
400

Unsupported locale
422

Invalid projection or kind
503

Catalog temporarily unavailable

get/api/platform/model-catalog

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

Show 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": "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",
              "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"
          }
        ]
      }
    ]
  }
}

Visible models; exact unknown id returns an empty array.