Felo API PlatformFelo API Platform
v0.4.0
OpenAPI 3.1.0

Get a public model by name

Pelayan:https://openapi.felo.ai
Pustaka Klien

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 Pertanyaan
  • model
    Jenis: string
    panjang minimum:  
    1
    panjang maksimum:  
    256
    wajib

    Exact case-sensitive public model name or registered alias

  • locale
    Jenis: string enum

    Document language; falls back to English when unavailable

    nilai
    • en
    • zh-CN
    • zh-TW
    • ja
    • ko
Pengepala
  • If-None-Match
    Jenis: string

    Previous ETag; matching content returns 304

Respons
  • 200
    Jenis: object · ModelCatalogModelResponse

    Public model details

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

        Integer numbers.

      • description
        Jenis: string · Descriptionboleh null
        wajib
      • document
        Jenis: object · PublicDocumentboleh null
        wajib

        Bahasa terpilih sahaja; summary/description/best_for kekal pada model

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

          Masa kemas kini dokumen bahasa terpilih

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

        Integer numbers.

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

        Objek JSON penalaran huluan; mengekalkan medan tidak diketahui; null jika tiada

        • propertyName
          Jenis: anything
      • released_at
        Jenis: 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
        Jenis: string · Short Name
        wajib
      • slug
        Jenis: string · Slug
        wajib
      • sort_order
        Jenis: integer · Sort Order
        wajib

        Integer numbers.

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

          Skema JSON data sahaja untuk gabungan permintaan yang sah

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

              Integer numbers.

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

          Pengganda jualan tepat dari 0 hingga 1; gunakan sekali pada kadar dikonfigurasikan atau kos huluan

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

          Kadar unit standard sebelum diskaun jualan; null untuk saluran upstream_cost

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

            Kekalkan susunan; tahap pertama yang sepadan mengatasi kadar asas

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

                Konteks harga Felo, cth. input_context_tokens

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

            USD setiap token audio input

          • completion
            Jenis: string · Completionboleh null

            USD setiap token output

          • credit
            Jenis: string · Creditboleh null

            USD per credit; billed using the upstream call multiplier

          • input_audio_cache
            Jenis: string · Input Audio Cacheboleh null

            USD setiap token audio cache

          • input_cache_read
            Jenis: string · Input Cache Readboleh null

            USD setiap token input cache

          • input_cache_write
            Jenis: string · Input Cache Writeboleh null

            USD setiap token tulis cache

          • input_cache_write_12h
            Jenis: string · Input Cache Write 12Hboleh null

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

          • input_cache_write_1h
            Jenis: string · Input Cache Write 1Hboleh null

            USD setiap token tulis cache 1 jam; berasingan daripada tulisan TTL lalai

          • input_image
            Jenis: string · Input Imageboleh null

            USD setiap imej input

          • input_image_cache
            Jenis: string · Input Image Cacheboleh null

            USD per cached image token

          • input_image_token
            Jenis: string · Input Image Tokenboleh null

            USD setiap token imej input

          • input_video_second
            Jenis: string · Input Video Secondboleh null

            USD setiap saat video input

          • internal_reasoning
            Jenis: string · Internal Reasoningboleh null

            USD setiap token penalaran

          • output_image
            Jenis: string · Output Imageboleh null

            USD setiap imej yang dijana

          • output_image_token
            Jenis: string · Output Image Tokenboleh null

            USD setiap token imej output

          • output_video_second
            Jenis: string · Output Video Secondboleh null

            USD setiap saat video yang dijana

          • output_video_token
            Jenis: string · Output Video Tokenboleh null

            USD per generated video token

          • prompt
            Jenis: string · Promptboleh null

            USD setiap token input; null bermaksud tidak tersedia, 0 bermaksud percuma

          • request
            Jenis: string · Requestboleh null

            USD setiap permintaan

          • web_search
            Jenis: string · Web Searchboleh null

            USD setiap permintaan carian web

        • markup_multiplier
          Jenis: 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
          Jenis: string · Pricing Modeenum

          Kadar unit dikonfigurasikan, atau kos media dilaporkan didarab dengan diskaun jualan

          nilai
          • configured_rates
          • upstream_cost
        • reference_pricing
          boleh null

          Public video reference before discount; not a final charge

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

              Integer numbers.

            • output_count
              const:  
              1

              Integer numbers.

            • strategy
              const:  
              requested_duration_or_model_max
          • rows
            Jenis: array object[] · Rows
            wajib
            • input_image_billing
              Jenis: string · Input Image Billingenum
              wajib
              nilai
              • per_image
              • included
              • not_applicable
            • input_mode
              Jenis: string · Input Modeenum
              wajib
              nilai
              • text_to_video
              • image_to_video
              • first_last_frame
            • max_duration_output_estimate_usd
              Jenis: string · Max Duration Output Estimate Usd
              wajib
            • resolution
              Jenis: string · Resolution
              wajib
            • unit
              Jenis: string · Unitenum
              wajib
              nilai
              • output_video_second
              • video_token
            • unit_price_usd
              Jenis: string · Unit Price Usd
              wajib
            • aspect_ratio
              Jenis: string · Aspect Ratioboleh null
            • derived_output_second_usd
              Jenis: string · Derived Output Second Usdboleh null
            • generate_audio
              Jenis: boolean · Generate Audioboleh null
            • input_image_price_usd
              Jenis: string · Input Image Price Usdboleh null
            • reservation_supported
              const:  
              true
            • reservation_unavailable_reason
              Jenis: null · Reservation Unavailable Reason
            • size
              Jenis: string · Sizeboleh null
          • seed_supported
            Jenis: boolean · Seed Supported
            wajib
          • snapshot_id
            Jenis: string · Snapshot Id
            wajib
          • source_model_id
            Jenis: string · Source Model Id
            wajib
          • supported_aspect_ratios
            Jenis: array string[] · Supported Aspect Ratios
            wajib
          • supported_durations
            Jenis: array integer[] · Supported Durations
            wajib
          • supported_frame_images
            Jenis: array string[] · Supported Frame Images
            wajib
          • supported_resolutions
            Jenis: 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
          Jenis: 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
            Jenis: 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
              Jenis: object · Conditions
              wajib

              Equality-condition summary; predicates retain the complete rule semantics

              • propertyName
                Jenis: anything
            • rates
              Jenis: object · Rates
              wajib

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

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

              Ordered rule predicates including range comparisons

              • field
                Jenis: string · Field
                wajib

                Konteks harga Felo, cth. input_context_tokens

              • operator
                Jenis: string · Operatorenum
                wajib
                nilai
                • eq
                • gt
                • gte
              • value
                wajib
                • Jenis: string · Value
          • minimum_charge_usd
            Jenis: 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
            Jenis: string · Unitboleh null

            Primary billing unit, e.g. output_video_second or video_token

        • second_pricing
          Jenis: 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
            Jenis: array object[] · Rows
            wajib
            • estimated
              Jenis: boolean · Estimated
              wajib

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

            • per_second_usd
              Jenis: string · Per Second Usd
              wajib

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

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

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

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

              Full conditions for this per-second price row

              • field
                Jenis: string · Field
                wajib

                Konteks harga Felo, cth. input_context_tokens

              • operator
                Jenis: string · Operatorenum
                wajib
                nilai
                • eq
                • gt
                • gte
              • value
                wajib
                • Jenis: string · Value
            • resolution
              Jenis: string · Resolutionboleh null
          • second_basis
            Jenis: 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
            Jenis: string · Pricing Typeboleh null

            per_second or video_token

        • settlement_policy
          Jenis: object · PublicSettlementPolicyboleh null

          Published primary pricing and missing-usage fallback policy

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

            Integer numbers.

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

        Saranan klien merentas model sahaja; null untuk model bukan chat; tidak menyekat protokol yang boleh dipanggil

        nilai
        • responses
        • messages
    • locale
      Jenis: 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

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

Perlukan bantuan?