Felo API PlatformFelo API Platform
v0.4.0
OpenAPI 3.1.0

Get a public model by name

Server:https://openapi.felo.ai
Client-Bibliotheken

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.

Query-Parameter
  • model
    Typ: string
    min. Länge:  
    1
    max. Länge:  
    256
    erforderlich

    Exact case-sensitive public model name or registered alias

  • locale
    Typ: string enum

    Document language; falls back to English when unavailable

    Werte
    • en
    • zh-CN
    • zh-TW
    • ja
    • ko
Header
  • If-None-Match
    Typ: string

    Previous ETag; matching content returns 304

Antworten
  • 200
    Typ: object · ModelCatalogModelResponse

    Public model details

    • data
      Typ: object · CatalogModel
      erforderlich
      • author
        Typ: string · Authornullable
        erforderlich
      • author_display_name
        Typ: string · Author Display Namenullable
        erforderlich
      • available_content_locales
        Typ: array string[] · Available Content Localesenum
        erforderlich
        Werte
        • en
        • zh-CN
        • zh-TW
        • ja
        • ko
      • best_for
        Typ: array string[] · Best For
        erforderlich
      • capabilities
        Typ: array string[] · Capabilities
        erforderlich
      • content_locale
        Typ: string · Content Localeenumnullable
        erforderlich
        Werte
        • en
        • zh-CN
        • zh-TW
        • ja
        • ko
      • context_length
        Typ: integer · Context Lengthnullable
        erforderlich

        Integer numbers.

      • description
        Typ: string · Descriptionnullable
        erforderlich
      • document
        Typ: object · PublicDocumentnullable
        erforderlich

        Nur die ausgewählte Sprache; summary/description/best_for bleiben am Modell

        • extra
          Typ: object · Extra
          erforderlich
          • propertyName
            Typ: anything
        • notice
          Typ: object · CatalogNoticenullable
          erforderlich
          • body
            Typ: string · Body
            erforderlich
          • link_text
            Typ: string · Link Textnullable
            erforderlich
          • target_slug
            Typ: string · Target Slugnullable
            erforderlich
          • title
            Typ: string · Titlenullable
            erforderlich
        • updated_at
          Typ: string · Updated At
          erforderlich

          Aktualisierungszeitpunkt des Dokuments in der ausgewählten Sprache

      • icon_url
        Typ: string · Icon Urlnullable
        erforderlich
      • id
        Typ: string · Id
        erforderlich
      • input_modalities
        Typ: array string[] · Input Modalities
        erforderlich
      • latency_class
        Typ: string · Latency Classnullable
        erforderlich
      • max_completion_tokens
        Typ: integer · Max Completion Tokensnullable
        erforderlich

        Integer numbers.

      • model_kind
        Typ: string · Model Kindenum
        erforderlich
        Werte
        • chat
        • image_generation
        • video_generation
        • decisions
      • name
        Typ: string · Name
        erforderlich
      • output_modalities
        Typ: array string[] · Output Modalities
        erforderlich
      • reasoning
        Typ: object · Reasoningnullable
        erforderlich

        Upstream-JSON-Objekt für Reasoning; bewahrt unbekannte Felder; null, wenn nicht verfügbar

        • propertyName
          Typ: anything
      • released_at
        Typ: string · Released Atnullable
        erforderlich

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

      • short_name
        Typ: string · Short Name
        erforderlich
      • slug
        Typ: string · Slug
        erforderlich
      • sort_order
        Typ: integer · Sort Order
        erforderlich

        Integer numbers.

      • summary
        Typ: string · Summarynullable
        erforderlich
      • supported_parameters
        Typ: array string[] · Supported Parameters
        erforderlich
      • trial_status
        Typ: string · Trial Status
        erforderlich
      • updated_at
        Typ: string · Updated Atnullable
        erforderlich
      • video_spec
        Typ: object · VideoSpecnullable
        erforderlich
        • aspect_ratios
          Typ: array string[] | null · Aspect Ratiosnullable
        • audio
          Typ: object · AudioSpecnullable
          • input
            Typ: boolean · Inputnullable
          • output
            Typ: boolean · Outputnullable
          • output_optional
            Typ: boolean · Output Optionalnullable
        • constraints
          Typ: object · Constraintsnullable

          Nur-Daten-JSON-Schema für gültige Anfragekombinationen

          • propertyName
            Typ: anything
        • duration_seconds
          Typ: object · DurationSpecnullable
          • max
            Typ: number · Max
            größer als:  
            0
            erforderlich
          • min
            Typ: number · Min
            min.:  
            0
            erforderlich
          • step
            Typ: number · Step
            größer als:  
            0
            erforderlich
        • example_request
          Typ: object · Example Requestnullable
          • propertyName
            Typ: anything
        • input_modes
          Typ: array string[] | null · Input Modesnullable
        • reference_limits
          Typ: object · Reference Limitsnullable
          • propertyName
            nullable
            • Typ: integer

              Integer numbers.

        • request_defaults
          Typ: object · Request Defaultsnullable
          • propertyName
            Typ: anything
        • resolutions
          Typ: array string[] | null · Resolutionsnullable
      • channels
        Typ: array object[] · Channels
        • code
          Typ: string · Code
          erforderlich
        • discount_multiplier
          Typ: string · Discount Multipliernullable
          erforderlich

          Exakter Verkaufsmultiplikator von 0 bis 1; einmal auf konfigurierte Tarife oder Upstream-Kosten anwenden

        • is_default
          Typ: boolean · Is Default
          erforderlich
        • name
          Typ: string · Name
          erforderlich
        • region
          Typ: string · Regionnullable
          erforderlich
        • runnable
          Typ: boolean · Runnable
          erforderlich
        • service_tier
          Typ: string · Service Tier
          erforderlich
        • standard_pricing
          Typ: object · CatalogPricingnullable
          erforderlich

          Standard-Einheitstarife vor dem Verkaufsrabatt; null für upstream_cost-Kanäle

          • basis
            Konstante:  
            standard
            erforderlich
          • billing_kind
            Typ: string · Billing Kind
            erforderlich
          • channel
            Typ: string · Channel
            erforderlich
          • currency
            Konstante:  
            USD
            erforderlich
          • tiers
            Typ: array object[] · Tiers
            erforderlich

            Reihenfolge beibehalten; die erste passende Tarifstufe überschreibt die Basisraten

            • conditions
              Typ: array object[] · Conditions
              erforderlich
              • field
                Typ: string · Field
                erforderlich

                Felo-Preiskontext, z. B. input_context_tokens

              • operator
                Typ: string · Operatorenum
                erforderlich
                Werte
                • eq
                • gt
                • gte
              • value
                erforderlich
                • Typ: string · Value
            • overrides
              Typ: object · Overrides
              erforderlich
              • propertyName
                Typ: string
          • audio
            Typ: string · Audionullable

            USD pro Audio-Eingabe-Token

          • completion
            Typ: string · Completionnullable

            USD pro Ausgabe-Token

          • credit
            Typ: string · Creditnullable

            USD per credit; billed using the upstream call multiplier

          • input_audio_cache
            Typ: string · Input Audio Cachenullable

            USD pro zwischengespeichertem Audio-Token

          • input_cache_read
            Typ: string · Input Cache Readnullable

            USD pro zwischengespeichertem Eingabe-Token

          • input_cache_write
            Typ: string · Input Cache Writenullable

            USD pro Cache-Schreib-Token

          • input_cache_write_12h
            Typ: string · Input Cache Write 12Hnullable

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

          • input_cache_write_1h
            Typ: string · Input Cache Write 1Hnullable

            USD pro Cache-Schreib-Token für 1 Stunde; getrennt von Schreibvorgängen mit standardmäßiger TTL

          • input_image
            Typ: string · Input Imagenullable

            USD pro Eingabebild

          • input_image_cache
            Typ: string · Input Image Cachenullable

            USD per cached image token

          • input_image_token
            Typ: string · Input Image Tokennullable

            USD pro Eingabebild-Token

          • input_video_second
            Typ: string · Input Video Secondnullable

            USD pro Sekunde Eingabevideo

          • internal_reasoning
            Typ: string · Internal Reasoningnullable

            USD pro Reasoning-Token

          • output_image
            Typ: string · Output Imagenullable

            USD pro generiertem Bild

          • output_image_token
            Typ: string · Output Image Tokennullable

            USD pro Ausgabebild-Token

          • output_video_second
            Typ: string · Output Video Secondnullable

            USD pro Sekunde generiertem Video

          • output_video_token
            Typ: string · Output Video Tokennullable

            USD per generated video token

          • prompt
            Typ: string · Promptnullable

            USD pro Eingabe-Token; null bedeutet nicht verfügbar, 0 bedeutet kostenlos

          • request
            Typ: string · Requestnullable

            USD pro Anfrage

          • web_search
            Typ: string · Web Searchnullable

            USD pro Websuche-Anfrage

        • markup_multiplier
          Typ: string · Markup Multipliernullable

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

        • pricing_mode
          Typ: string · Pricing Modeenum

          Konfigurierte Einheitstarife oder gemeldete Medienkosten multipliziert mit dem Verkaufsrabatt

          Werte
          • configured_rates
          • upstream_cost
        • reference_pricing
          nullable

          Public video reference before discount; not a final charge

          • as_of
            Typ: string · As Of
            erforderlich
          • canonical_slug
            Typ: string · Canonical Slug
            erforderlich
          • pricing_type
            Konstante:  
            per_second
            erforderlich
          • request_defaults
            Typ: object · Request Defaults
            erforderlich
            • propertyName
              • Typ: string
          • reservation
            Typ: object · VideoReservation
            erforderlich
            • max_duration_seconds
              Typ: integer · Max Duration Seconds
              größer als:  
              0
              erforderlich

              Integer numbers.

            • output_count
              Konstante:  
              1

              Integer numbers.

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

            Integer numbers.

        • sale_pricing
          Typ: object · VideoSalePricingnullable

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

          • basis
            Konstante:  
            sale_before_discount
            erforderlich
          • currency
            Konstante:  
            USD
            erforderlich
          • rows
            Typ: array object[] · Rows
            erforderlich

            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
              Typ: object · Conditions
              erforderlich

              Equality-condition summary; predicates retain the complete rule semantics

              • propertyName
                Typ: anything
            • rates
              Typ: object · Rates
              erforderlich

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

              • propertyName
                Typ: string
            • predicates
              Typ: array object[] | null · Predicatesnullable

              Ordered rule predicates including range comparisons

              • field
                Typ: string · Field
                erforderlich

                Felo-Preiskontext, z. B. input_context_tokens

              • operator
                Typ: string · Operatorenum
                erforderlich
                Werte
                • eq
                • gt
                • gte
              • value
                erforderlich
                • Typ: string · Value
          • minimum_charge_usd
            Typ: string · Minimum Charge Usdnullable

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

          • selection
            Konstante:  
            first_match

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

          • unit
            Typ: string · Unitnullable

            Primary billing unit, e.g. output_video_second or video_token

        • second_pricing
          Typ: object · VideoSecondPricingnullable

          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
            Konstante:  
            sale_before_discount
            erforderlich
          • currency
            Konstante:  
            USD
            erforderlich
          • rows
            Typ: array object[] · Rows
            erforderlich
            • estimated
              Typ: boolean · Estimated
              erforderlich

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

            • per_second_usd
              Typ: string · Per Second Usd
              erforderlich

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

            • aspect_ratio
              Typ: string · Aspect Rationullable
            • generate_audio
              Typ: boolean · Generate Audionullable
            • input_image_usd
              Typ: string · Input Image Usdnullable

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

            • input_mode
              Typ: string · Input Modenullable
            • predicates
              Typ: array object[] | null · Predicatesnullable

              Full conditions for this per-second price row

              • field
                Typ: string · Field
                erforderlich

                Felo-Preiskontext, z. B. input_context_tokens

              • operator
                Typ: string · Operatorenum
                erforderlich
                Werte
                • eq
                • gt
                • gte
              • value
                erforderlich
                • Typ: string · Value
            • resolution
              Typ: string · Resolutionnullable
          • second_basis
            Typ: string · Second Basisenum
            erforderlich

            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.

            Werte
            • exact
            • token_pixel_frames_estimate
          • pricing_type
            Typ: string · Pricing Typenullable

            per_second or video_token

        • settlement_policy
          Typ: object · PublicSettlementPolicynullable

          Published primary pricing and missing-usage fallback policy

          • fallback
            Typ: string · Fallbackenum
            erforderlich
            Werte
            • upstream_cost
            • review_required
          • primary
            Konstante:  
            configured_rates
            erforderlich
          • version
            Konstante:  
            1
            erforderlich

            Integer numbers.

      • default_channel
        Typ: string · Default Channelnullable
      • parameter_definitions
        Typ: 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
          Typ: object
          • propertyName
            Typ: anything
      • recommended_protocol
        Typ: string · Recommended Protocolenumnullable

        Nur eine modellweite Client-Empfehlung; null für Nicht-Chat-Modelle; schränkt aufrufbare Protokolle nicht ein

        Werte
        • responses
        • messages
    • locale
      Typ: string · Localeenum
      erforderlich
      Werte
      • en
      • zh-CN
      • zh-TW
      • ja
      • ko
    • schema_version
      Konstante:  
      2
      erforderlich

      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

Request Example for get/api/platform/model-catalog/model
curl 'https://openapi.felo.ai/api/platform/model-catalog/model?model='
{
  "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": {}
    }
  }
}
Get a public model by name

Brauchst du Hilfe?