v0.4.0

OpenAPI 3.1.0

Read the anonymous model catalog

Felo API Support

MIT

服务器

https://openapi.felo.ai

客户端库

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.

查询参数

locale
类型: string 枚举
值
- en
- zh-CN
- zh-TW
- ja
- ko
- ru
q
类型: string
id
类型: string
model_kind
类型: string 枚举
值
- chat
- image_generation
- video_generation
- decisions
fmt
类型: string 枚举
值
- cards
- full

请求头

If-None-Match
类型: string

响应

200
类型: object · ModelCatalogResponse

Visible models; exact unknown id returns an empty array.
data
类型: object · CatalogData
必填
models
类型: array object[] · Models
必填
author
类型: string · Author可为 null
必填
author_display_name
类型: string · Author Display Name可为 null
必填
available_content_locales
类型: array string[] · Available Content Locales枚举
必填
值
en
zh-CN
zh-TW
ja
ko
ru
best_for
类型: array string[] · Best For
必填
capabilities
类型: array string[] · Capabilities
必填
content_locale
类型: string · Content Locale枚举可为 null
必填
值
en
zh-CN
zh-TW
ja
ko
ru
context_length
类型: integer · Context Length可为 null
必填

Integer numbers.

description
类型: string · Description可为 null
必填
document
类型: object · PublicDocument可为 null
必填

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

extra
类型: object · Extra
必填
propertyName
类型: anything
notice
类型: object · CatalogNotice可为 null
必填
body
类型: string · Body
必填
link_text
类型: string · Link Text可为 null
必填
target_slug
类型: string · Target Slug可为 null
必填
title
类型: string · Title可为 null
必填
updated_at
类型: string · Updated At
必填

Selected language document update time

icon_url
类型: string · Icon Url可为 null
必填
id
类型: string · Id
必填
input_modalities
类型: array string[] · Input Modalities
必填
latency_class
类型: string · Latency Class可为 null
必填
max_completion_tokens
类型: integer · Max Completion Tokens可为 null
必填

Integer numbers.

model_kind
类型: string · Model Kind枚举
必填
值
chat
image_generation
video_generation
decisions
name
类型: string · Name
必填
output_modalities
类型: array string[] · Output Modalities
必填
reasoning
类型: object · Reasoning可为 null
必填

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

propertyName
类型: anything
released_at
类型: string · Released At可为 null
必填
short_name
类型: string · Short Name
必填
slug
类型: string · Slug
必填
sort_order
类型: integer · Sort Order
必填

Integer numbers.

summary
类型: string · Summary可为 null
必填
supported_parameters
类型: array string[] · Supported Parameters
必填
trial_status
类型: string · Trial Status
必填
updated_at
类型: string · Updated At可为 null
必填
video_spec
类型: object · VideoSpec可为 null
必填
aspect_ratios
类型: array string[] | null · Aspect Ratios可为 null
audio
类型: object · AudioSpec可为 null
input
类型: boolean · Input可为 null
output
类型: boolean · Output可为 null
output_optional
类型: boolean · Output Optional可为 null
constraints
类型: object · Constraints可为 null

Data-only JSON Schema for valid request combinations

propertyName
类型: anything
duration_seconds
类型: object · DurationSpec可为 null
max
类型: number · Max
大于:
0
必填
min
类型: number · Min
最小值:
0
必填
step
类型: number · Step
大于:
0
必填
example_request
类型: object · Example Request可为 null
propertyName
类型: anything
input_modes
类型: array string[] | null · Input Modes可为 null
reference_limits
类型: object · Reference Limits可为 null
propertyName
可为 null
类型: integer

Integer numbers.

request_defaults
类型: object · Request Defaults可为 null
propertyName
类型: anything
resolutions
类型: array string[] | null · Resolutions可为 null
channels
类型: array object[] · Channels
code
类型: string · Code
必填
discount_multiplier
类型: string · Discount Multiplier可为 null
必填

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

is_default
类型: boolean · Is Default
必填
name
类型: string · Name
必填
region
类型: string · Region可为 null
必填
runnable
类型: boolean · Runnable
必填
service_tier
类型: string · Service Tier
必填
standard_pricing
类型: object · CatalogPricing可为 null
必填

Standard unit rates before sales discount; null for upstream_cost channels

basis
常量:
standard
必填
billing_kind
类型: string · Billing Kind
必填
channel
类型: string · Channel
必填
currency
常量:
USD
必填
tiers
类型: array object[] · Tiers
必填

Preserve order; first matching tier overrides base rates

conditions
类型: array object[] · Conditions
必填
field
类型: string · Field
必填

Felo pricing context, e.g. input_context_tokens

operator
类型: string · Operator枚举
必填
值
eq
gt
gte
value
必填
类型: string · Value
overrides
类型: object · Overrides
必填
propertyName
类型: string
audio
类型: string · Audio可为 null

USD per input audio token

completion
类型: string · Completion可为 null

USD per output token

input_audio_cache
类型: string · Input Audio Cache可为 null

USD per cached audio token

input_cache_read
类型: string · Input Cache Read可为 null

USD per cached input token

input_cache_write
类型: string · Input Cache Write可为 null

USD per cache write token

input_cache_write_1h
类型: string · Input Cache Write 1H可为 null

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

input_image
类型: string · Input Image可为 null

USD per input image

input_video_second
类型: string · Input Video Second可为 null

USD per input video second

internal_reasoning
类型: string · Internal Reasoning可为 null

USD per reasoning token

output_image
类型: string · Output Image可为 null

USD per generated image

output_video_second
类型: string · Output Video Second可为 null

USD per generated video second

prompt
类型: string · Prompt可为 null

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

request
类型: string · Request可为 null

USD per request

web_search
类型: string · Web Search可为 null

USD per web search request

pricing_mode
类型: string · Pricing Mode枚举

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

值
configured_rates
upstream_cost
default_channel
类型: string · Default Channel可为 null
recommended_protocol
类型: string · Recommended Protocol枚举可为 null

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

值
responses
messages
total
类型: integer · Total
必填

Integer numbers.

locale
类型: string · Locale枚举
必填
值
en
zh-CN
zh-TW
ja
ko
ru
schema_version
常量:
2
必填

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

显示 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.