v0.4.0

OpenAPI 3.1.0

Get a public model by name

Felo API Support

MIT

服务器

https://openapi.felo.ai

客户端库

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.

查询参数

model
类型: string
最小长度:
1
最大长度:
256
必填

Exact case-sensitive public model name or registered alias
locale
类型: string 枚举

Document language; falls back to English when unavailable
值
- en
- zh-CN
- zh-TW
- ja
- ko

请求头

If-None-Match
类型: string

Previous ETag; matching content returns 304

响应

200
类型: object · ModelCatalogModelResponse

Public model details
data
类型: object · CatalogModel
必填
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
best_for
类型: array string[] · Best For
必填
capabilities
类型: array string[] · Capabilities
必填
content_locale
类型: string · Content Locale枚举可为 null
必填
值
en
zh-CN
zh-TW
ja
ko
context_length
类型: integer · Context Length可为 null
必填

Integer numbers.

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

仅为所选语言；summary/description/best_for 保留在模型上

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
必填

所选语言的文档更新时间

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
必填

上游 reasoning JSON 对象；保留未知字段；不可用时为 null

propertyName
类型: anything
released_at
类型: string · Released At可为 null
必填

Model release date in ISO 8601 UTC; may use the OpenRouter listing time. Manual overrides take precedence; null means unknown.

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

纯数据用途的 JSON Schema，用于描述有效的请求组合

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
必填

0 到 1 之间的精确销售倍率；对已配置费率或上游成本只应用一次

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
必填

销售折扣前的标准单位费率；upstream_cost 通道为 null

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

保持顺序；第一个匹配的阶梯覆盖基础费率

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

Felo 定价上下文，例如 input_context_tokens

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

每输入音频 token 的美元价格

completion
类型: string · Completion可为 null

每输出 token 的美元价格

credit
类型: string · Credit可为 null

USD per credit; billed using the upstream call multiplier

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

每缓存音频 token 的美元价格

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

每缓存输入 token 的美元价格

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

每缓存写入 token 的美元价格

input_cache_write_12h
类型: string · Input Cache Write 12H可为 null

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

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

每 1 小时缓存写入 token 的美元价格；与默认 TTL 写入分开计费

input_image
类型: string · Input Image可为 null

每输入图像的美元价格

input_image_cache
类型: string · Input Image Cache可为 null

USD per cached image token

input_image_token
类型: string · Input Image Token可为 null

每输入图像 token 的美元价格

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

每输入视频秒的美元价格

internal_reasoning
类型: string · Internal Reasoning可为 null

每推理 token 的美元价格

output_image
类型: string · Output Image可为 null

每生成图像的美元价格

output_image_token
类型: string · Output Image Token可为 null

每输出图像 token 的美元价格

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

每生成视频秒的美元价格

output_video_token
类型: string · Output Video Token可为 null

USD per generated video token

prompt
类型: string · Prompt可为 null

每输入 token 的美元价格；null 表示不可用，0 表示免费

request
类型: string · Request可为 null

每次请求的美元价格

web_search
类型: string · Web Search可为 null

每次网络搜索请求的美元价格

markup_multiplier
类型: string · Markup Multiplier可为 null

Sale markup (>= 1) applied to the purchase price or upstream cost to form the sale price, before discount_multiplier

pricing_mode
类型: string · Pricing Mode枚举

已配置的单位费率，或上报的媒体成本乘以销售折扣

值
configured_rates
upstream_cost
reference_pricing
可为 null

Public video reference before discount; not a final charge

as_of
类型: string · As Of
必填
canonical_slug
类型: string · Canonical Slug
必填
pricing_type
常量:
per_second
必填
request_defaults
类型: object · Request Defaults
必填
propertyName
类型: string
reservation
类型: object · VideoReservation
必填
max_duration_seconds
类型: integer · Max Duration Seconds
大于:
0
必填

Integer numbers.

output_count
常量:
1

Integer numbers.

strategy
常量:
requested_duration_or_model_max
rows
类型: array object[] · Rows
必填
input_image_billing
类型: string · Input Image Billing枚举
必填
值
per_image
included
not_applicable
input_mode
类型: string · Input Mode枚举
必填
值
text_to_video
image_to_video
first_last_frame
max_duration_output_estimate_usd
类型: string · Max Duration Output Estimate Usd
必填
resolution
类型: string · Resolution
必填
unit
类型: string · Unit枚举
必填
值
output_video_second
video_token
unit_price_usd
类型: string · Unit Price Usd
必填
aspect_ratio
类型: string · Aspect Ratio可为 null
derived_output_second_usd
类型: string · Derived Output Second Usd可为 null
generate_audio
类型: boolean · Generate Audio可为 null
input_image_price_usd
类型: string · Input Image Price Usd可为 null
reservation_supported
常量:
true
reservation_unavailable_reason
类型: null · Reservation Unavailable Reason
size
类型: string · Size可为 null
seed_supported
类型: boolean · Seed Supported
必填
snapshot_id
类型: string · Snapshot Id
必填
source_model_id
类型: string · Source Model Id
必填
supported_aspect_ratios
类型: array string[] · Supported Aspect Ratios
必填
supported_durations
类型: array integer[] · Supported Durations
必填
supported_frame_images
类型: array string[] · Supported Frame Images
必填
supported_resolutions
类型: array string[] · Supported Resolutions
必填
basis
常量:
public_reference_before_discount
currency
常量:
USD
settlement_basis
常量:
upstream_cost
version
常量:
1

Integer numbers.

sale_pricing
类型: object · VideoSalePricing可为 null

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

basis
常量:
sale_before_discount
必填
currency
常量:
USD
必填
rows
类型: array object[] · Rows
必填

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
类型: object · Conditions
必填

Equality-condition summary; predicates retain the complete rule semantics

propertyName
类型: anything
rates
类型: object · Rates
必填

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

propertyName
类型: string
predicates
类型: array object[] | null · Predicates可为 null

Ordered rule predicates including range comparisons

field
类型: string · Field
必填

Felo 定价上下文，例如 input_context_tokens

operator
类型: string · Operator枚举
必填
值
eq
gt
gte
value
必填
类型: string · Value
minimum_charge_usd
类型: string · Minimum Charge Usd可为 null

Marked-up minimum charge in USD, before discount; null if none

selection
常量:
first_match

First matching rule wins; the final empty rule is the default

unit
类型: string · Unit可为 null

Primary billing unit, e.g. output_video_second or video_token

second_pricing
类型: object · VideoSecondPricing可为 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
常量:
sale_before_discount
必填
currency
常量:
USD
必填
rows
类型: array object[] · Rows
必填
estimated
类型: boolean · Estimated
必填

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

per_second_usd
类型: string · Per Second Usd
必填

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

aspect_ratio
类型: string · Aspect Ratio可为 null
generate_audio
类型: boolean · Generate Audio可为 null
input_image_usd
类型: string · Input Image Usd可为 null

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

input_mode
类型: string · Input Mode可为 null
predicates
类型: array object[] | null · Predicates可为 null

Full conditions for this per-second price row

field
类型: string · Field
必填

Felo 定价上下文，例如 input_context_tokens

operator
类型: string · Operator枚举
必填
值
eq
gt
gte
value
必填
类型: string · Value
resolution
类型: string · Resolution可为 null
second_basis
类型: string · Second Basis枚举
必填

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.

值
exact
token_pixel_frames_estimate
pricing_type
类型: string · Pricing Type可为 null

per_second or video_token

settlement_policy
类型: object · PublicSettlementPolicy可为 null

Published primary pricing and missing-usage fallback policy

fallback
类型: string · Fallback枚举
必填
值
upstream_cost
review_required
primary
常量:
configured_rates
必填
version
常量:
1
必填

Integer numbers.

default_channel
类型: string · Default Channel可为 null
parameter_definitions
类型: 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
类型: object
propertyName
类型: anything
recommended_protocol
类型: string · Recommended Protocol枚举可为 null

仅作为针对整个模型的客户端建议；非聊天模型为 null；不限制可调用的协议

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

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='

显示 Schema

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

需要帮助？