v0.4.0

OpenAPI 3.1.0

Get a public model by name

Felo API Support

MIT

Server

https://openapi.felo.ai

Clientbibliotheken

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.

Queryparameters

model
Type: string
min. lengte:
1
max. lengte:
256
verplicht

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

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

Headers

If-None-Match
Type: string

Previous ETag; matching content returns 304

Responsen

200
Type: object · ModelCatalogModelResponse

Public model details
data
Type: object · CatalogModel
verplicht
author
Type: string · Authornull toegestaan
verplicht
author_display_name
Type: string · Author Display Namenull toegestaan
verplicht
available_content_locales
Type: array string[] · Available Content Localesenum
verplicht
waarden
en
zh-CN
zh-TW
ja
ko
best_for
Type: array string[] · Best For
verplicht
capabilities
Type: array string[] · Capabilities
verplicht
content_locale
Type: string · Content Localeenumnull toegestaan
verplicht
waarden
en
zh-CN
zh-TW
ja
ko
context_length
Type: integer · Context Lengthnull toegestaan
verplicht

Integer numbers.

description
Type: string · Descriptionnull toegestaan
verplicht
document
Type: object · PublicDocumentnull toegestaan
verplicht

Alleen de geselecteerde taal; summary/description/best_for blijven op het model

extra
Type: object · Extra
verplicht
propertyName
Type: anything
notice
Type: object · CatalogNoticenull toegestaan
verplicht
body
Type: string · Body
verplicht
link_text
Type: string · Link Textnull toegestaan
verplicht
target_slug
Type: string · Target Slugnull toegestaan
verplicht
title
Type: string · Titlenull toegestaan
verplicht
updated_at
Type: string · Updated At
verplicht

Updatetijd van het document in de geselecteerde taal

icon_url
Type: string · Icon Urlnull toegestaan
verplicht
id
Type: string · Id
verplicht
input_modalities
Type: array string[] · Input Modalities
verplicht
latency_class
Type: string · Latency Classnull toegestaan
verplicht
max_completion_tokens
Type: integer · Max Completion Tokensnull toegestaan
verplicht

Integer numbers.

model_kind
Type: string · Model Kindenum
verplicht
waarden
chat
image_generation
video_generation
decisions
name
Type: string · Name
verplicht
output_modalities
Type: array string[] · Output Modalities
verplicht
reasoning
Type: object · Reasoningnull toegestaan
verplicht

Upstream-JSON-object voor redeneren; behoudt onbekende velden; null indien niet beschikbaar

propertyName
Type: anything
released_at
Type: string · Released Atnull toegestaan
verplicht

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

short_name
Type: string · Short Name
verplicht
slug
Type: string · Slug
verplicht
sort_order
Type: integer · Sort Order
verplicht

Integer numbers.

summary
Type: string · Summarynull toegestaan
verplicht
supported_parameters
Type: array string[] · Supported Parameters
verplicht
trial_status
Type: string · Trial Status
verplicht
updated_at
Type: string · Updated Atnull toegestaan
verplicht
video_spec
Type: object · VideoSpecnull toegestaan
verplicht
aspect_ratios
Type: array string[] | null · Aspect Ratiosnull toegestaan
audio
Type: object · AudioSpecnull toegestaan
input
Type: boolean · Inputnull toegestaan
output
Type: boolean · Outputnull toegestaan
output_optional
Type: boolean · Output Optionalnull toegestaan
constraints
Type: object · Constraintsnull toegestaan

Een JSON Schema met alleen data voor geldige verzoekcombinaties

propertyName
Type: anything
duration_seconds
Type: object · DurationSpecnull toegestaan
max
Type: number · Max
groter dan:
0
verplicht
min
Type: number · Min
min.:
0
verplicht
step
Type: number · Step
groter dan:
0
verplicht
example_request
Type: object · Example Requestnull toegestaan
propertyName
Type: anything
input_modes
Type: array string[] | null · Input Modesnull toegestaan
reference_limits
Type: object · Reference Limitsnull toegestaan
propertyName
null toegestaan
Type: integer

Integer numbers.

request_defaults
Type: object · Request Defaultsnull toegestaan
propertyName
Type: anything
resolutions
Type: array string[] | null · Resolutionsnull toegestaan
channels
Type: array object[] · Channels
code
Type: string · Code
verplicht
discount_multiplier
Type: string · Discount Multipliernull toegestaan
verplicht

Exacte verkoopvermenigvuldiger van 0 tot 1; pas één keer toe op geconfigureerde tarieven of upstream-kosten

is_default
Type: boolean · Is Default
verplicht
name
Type: string · Name
verplicht
region
Type: string · Regionnull toegestaan
verplicht
runnable
Type: boolean · Runnable
verplicht
service_tier
Type: string · Service Tier
verplicht
standard_pricing
Type: object · CatalogPricingnull toegestaan
verplicht

Standaard eenheidstarieven vóór verkoopkorting; null voor kanalen met upstream_cost

basis
constante:
standard
verplicht
billing_kind
Type: string · Billing Kind
verplicht
channel
Type: string · Channel
verplicht
currency
constante:
USD
verplicht
tiers
Type: array object[] · Tiers
verplicht

Behoud de volgorde; het eerste overeenkomende niveau overschrijft de basistarieven

conditions
Type: array object[] · Conditions
verplicht
field
Type: string · Field
verplicht

Felo-prijscontext, bijv. input_context_tokens

operator
Type: string · Operatorenum
verplicht
waarden
eq
gt
gte
value
verplicht
Type: string · Value
overrides
Type: object · Overrides
verplicht
propertyName
Type: string
audio
Type: string · Audionull toegestaan

USD per invoer-audiotoken

completion
Type: string · Completionnull toegestaan

USD per uitvoertoken

credit
Type: string · Creditnull toegestaan

USD per credit; billed using the upstream call multiplier

input_audio_cache
Type: string · Input Audio Cachenull toegestaan

USD per gecacht audiotoken

input_cache_read
Type: string · Input Cache Readnull toegestaan

USD per gecacht invoertoken

input_cache_write
Type: string · Input Cache Writenull toegestaan

USD per cache-schrijftoken

input_cache_write_12h
Type: string · Input Cache Write 12Hnull toegestaan

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

input_cache_write_1h
Type: string · Input Cache Write 1Hnull toegestaan

USD per cache-schrijftoken van 1 uur; apart van schrijfacties met de standaard-TTL

input_image
Type: string · Input Imagenull toegestaan

USD per invoerafbeelding

input_image_cache
Type: string · Input Image Cachenull toegestaan

USD per cached image token

input_image_token
Type: string · Input Image Tokennull toegestaan

USD per invoer-afbeeldingstoken

input_video_second
Type: string · Input Video Secondnull toegestaan

USD per invoervideoseconde

internal_reasoning
Type: string · Internal Reasoningnull toegestaan

USD per redeneertoken

output_image
Type: string · Output Imagenull toegestaan

USD per gegenereerde afbeelding

output_image_token
Type: string · Output Image Tokennull toegestaan

USD per uitvoer-afbeeldingstoken

output_video_second
Type: string · Output Video Secondnull toegestaan

USD per gegenereerde videoseconde

output_video_token
Type: string · Output Video Tokennull toegestaan

USD per generated video token

prompt
Type: string · Promptnull toegestaan

USD per invoertoken; null betekent niet beschikbaar, 0 betekent gratis

request
Type: string · Requestnull toegestaan

USD per verzoek

web_search
Type: string · Web Searchnull toegestaan

USD per webzoekopdracht

markup_multiplier
Type: string · Markup Multipliernull toegestaan

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

pricing_mode
Type: string · Pricing Modeenum

Geconfigureerde eenheidstarieven, of gerapporteerde mediakosten maal de verkoopkorting

waarden
configured_rates
upstream_cost
reference_pricing
null toegestaan

Public video reference before discount; not a final charge

as_of
Type: string · As Of
verplicht
canonical_slug
Type: string · Canonical Slug
verplicht
pricing_type
constante:
per_second
verplicht
request_defaults
Type: object · Request Defaults
verplicht
propertyName
Type: string
reservation
Type: object · VideoReservation
verplicht
max_duration_seconds
Type: integer · Max Duration Seconds
groter dan:
0
verplicht

Integer numbers.

output_count
constante:
1

Integer numbers.

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

Integer numbers.

sale_pricing
Type: object · VideoSalePricingnull toegestaan

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

basis
constante:
sale_before_discount
verplicht
currency
constante:
USD
verplicht
rows
Type: array object[] · Rows
verplicht

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
Type: object · Conditions
verplicht

Equality-condition summary; predicates retain the complete rule semantics

propertyName
Type: anything
rates
Type: object · Rates
verplicht

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

propertyName
Type: string
predicates
Type: array object[] | null · Predicatesnull toegestaan

Ordered rule predicates including range comparisons

field
Type: string · Field
verplicht

Felo-prijscontext, bijv. input_context_tokens

operator
Type: string · Operatorenum
verplicht
waarden
eq
gt
gte
value
verplicht
Type: string · Value
minimum_charge_usd
Type: string · Minimum Charge Usdnull toegestaan

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

selection
constante:
first_match

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

unit
Type: string · Unitnull toegestaan

Primary billing unit, e.g. output_video_second or video_token

second_pricing
Type: object · VideoSecondPricingnull toegestaan

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
constante:
sale_before_discount
verplicht
currency
constante:
USD
verplicht
rows
Type: array object[] · Rows
verplicht
estimated
Type: boolean · Estimated
verplicht

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

per_second_usd
Type: string · Per Second Usd
verplicht

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

aspect_ratio
Type: string · Aspect Rationull toegestaan
generate_audio
Type: boolean · Generate Audionull toegestaan
input_image_usd
Type: string · Input Image Usdnull toegestaan

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

input_mode
Type: string · Input Modenull toegestaan
predicates
Type: array object[] | null · Predicatesnull toegestaan

Full conditions for this per-second price row

field
Type: string · Field
verplicht

Felo-prijscontext, bijv. input_context_tokens

operator
Type: string · Operatorenum
verplicht
waarden
eq
gt
gte
value
verplicht
Type: string · Value
resolution
Type: string · Resolutionnull toegestaan
second_basis
Type: string · Second Basisenum
verplicht

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.

waarden
exact
token_pixel_frames_estimate
pricing_type
Type: string · Pricing Typenull toegestaan

per_second or video_token

settlement_policy
Type: object · PublicSettlementPolicynull toegestaan

Published primary pricing and missing-usage fallback policy

fallback
Type: string · Fallbackenum
verplicht
waarden
upstream_cost
review_required
primary
constante:
configured_rates
verplicht
version
constante:
1
verplicht

Integer numbers.

default_channel
Type: string · Default Channelnull toegestaan
parameter_definitions
Type: 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
Type: object
propertyName
Type: anything
recommended_protocol
Type: string · Recommended Protocolenumnull toegestaan

Alleen een modelbrede clientaanbeveling; null voor niet-chatmodellen; beperkt de aanroepbare protocollen niet

waarden
responses
messages
locale
Type: string · Localeenum
verplicht
waarden
en
zh-CN
zh-TW
ja
ko
schema_version
constante:
2
verplicht

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 tonen

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

Hulp nodig?