v0.4.0

OpenAPI 3.1.0

Get a public model by name

Felo API Support

MIT

Máy chủ

https://openapi.felo.ai

Thư viện client

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.

Tham số truy vấn

model
Kiểu: string
độ dài tối thiểu:
1
độ dài tối đa:
256
bắt buộc

Exact case-sensitive public model name or registered alias
locale
Kiểu: string enum

Document language; falls back to English when unavailable
giá trị
- en
- zh-CN
- zh-TW
- ja
- ko

Header

If-None-Match
Kiểu: string

Previous ETag; matching content returns 304

Phản hồi

200
Kiểu: object · ModelCatalogModelResponse

Public model details
data
Kiểu: object · CatalogModel
bắt buộc
author
Kiểu: string · Authorcó thể null
bắt buộc
author_display_name
Kiểu: string · Author Display Namecó thể null
bắt buộc
available_content_locales
Kiểu: array string[] · Available Content Localesenum
bắt buộc
giá trị
en
zh-CN
zh-TW
ja
ko
best_for
Kiểu: array string[] · Best For
bắt buộc
capabilities
Kiểu: array string[] · Capabilities
bắt buộc
content_locale
Kiểu: string · Content Localeenumcó thể null
bắt buộc
giá trị
en
zh-CN
zh-TW
ja
ko
context_length
Kiểu: integer · Context Lengthcó thể null
bắt buộc

Integer numbers.

description
Kiểu: string · Descriptioncó thể null
bắt buộc
document
Kiểu: object · PublicDocumentcó thể null
bắt buộc

Chỉ ngôn ngữ đã chọn; summary/description/best_for vẫn nằm trên mô hình

extra
Kiểu: object · Extra
bắt buộc
propertyName
Kiểu: anything
notice
Kiểu: object · CatalogNoticecó thể null
bắt buộc
body
Kiểu: string · Body
bắt buộc
link_text
Kiểu: string · Link Textcó thể null
bắt buộc
target_slug
Kiểu: string · Target Slugcó thể null
bắt buộc
title
Kiểu: string · Titlecó thể null
bắt buộc
updated_at
Kiểu: string · Updated At
bắt buộc

Thời điểm cập nhật tài liệu của ngôn ngữ đã chọn

icon_url
Kiểu: string · Icon Urlcó thể null
bắt buộc
id
Kiểu: string · Id
bắt buộc
input_modalities
Kiểu: array string[] · Input Modalities
bắt buộc
latency_class
Kiểu: string · Latency Classcó thể null
bắt buộc
max_completion_tokens
Kiểu: integer · Max Completion Tokenscó thể null
bắt buộc

Integer numbers.

model_kind
Kiểu: string · Model Kindenum
bắt buộc
giá trị
chat
image_generation
video_generation
decisions
name
Kiểu: string · Name
bắt buộc
output_modalities
Kiểu: array string[] · Output Modalities
bắt buộc
reasoning
Kiểu: object · Reasoningcó thể null
bắt buộc

Đối tượng JSON reasoning từ upstream; giữ nguyên các trường không xác định; null nếu không có

propertyName
Kiểu: anything
released_at
Kiểu: string · Released Atcó thể null
bắt buộc

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

short_name
Kiểu: string · Short Name
bắt buộc
slug
Kiểu: string · Slug
bắt buộc
sort_order
Kiểu: integer · Sort Order
bắt buộc

Integer numbers.

summary
Kiểu: string · Summarycó thể null
bắt buộc
supported_parameters
Kiểu: array string[] · Supported Parameters
bắt buộc
trial_status
Kiểu: string · Trial Status
bắt buộc
updated_at
Kiểu: string · Updated Atcó thể null
bắt buộc
video_spec
Kiểu: object · VideoSpeccó thể null
bắt buộc
aspect_ratios
Kiểu: array string[] | null · Aspect Ratioscó thể null
audio
Kiểu: object · AudioSpeccó thể null
input
Kiểu: boolean · Inputcó thể null
output
Kiểu: boolean · Outputcó thể null
output_optional
Kiểu: boolean · Output Optionalcó thể null
constraints
Kiểu: object · Constraintscó thể null

JSON Schema chỉ chứa dữ liệu cho các tổ hợp yêu cầu hợp lệ

propertyName
Kiểu: anything
duration_seconds
Kiểu: object · DurationSpeccó thể null
max
Kiểu: number · Max
lớn hơn:
0
bắt buộc
min
Kiểu: number · Min
tối thiểu:
0
bắt buộc
step
Kiểu: number · Step
lớn hơn:
0
bắt buộc
example_request
Kiểu: object · Example Requestcó thể null
propertyName
Kiểu: anything
input_modes
Kiểu: array string[] | null · Input Modescó thể null
reference_limits
Kiểu: object · Reference Limitscó thể null
propertyName
có thể null
Kiểu: integer

Integer numbers.

request_defaults
Kiểu: object · Request Defaultscó thể null
propertyName
Kiểu: anything
resolutions
Kiểu: array string[] | null · Resolutionscó thể null
channels
Kiểu: array object[] · Channels
code
Kiểu: string · Code
bắt buộc
discount_multiplier
Kiểu: string · Discount Multipliercó thể null
bắt buộc

Hệ số giảm giá bán chính xác từ 0 đến 1; áp dụng một lần cho đơn giá đã cấu hình hoặc chi phí upstream

is_default
Kiểu: boolean · Is Default
bắt buộc
name
Kiểu: string · Name
bắt buộc
region
Kiểu: string · Regioncó thể null
bắt buộc
runnable
Kiểu: boolean · Runnable
bắt buộc
service_tier
Kiểu: string · Service Tier
bắt buộc
standard_pricing
Kiểu: object · CatalogPricingcó thể null
bắt buộc

Đơn giá tiêu chuẩn trước khi giảm giá bán; null với các kênh upstream_cost

basis
const:
standard
bắt buộc
billing_kind
Kiểu: string · Billing Kind
bắt buộc
channel
Kiểu: string · Channel
bắt buộc
currency
const:
USD
bắt buộc
tiers
Kiểu: array object[] · Tiers
bắt buộc

Giữ nguyên thứ tự; hạng khớp đầu tiên ghi đè mức giá cơ sở

conditions
Kiểu: array object[] · Conditions
bắt buộc
field
Kiểu: string · Field
bắt buộc

Ngữ cảnh định giá của Felo, ví dụ input_context_tokens

operator
Kiểu: string · Operatorenum
bắt buộc
giá trị
eq
gt
gte
value
bắt buộc
Kiểu: string · Value
overrides
Kiểu: object · Overrides
bắt buộc
propertyName
Kiểu: string
audio
Kiểu: string · Audiocó thể null

USD trên mỗi token âm thanh đầu vào

completion
Kiểu: string · Completioncó thể null

USD trên mỗi token đầu ra

credit
Kiểu: string · Creditcó thể null

USD per credit; billed using the upstream call multiplier

input_audio_cache
Kiểu: string · Input Audio Cachecó thể null

USD trên mỗi token âm thanh được lưu trong bộ nhớ đệm

input_cache_read
Kiểu: string · Input Cache Readcó thể null

USD trên mỗi token đầu vào được lưu trong bộ nhớ đệm

input_cache_write
Kiểu: string · Input Cache Writecó thể null

USD trên mỗi token ghi vào bộ nhớ đệm

input_cache_write_12h
Kiểu: string · Input Cache Write 12Hcó thể null

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

input_cache_write_1h
Kiểu: string · Input Cache Write 1Hcó thể null

USD trên mỗi token ghi vào bộ nhớ đệm 1 giờ; tách biệt với các lần ghi theo TTL mặc định

input_image
Kiểu: string · Input Imagecó thể null

USD trên mỗi hình ảnh đầu vào

input_image_cache
Kiểu: string · Input Image Cachecó thể null

USD per cached image token

input_image_token
Kiểu: string · Input Image Tokencó thể null

USD trên mỗi token hình ảnh đầu vào

input_video_second
Kiểu: string · Input Video Secondcó thể null

USD trên mỗi giây video đầu vào

internal_reasoning
Kiểu: string · Internal Reasoningcó thể null

USD trên mỗi token reasoning

output_image
Kiểu: string · Output Imagecó thể null

USD trên mỗi hình ảnh được tạo

output_image_token
Kiểu: string · Output Image Tokencó thể null

USD trên mỗi token hình ảnh đầu ra

output_video_second
Kiểu: string · Output Video Secondcó thể null

USD trên mỗi giây video được tạo

output_video_token
Kiểu: string · Output Video Tokencó thể null

USD per generated video token

prompt
Kiểu: string · Promptcó thể null

USD trên mỗi token đầu vào; null nghĩa là không có, 0 nghĩa là miễn phí

request
Kiểu: string · Requestcó thể null

USD trên mỗi yêu cầu

web_search
Kiểu: string · Web Searchcó thể null

USD trên mỗi yêu cầu tìm kiếm web

markup_multiplier
Kiểu: string · Markup Multipliercó thể null

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

pricing_mode
Kiểu: string · Pricing Modeenum

Đơn giá đã cấu hình, hoặc chi phí phương tiện được báo cáo nhân với mức giảm giá bán

giá trị
configured_rates
upstream_cost
reference_pricing
có thể null

Public video reference before discount; not a final charge

as_of
Kiểu: string · As Of
bắt buộc
canonical_slug
Kiểu: string · Canonical Slug
bắt buộc
pricing_type
const:
per_second
bắt buộc
request_defaults
Kiểu: object · Request Defaults
bắt buộc
propertyName
Kiểu: string
reservation
Kiểu: object · VideoReservation
bắt buộc
max_duration_seconds
Kiểu: integer · Max Duration Seconds
lớn hơn:
0
bắt buộc

Integer numbers.

output_count
const:
1

Integer numbers.

strategy
const:
requested_duration_or_model_max
rows
Kiểu: array object[] · Rows
bắt buộc
input_image_billing
Kiểu: string · Input Image Billingenum
bắt buộc
giá trị
per_image
included
not_applicable
input_mode
Kiểu: string · Input Modeenum
bắt buộc
giá trị
text_to_video
image_to_video
first_last_frame
max_duration_output_estimate_usd
Kiểu: string · Max Duration Output Estimate Usd
bắt buộc
resolution
Kiểu: string · Resolution
bắt buộc
unit
Kiểu: string · Unitenum
bắt buộc
giá trị
output_video_second
video_token
unit_price_usd
Kiểu: string · Unit Price Usd
bắt buộc
aspect_ratio
Kiểu: string · Aspect Ratiocó thể null
derived_output_second_usd
Kiểu: string · Derived Output Second Usdcó thể null
generate_audio
Kiểu: boolean · Generate Audiocó thể null
input_image_price_usd
Kiểu: string · Input Image Price Usdcó thể null
reservation_supported
const:
true
reservation_unavailable_reason
Kiểu: null · Reservation Unavailable Reason
size
Kiểu: string · Sizecó thể null
seed_supported
Kiểu: boolean · Seed Supported
bắt buộc
snapshot_id
Kiểu: string · Snapshot Id
bắt buộc
source_model_id
Kiểu: string · Source Model Id
bắt buộc
supported_aspect_ratios
Kiểu: array string[] · Supported Aspect Ratios
bắt buộc
supported_durations
Kiểu: array integer[] · Supported Durations
bắt buộc
supported_frame_images
Kiểu: array string[] · Supported Frame Images
bắt buộc
supported_resolutions
Kiểu: array string[] · Supported Resolutions
bắt buộc
basis
const:
public_reference_before_discount
currency
const:
USD
settlement_basis
const:
upstream_cost
version
const:
1

Integer numbers.

sale_pricing
Kiểu: object · VideoSalePricingcó thể null

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

basis
const:
sale_before_discount
bắt buộc
currency
const:
USD
bắt buộc
rows
Kiểu: array object[] · Rows
bắt buộc

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
Kiểu: object · Conditions
bắt buộc

Equality-condition summary; predicates retain the complete rule semantics

propertyName
Kiểu: anything
rates
Kiểu: object · Rates
bắt buộc

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

propertyName
Kiểu: string
predicates
Kiểu: array object[] | null · Predicatescó thể null

Ordered rule predicates including range comparisons

field
Kiểu: string · Field
bắt buộc

Ngữ cảnh định giá của Felo, ví dụ input_context_tokens

operator
Kiểu: string · Operatorenum
bắt buộc
giá trị
eq
gt
gte
value
bắt buộc
Kiểu: string · Value
minimum_charge_usd
Kiểu: string · Minimum Charge Usdcó thể null

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

selection
const:
first_match

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

unit
Kiểu: string · Unitcó thể null

Primary billing unit, e.g. output_video_second or video_token

second_pricing
Kiểu: object · VideoSecondPricingcó thể 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
const:
sale_before_discount
bắt buộc
currency
const:
USD
bắt buộc
rows
Kiểu: array object[] · Rows
bắt buộc
estimated
Kiểu: boolean · Estimated
bắt buộc

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

per_second_usd
Kiểu: string · Per Second Usd
bắt buộc

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

aspect_ratio
Kiểu: string · Aspect Ratiocó thể null
generate_audio
Kiểu: boolean · Generate Audiocó thể null
input_image_usd
Kiểu: string · Input Image Usdcó thể null

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

input_mode
Kiểu: string · Input Modecó thể null
predicates
Kiểu: array object[] | null · Predicatescó thể null

Full conditions for this per-second price row

field
Kiểu: string · Field
bắt buộc

Ngữ cảnh định giá của Felo, ví dụ input_context_tokens

operator
Kiểu: string · Operatorenum
bắt buộc
giá trị
eq
gt
gte
value
bắt buộc
Kiểu: string · Value
resolution
Kiểu: string · Resolutioncó thể null
second_basis
Kiểu: string · Second Basisenum
bắt buộc

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.

giá trị
exact
token_pixel_frames_estimate
pricing_type
Kiểu: string · Pricing Typecó thể null

per_second or video_token

settlement_policy
Kiểu: object · PublicSettlementPolicycó thể null

Published primary pricing and missing-usage fallback policy

fallback
Kiểu: string · Fallbackenum
bắt buộc
giá trị
upstream_cost
review_required
primary
const:
configured_rates
bắt buộc
version
const:
1
bắt buộc

Integer numbers.

default_channel
Kiểu: string · Default Channelcó thể null
parameter_definitions
Kiểu: 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
Kiểu: object
propertyName
Kiểu: anything
recommended_protocol
Kiểu: string · Recommended Protocolenumcó thể null

Chỉ là khuyến nghị phía client cho toàn bộ mô hình; null với mô hình không phải chat; không giới hạn các giao thức có thể gọi

giá trị
responses
messages
locale
Kiểu: string · Localeenum
bắt buộc
giá trị
en
zh-CN
zh-TW
ja
ko
schema_version
const:
2
bắt buộc

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

Hiện 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

Cần trợ giúp?