v0.4.0

OpenAPI 3.1.0

Get a public model by name

Felo API Support

MIT

Server

https://openapi.felo.ai

Pustaka Klien

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.

Parameter Kueri

model
Tipe: string
panjang min:
1
panjang maks:
256
wajib

Exact case-sensitive public model name or registered alias
locale
Tipe: string enum

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

Header

If-None-Match
Tipe: string

Previous ETag; matching content returns 304

Respons

200
Tipe: object · ModelCatalogModelResponse

Public model details
data
Tipe: object · CatalogModel
wajib
author
Tipe: string · Authorboleh null
wajib
author_display_name
Tipe: string · Author Display Nameboleh null
wajib
available_content_locales
Tipe: array string[] · Available Content Localesenum
wajib
nilai
en
zh-CN
zh-TW
ja
ko
best_for
Tipe: array string[] · Best For
wajib
capabilities
Tipe: array string[] · Capabilities
wajib
content_locale
Tipe: string · Content Localeenumboleh null
wajib
nilai
en
zh-CN
zh-TW
ja
ko
context_length
Tipe: integer · Context Lengthboleh null
wajib

Integer numbers.

description
Tipe: string · Descriptionboleh null
wajib
document
Tipe: object · PublicDocumentboleh null
wajib

Hanya bahasa yang dipilih; summary/description/best_for tetap pada model

extra
Tipe: object · Extra
wajib
propertyName
Tipe: anything
notice
Tipe: object · CatalogNoticeboleh null
wajib
body
Tipe: string · Body
wajib
link_text
Tipe: string · Link Textboleh null
wajib
target_slug
Tipe: string · Target Slugboleh null
wajib
title
Tipe: string · Titleboleh null
wajib
updated_at
Tipe: string · Updated At
wajib

Waktu pembaruan dokumen bahasa yang dipilih

icon_url
Tipe: string · Icon Urlboleh null
wajib
id
Tipe: string · Id
wajib
input_modalities
Tipe: array string[] · Input Modalities
wajib
latency_class
Tipe: string · Latency Classboleh null
wajib
max_completion_tokens
Tipe: integer · Max Completion Tokensboleh null
wajib

Integer numbers.

model_kind
Tipe: string · Model Kindenum
wajib
nilai
chat
image_generation
video_generation
decisions
name
Tipe: string · Name
wajib
output_modalities
Tipe: array string[] · Output Modalities
wajib
reasoning
Tipe: object · Reasoningboleh null
wajib

Objek JSON reasoning upstream; mempertahankan field yang tidak dikenal; null jika tidak tersedia

propertyName
Tipe: anything
released_at
Tipe: string · Released Atboleh null
wajib

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

short_name
Tipe: string · Short Name
wajib
slug
Tipe: string · Slug
wajib
sort_order
Tipe: integer · Sort Order
wajib

Integer numbers.

summary
Tipe: string · Summaryboleh null
wajib
supported_parameters
Tipe: array string[] · Supported Parameters
wajib
trial_status
Tipe: string · Trial Status
wajib
updated_at
Tipe: string · Updated Atboleh null
wajib
video_spec
Tipe: object · VideoSpecboleh null
wajib
aspect_ratios
Tipe: array string[] | null · Aspect Ratiosboleh null
audio
Tipe: object · AudioSpecboleh null
input
Tipe: boolean · Inputboleh null
output
Tipe: boolean · Outputboleh null
output_optional
Tipe: boolean · Output Optionalboleh null
constraints
Tipe: object · Constraintsboleh null

Skema JSON khusus data untuk kombinasi permintaan yang valid

propertyName
Tipe: anything
duration_seconds
Tipe: object · DurationSpecboleh null
max
Tipe: number · Max
lebih besar dari:
0
wajib
min
Tipe: number · Min
min:
0
wajib
step
Tipe: number · Step
lebih besar dari:
0
wajib
example_request
Tipe: object · Example Requestboleh null
propertyName
Tipe: anything
input_modes
Tipe: array string[] | null · Input Modesboleh null
reference_limits
Tipe: object · Reference Limitsboleh null
propertyName
boleh null
Tipe: integer

Integer numbers.

request_defaults
Tipe: object · Request Defaultsboleh null
propertyName
Tipe: anything
resolutions
Tipe: array string[] | null · Resolutionsboleh null
channels
Tipe: array object[] · Channels
code
Tipe: string · Code
wajib
discount_multiplier
Tipe: string · Discount Multiplierboleh null
wajib

Pengali penjualan tepat dari 0 hingga 1; terapkan sekali pada tarif yang dikonfigurasi atau biaya upstream

is_default
Tipe: boolean · Is Default
wajib
name
Tipe: string · Name
wajib
region
Tipe: string · Regionboleh null
wajib
runnable
Tipe: boolean · Runnable
wajib
service_tier
Tipe: string · Service Tier
wajib
standard_pricing
Tipe: object · CatalogPricingboleh null
wajib

Tarif satuan standar sebelum diskon penjualan; null untuk kanal upstream_cost

basis
const:
standard
wajib
billing_kind
Tipe: string · Billing Kind
wajib
channel
Tipe: string · Channel
wajib
currency
const:
USD
wajib
tiers
Tipe: array object[] · Tiers
wajib

Pertahankan urutan; tingkat pertama yang cocok menimpa tarif dasar

conditions
Tipe: array object[] · Conditions
wajib
field
Tipe: string · Field
wajib

Konteks harga Felo, misalnya input_context_tokens

operator
Tipe: string · Operatorenum
wajib
nilai
eq
gt
gte
value
wajib
Tipe: string · Value
overrides
Tipe: object · Overrides
wajib
propertyName
Tipe: string
audio
Tipe: string · Audioboleh null

USD per token audio input

completion
Tipe: string · Completionboleh null

USD per token output

credit
Tipe: string · Creditboleh null

USD per credit; billed using the upstream call multiplier

input_audio_cache
Tipe: string · Input Audio Cacheboleh null

USD per token audio yang di-cache

input_cache_read
Tipe: string · Input Cache Readboleh null

USD per token input yang di-cache

input_cache_write
Tipe: string · Input Cache Writeboleh null

USD per token penulisan cache

input_cache_write_12h
Tipe: string · Input Cache Write 12Hboleh null

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

input_cache_write_1h
Tipe: string · Input Cache Write 1Hboleh null

USD per token penulisan cache 1 jam; terpisah dari penulisan TTL default

input_image
Tipe: string · Input Imageboleh null

USD per gambar input

input_image_cache
Tipe: string · Input Image Cacheboleh null

USD per cached image token

input_image_token
Tipe: string · Input Image Tokenboleh null

USD per token gambar input

input_video_second
Tipe: string · Input Video Secondboleh null

USD per detik video input

internal_reasoning
Tipe: string · Internal Reasoningboleh null

USD per token reasoning

output_image
Tipe: string · Output Imageboleh null

USD per gambar yang dihasilkan

output_image_token
Tipe: string · Output Image Tokenboleh null

USD per token gambar output

output_video_second
Tipe: string · Output Video Secondboleh null

USD per detik video yang dihasilkan

output_video_token
Tipe: string · Output Video Tokenboleh null

USD per generated video token

prompt
Tipe: string · Promptboleh null

USD per token input; null berarti tidak tersedia, 0 berarti gratis

request
Tipe: string · Requestboleh null

USD per permintaan

web_search
Tipe: string · Web Searchboleh null

USD per permintaan pencarian web

markup_multiplier
Tipe: string · Markup Multiplierboleh null

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

pricing_mode
Tipe: string · Pricing Modeenum

Tarif satuan yang dikonfigurasi, atau biaya media yang dilaporkan dikalikan diskon penjualan

nilai
configured_rates
upstream_cost
reference_pricing
boleh null

Public video reference before discount; not a final charge

as_of
Tipe: string · As Of
wajib
canonical_slug
Tipe: string · Canonical Slug
wajib
pricing_type
const:
per_second
wajib
request_defaults
Tipe: object · Request Defaults
wajib
propertyName
Tipe: string
reservation
Tipe: object · VideoReservation
wajib
max_duration_seconds
Tipe: integer · Max Duration Seconds
lebih besar dari:
0
wajib

Integer numbers.

output_count
const:
1

Integer numbers.

strategy
const:
requested_duration_or_model_max
rows
Tipe: array object[] · Rows
wajib
input_image_billing
Tipe: string · Input Image Billingenum
wajib
nilai
per_image
included
not_applicable
input_mode
Tipe: string · Input Modeenum
wajib
nilai
text_to_video
image_to_video
first_last_frame
max_duration_output_estimate_usd
Tipe: string · Max Duration Output Estimate Usd
wajib
resolution
Tipe: string · Resolution
wajib
unit
Tipe: string · Unitenum
wajib
nilai
output_video_second
video_token
unit_price_usd
Tipe: string · Unit Price Usd
wajib
aspect_ratio
Tipe: string · Aspect Ratioboleh null
derived_output_second_usd
Tipe: string · Derived Output Second Usdboleh null
generate_audio
Tipe: boolean · Generate Audioboleh null
input_image_price_usd
Tipe: string · Input Image Price Usdboleh null
reservation_supported
const:
true
reservation_unavailable_reason
Tipe: null · Reservation Unavailable Reason
size
Tipe: string · Sizeboleh null
seed_supported
Tipe: boolean · Seed Supported
wajib
snapshot_id
Tipe: string · Snapshot Id
wajib
source_model_id
Tipe: string · Source Model Id
wajib
supported_aspect_ratios
Tipe: array string[] · Supported Aspect Ratios
wajib
supported_durations
Tipe: array integer[] · Supported Durations
wajib
supported_frame_images
Tipe: array string[] · Supported Frame Images
wajib
supported_resolutions
Tipe: array string[] · Supported Resolutions
wajib
basis
const:
public_reference_before_discount
currency
const:
USD
settlement_basis
const:
upstream_cost
version
const:
1

Integer numbers.

sale_pricing
Tipe: object · VideoSalePricingboleh 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
wajib
currency
const:
USD
wajib
rows
Tipe: array object[] · Rows
wajib

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
Tipe: object · Conditions
wajib

Equality-condition summary; predicates retain the complete rule semantics

propertyName
Tipe: anything
rates
Tipe: object · Rates
wajib

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

propertyName
Tipe: string
predicates
Tipe: array object[] | null · Predicatesboleh null

Ordered rule predicates including range comparisons

field
Tipe: string · Field
wajib

Konteks harga Felo, misalnya input_context_tokens

operator
Tipe: string · Operatorenum
wajib
nilai
eq
gt
gte
value
wajib
Tipe: string · Value
minimum_charge_usd
Tipe: string · Minimum Charge Usdboleh 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
Tipe: string · Unitboleh null

Primary billing unit, e.g. output_video_second or video_token

second_pricing
Tipe: object · VideoSecondPricingboleh 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
wajib
currency
const:
USD
wajib
rows
Tipe: array object[] · Rows
wajib
estimated
Tipe: boolean · Estimated
wajib

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

per_second_usd
Tipe: string · Per Second Usd
wajib

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

aspect_ratio
Tipe: string · Aspect Ratioboleh null
generate_audio
Tipe: boolean · Generate Audioboleh null
input_image_usd
Tipe: string · Input Image Usdboleh null

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

input_mode
Tipe: string · Input Modeboleh null
predicates
Tipe: array object[] | null · Predicatesboleh null

Full conditions for this per-second price row

field
Tipe: string · Field
wajib

Konteks harga Felo, misalnya input_context_tokens

operator
Tipe: string · Operatorenum
wajib
nilai
eq
gt
gte
value
wajib
Tipe: string · Value
resolution
Tipe: string · Resolutionboleh null
second_basis
Tipe: string · Second Basisenum
wajib

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.

nilai
exact
token_pixel_frames_estimate
pricing_type
Tipe: string · Pricing Typeboleh null

per_second or video_token

settlement_policy
Tipe: object · PublicSettlementPolicyboleh null

Published primary pricing and missing-usage fallback policy

fallback
Tipe: string · Fallbackenum
wajib
nilai
upstream_cost
review_required
primary
const:
configured_rates
wajib
version
const:
1
wajib

Integer numbers.

default_channel
Tipe: string · Default Channelboleh null
parameter_definitions
Tipe: 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
Tipe: object
propertyName
Tipe: anything
recommended_protocol
Tipe: string · Recommended Protocolenumboleh null

Hanya rekomendasi klien untuk seluruh model; null untuk model non-chat; tidak membatasi protokol yang dapat dipanggil

nilai
responses
messages
locale
Tipe: string · Localeenum
wajib
nilai
en
zh-CN
zh-TW
ja
ko
schema_version
const:
2
wajib

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

Tampilkan Skema

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

Butuh bantuan?