v0.4.0

OpenAPI 3.1.0

Đọc danh mục mô hình ẩn danh

Felo API Support

MIT

Máy chủ

https://openapi.felo.ai

Thư viện client

Shell Curl

Đọc danh mục mô hình ẩn danh

Danh mục mô hình ẩn danh, schema_version=2. Các kênh hiển thị pricing_mode, standard_pricing và discount_multiplier. Các kênh upstream_cost dùng chi phí hình ảnh hoặc video được báo cáo nhân với mức giảm giá đã đóng băng; standard_pricing của chúng là null, không phải 0. default_channel xác định mã kênh mặc định. recommended_protocol là khuyến nghị phía client cho toàn bộ mô hình (responses/messages, null với mô hình không phải chat), không phải giới hạn giao thức. Không trả về cấu hình giao thức hay siêu dữ liệu playground. reasoning giữ nguyên đối tượng JSON upstream, hoặc null khi không có.

Tham số truy vấn

locale
Kiểu: string enum
giá trị
- en
- zh-CN
- zh-TW
- ja
- ko
q
Kiểu: string
id
Kiểu: string
model_kind
Kiểu: string enum
giá trị
- chat
- image_generation
- video_generation
- decisions
fmt
Kiểu: string enum
giá trị
- cards
- full

Header

If-None-Match
Kiểu: string

Phản hồi

200
Kiểu: object · ModelCatalogResponse

Các mô hình hiển thị; ID không xác định nhưng khớp chính xác sẽ trả về mảng rỗng.
data
Kiểu: object · CatalogData
bắt buộc
models
Kiểu: array object[] · Models
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
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

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_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_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

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

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
default_channel
Kiểu: string · Default Channelcó thể null
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
total
Kiểu: integer · Total
bắt buộc

Integer numbers.

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

Biểu diễn không thay đổi; phần thân rỗng
400

Ngôn ngữ không được hỗ trợ
422

Tham số projection hoặc kind không hợp lệ
503

Danh mục tạm thời không khả dụng

get/api/platform/model-catalog

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

Hiện 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": "Mô hình ví dụ.",
        "description": "Văn bản minh họa, không phải mô hình thật.",
        "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"
          }
        ]
      }
    ]
  }
}

Các mô hình hiển thị; ID không xác định nhưng khớp chính xác sẽ trả về mảng rỗng.