Felo API PlatformFelo API Platform
v0.4.0
OpenAPI 3.1.0

Get a public model by name

שרת:https://openapi.felo.ai
ספריות לקוח

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.

פרמטרי שאילתה
  • model
    סוג: string
    אורך מינימלי:  
    1
    אורך מקסימלי:  
    256
    חובה

    Exact case-sensitive public model name or registered alias

  • locale
    סוג: string enum

    Document language; falls back to English when unavailable

    ערכים
    • en
    • zh-CN
    • zh-TW
    • ja
    • ko
כותרות
  • If-None-Match
    סוג: string

    Previous ETag; matching content returns 304

תגובות
  • 200
    סוג: object · ModelCatalogModelResponse

    Public model details

    • data
      סוג: object · CatalogModel
      חובה
      • author
        סוג: string · Authorעשוי להיות null
        חובה
      • author_display_name
        סוג: string · Author Display Nameעשוי להיות null
        חובה
      • available_content_locales
        סוג: array string[] · Available Content Localesenum
        חובה
        ערכים
        • en
        • zh-CN
        • zh-TW
        • ja
        • ko
      • best_for
        סוג: array string[] · Best For
        חובה
      • capabilities
        סוג: array string[] · Capabilities
        חובה
      • content_locale
        סוג: string · Content Localeenumעשוי להיות null
        חובה
        ערכים
        • en
        • zh-CN
        • zh-TW
        • ja
        • ko
      • context_length
        סוג: integer · Context Lengthעשוי להיות null
        חובה

        Integer numbers.

      • description
        סוג: string · Descriptionעשוי להיות null
        חובה
      • document
        סוג: object · PublicDocumentעשוי להיות null
        חובה

        רק השפה הנבחרת; summary/description/best_for נשארים על המודל

        • extra
          סוג: object · Extra
          חובה
          • propertyName
            סוג: anything
        • notice
          סוג: object · CatalogNoticeעשוי להיות null
          חובה
          • body
            סוג: string · Body
            חובה
          • link_text
            סוג: string · Link Textעשוי להיות null
            חובה
          • target_slug
            סוג: string · Target Slugעשוי להיות null
            חובה
          • title
            סוג: string · Titleעשוי להיות null
            חובה
        • updated_at
          סוג: string · Updated At
          חובה

          זמן העדכון של מסמך השפה הנבחרת

      • icon_url
        סוג: string · Icon Urlעשוי להיות null
        חובה
      • id
        סוג: string · Id
        חובה
      • input_modalities
        סוג: array string[] · Input Modalities
        חובה
      • latency_class
        סוג: string · Latency Classעשוי להיות null
        חובה
      • max_completion_tokens
        סוג: integer · Max Completion Tokensעשוי להיות null
        חובה

        Integer numbers.

      • model_kind
        סוג: string · Model Kindenum
        חובה
        ערכים
        • chat
        • image_generation
        • video_generation
        • decisions
      • name
        סוג: string · Name
        חובה
      • output_modalities
        סוג: array string[] · Output Modalities
        חובה
      • reasoning
        סוג: object · Reasoningעשוי להיות null
        חובה

        אובייקט JSON של reasoning מהספק החיצוני; משמר שדות לא מוכרים; null כשאינו זמין

        • propertyName
          סוג: anything
      • released_at
        סוג: string · Released Atעשוי להיות null
        חובה

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

      • short_name
        סוג: string · Short Name
        חובה
      • slug
        סוג: string · Slug
        חובה
      • sort_order
        סוג: integer · Sort Order
        חובה

        Integer numbers.

      • summary
        סוג: string · Summaryעשוי להיות null
        חובה
      • supported_parameters
        סוג: array string[] · Supported Parameters
        חובה
      • trial_status
        סוג: string · Trial Status
        חובה
      • updated_at
        סוג: string · Updated Atעשוי להיות null
        חובה
      • video_spec
        סוג: object · VideoSpecעשוי להיות null
        חובה
        • aspect_ratios
          סוג: array string[] | null · Aspect Ratiosעשוי להיות null
        • audio
          סוג: object · AudioSpecעשוי להיות null
          • input
            סוג: boolean · Inputעשוי להיות null
          • output
            סוג: boolean · Outputעשוי להיות null
          • output_optional
            סוג: boolean · Output Optionalעשוי להיות null
        • constraints
          סוג: object · Constraintsעשוי להיות null

          JSON Schema של נתונים בלבד עבור שילובי בקשות חוקיים

          • propertyName
            סוג: anything
        • duration_seconds
          סוג: object · DurationSpecעשוי להיות null
          • max
            סוג: number · Max
            גדול מ:  
            0
            חובה
          • min
            סוג: number · Min
            מינימום:  
            0
            חובה
          • step
            סוג: number · Step
            גדול מ:  
            0
            חובה
        • example_request
          סוג: object · Example Requestעשוי להיות null
          • propertyName
            סוג: anything
        • input_modes
          סוג: array string[] | null · Input Modesעשוי להיות null
        • reference_limits
          סוג: object · Reference Limitsעשוי להיות null
          • propertyName
            עשוי להיות null
            • סוג: integer

              Integer numbers.

        • request_defaults
          סוג: object · Request Defaultsעשוי להיות null
          • propertyName
            סוג: anything
        • resolutions
          סוג: array string[] | null · Resolutionsעשוי להיות null
      • channels
        סוג: array object[] · Channels
        • code
          סוג: string · Code
          חובה
        • discount_multiplier
          סוג: string · Discount Multiplierעשוי להיות null
          חובה

          מכפיל מכירה מדויק מ-0 עד 1; החילו פעם אחת על התעריפים המוגדרים או על עלות ה-upstream

        • is_default
          סוג: boolean · Is Default
          חובה
        • name
          סוג: string · Name
          חובה
        • region
          סוג: string · Regionעשוי להיות null
          חובה
        • runnable
          סוג: boolean · Runnable
          חובה
        • service_tier
          סוג: string · Service Tier
          חובה
        • standard_pricing
          סוג: object · CatalogPricingעשוי להיות null
          חובה

          תעריפי יחידה סטנדרטיים לפני הנחת המכירה; null עבור ערוצי upstream_cost

          • basis
            const:  
            standard
            חובה
          • billing_kind
            סוג: string · Billing Kind
            חובה
          • channel
            סוג: string · Channel
            חובה
          • currency
            const:  
            USD
            חובה
          • tiers
            סוג: array object[] · Tiers
            חובה

            שמרו על הסדר; הדרגה המתאימה הראשונה עוקפת את תעריפי הבסיס

            • conditions
              סוג: array object[] · Conditions
              חובה
              • field
                סוג: string · Field
                חובה

                הקשר תמחור של Felo, למשל input_context_tokens

              • operator
                סוג: string · Operatorenum
                חובה
                ערכים
                • eq
                • gt
                • gte
              • value
                חובה
                • סוג: string · Value
            • overrides
              סוג: object · Overrides
              חובה
              • propertyName
                סוג: string
          • audio
            סוג: string · Audioעשוי להיות null

            דולר ארה״ב לכל טוקן שמע בקלט

          • completion
            סוג: string · Completionעשוי להיות null

            דולר ארה״ב לכל טוקן פלט

          • credit
            סוג: string · Creditעשוי להיות null

            USD per credit; billed using the upstream call multiplier

          • input_audio_cache
            סוג: string · Input Audio Cacheעשוי להיות null

            דולר ארה״ב לכל טוקן שמע מה-cache

          • input_cache_read
            סוג: string · Input Cache Readעשוי להיות null

            דולר ארה״ב לכל טוקן קלט מה-cache

          • input_cache_write
            סוג: string · Input Cache Writeעשוי להיות null

            דולר ארה״ב לכל טוקן כתיבה ל-cache

          • input_cache_write_12h
            סוג: string · Input Cache Write 12Hעשוי להיות null

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

          • input_cache_write_1h
            סוג: string · Input Cache Write 1Hעשוי להיות null

            דולר ארה״ב לכל טוקן כתיבה ל-cache של שעה; בנפרד מכתיבות ה-TTL מברירת המחדל

          • input_image
            סוג: string · Input Imageעשוי להיות null

            דולר ארה״ב לכל תמונת קלט

          • input_image_cache
            סוג: string · Input Image Cacheעשוי להיות null

            USD per cached image token

          • input_image_token
            סוג: string · Input Image Tokenעשוי להיות null

            דולר ארה״ב לכל טוקן תמונה בקלט

          • input_video_second
            סוג: string · Input Video Secondעשוי להיות null

            דולר ארה״ב לכל שניית וידאו בקלט

          • internal_reasoning
            סוג: string · Internal Reasoningעשוי להיות null

            דולר ארה״ב לכל טוקן reasoning

          • output_image
            סוג: string · Output Imageעשוי להיות null

            דולר ארה״ב לכל תמונה שנוצרה

          • output_image_token
            סוג: string · Output Image Tokenעשוי להיות null

            דולר ארה״ב לכל טוקן תמונה בפלט

          • output_video_second
            סוג: string · Output Video Secondעשוי להיות null

            דולר ארה״ב לכל שניית וידאו שנוצרה

          • output_video_token
            סוג: string · Output Video Tokenעשוי להיות null

            USD per generated video token

          • prompt
            סוג: string · Promptעשוי להיות null

            דולר ארה״ב לכל טוקן קלט; null פירושו לא זמין, 0 פירושו חינם

          • request
            סוג: string · Requestעשוי להיות null

            דולר ארה״ב לכל בקשה

          • web_search
            סוג: string · Web Searchעשוי להיות null

            דולר ארה״ב לכל בקשת חיפוש באינטרנט

        • markup_multiplier
          סוג: string · Markup Multiplierעשוי להיות null

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

        • pricing_mode
          סוג: string · Pricing Modeenum

          תעריפי יחידה מוגדרים, או עלות המדיה המדווחת מוכפלת בהנחת המכירה

          ערכים
          • configured_rates
          • upstream_cost
        • reference_pricing
          עשוי להיות null

          Public video reference before discount; not a final charge

          • as_of
            סוג: string · As Of
            חובה
          • canonical_slug
            סוג: string · Canonical Slug
            חובה
          • pricing_type
            const:  
            per_second
            חובה
          • request_defaults
            סוג: object · Request Defaults
            חובה
            • propertyName
              • סוג: string
          • reservation
            סוג: object · VideoReservation
            חובה
            • max_duration_seconds
              סוג: integer · Max Duration Seconds
              גדול מ:  
              0
              חובה

              Integer numbers.

            • output_count
              const:  
              1

              Integer numbers.

            • strategy
              const:  
              requested_duration_or_model_max
          • rows
            סוג: array object[] · Rows
            חובה
            • input_image_billing
              סוג: string · Input Image Billingenum
              חובה
              ערכים
              • per_image
              • included
              • not_applicable
            • input_mode
              סוג: string · Input Modeenum
              חובה
              ערכים
              • text_to_video
              • image_to_video
              • first_last_frame
            • max_duration_output_estimate_usd
              סוג: string · Max Duration Output Estimate Usd
              חובה
            • resolution
              סוג: string · Resolution
              חובה
            • unit
              סוג: string · Unitenum
              חובה
              ערכים
              • output_video_second
              • video_token
            • unit_price_usd
              סוג: string · Unit Price Usd
              חובה
            • aspect_ratio
              סוג: string · Aspect Ratioעשוי להיות null
            • derived_output_second_usd
              סוג: string · Derived Output Second Usdעשוי להיות null
            • generate_audio
              סוג: boolean · Generate Audioעשוי להיות null
            • input_image_price_usd
              סוג: string · Input Image Price Usdעשוי להיות null
            • reservation_supported
              const:  
              true
            • reservation_unavailable_reason
              סוג: null · Reservation Unavailable Reason
            • size
              סוג: string · Sizeעשוי להיות null
          • seed_supported
            סוג: boolean · Seed Supported
            חובה
          • snapshot_id
            סוג: string · Snapshot Id
            חובה
          • source_model_id
            סוג: string · Source Model Id
            חובה
          • supported_aspect_ratios
            סוג: array string[] · Supported Aspect Ratios
            חובה
          • supported_durations
            סוג: array integer[] · Supported Durations
            חובה
          • supported_frame_images
            סוג: array string[] · Supported Frame Images
            חובה
          • supported_resolutions
            סוג: array string[] · Supported Resolutions
            חובה
          • basis
            const:  
            public_reference_before_discount
          • currency
            const:  
            USD
          • settlement_basis
            const:  
            upstream_cost
          • version
            const:  
            1

            Integer numbers.

        • sale_pricing
          סוג: object · VideoSalePricingעשוי להיות 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
            חובה
          • currency
            const:  
            USD
            חובה
          • rows
            סוג: array object[] · Rows
            חובה

            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
              סוג: object · Conditions
              חובה

              Equality-condition summary; predicates retain the complete rule semantics

              • propertyName
                סוג: anything
            • rates
              סוג: object · Rates
              חובה

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

              • propertyName
                סוג: string
            • predicates
              סוג: array object[] | null · Predicatesעשוי להיות null

              Ordered rule predicates including range comparisons

              • field
                סוג: string · Field
                חובה

                הקשר תמחור של Felo, למשל input_context_tokens

              • operator
                סוג: string · Operatorenum
                חובה
                ערכים
                • eq
                • gt
                • gte
              • value
                חובה
                • סוג: string · Value
          • minimum_charge_usd
            סוג: string · Minimum Charge Usdעשוי להיות 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
            סוג: string · Unitעשוי להיות null

            Primary billing unit, e.g. output_video_second or video_token

        • second_pricing
          סוג: object · VideoSecondPricingעשוי להיות 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
            חובה
          • currency
            const:  
            USD
            חובה
          • rows
            סוג: array object[] · Rows
            חובה
            • estimated
              סוג: boolean · Estimated
              חובה

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

            • per_second_usd
              סוג: string · Per Second Usd
              חובה

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

            • aspect_ratio
              סוג: string · Aspect Ratioעשוי להיות null
            • generate_audio
              סוג: boolean · Generate Audioעשוי להיות null
            • input_image_usd
              סוג: string · Input Image Usdעשוי להיות null

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

            • input_mode
              סוג: string · Input Modeעשוי להיות null
            • predicates
              סוג: array object[] | null · Predicatesעשוי להיות null

              Full conditions for this per-second price row

              • field
                סוג: string · Field
                חובה

                הקשר תמחור של Felo, למשל input_context_tokens

              • operator
                סוג: string · Operatorenum
                חובה
                ערכים
                • eq
                • gt
                • gte
              • value
                חובה
                • סוג: string · Value
            • resolution
              סוג: string · Resolutionעשוי להיות null
          • second_basis
            סוג: string · Second Basisenum
            חובה

            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.

            ערכים
            • exact
            • token_pixel_frames_estimate
          • pricing_type
            סוג: string · Pricing Typeעשוי להיות null

            per_second or video_token

        • settlement_policy
          סוג: object · PublicSettlementPolicyעשוי להיות null

          Published primary pricing and missing-usage fallback policy

          • fallback
            סוג: string · Fallbackenum
            חובה
            ערכים
            • upstream_cost
            • review_required
          • primary
            const:  
            configured_rates
            חובה
          • version
            const:  
            1
            חובה

            Integer numbers.

      • default_channel
        סוג: string · Default Channelעשוי להיות null
      • parameter_definitions
        סוג: 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
          סוג: object
          • propertyName
            סוג: anything
      • recommended_protocol
        סוג: string · Recommended Protocolenumעשוי להיות null

        המלצה ללקוח ברמת המודל בלבד; null עבור מודלים שאינם צ'אט; אינה מגבילה פרוטוקולים ניתנים לקריאה

        ערכים
        • responses
        • messages
    • locale
      סוג: string · Localeenum
      חובה
      ערכים
      • en
      • zh-CN
      • zh-TW
      • ja
      • ko
    • schema_version
      const:  
      2
      חובה

      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

צריך עזרה?