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

需要協助嗎？