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 列挙値

    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 · Authornull 許容
        必須
      • author_display_name
        型: string · Author Display Namenull 許容
        必須
      • available_content_locales
        型: array string[] · Available Content Locales列挙値
        必須
        値
        • en
        • zh-CN
        • zh-TW
        • ja
        • ko
      • best_for
        型: array string[] · Best For
        必須
      • capabilities
        型: array string[] · Capabilities
        必須
      • content_locale
        型: string · Content Locale列挙値null 許容
        必須
        値
        • en
        • zh-CN
        • zh-TW
        • ja
        • ko
      • context_length
        型: integer · Context Lengthnull 許容
        必須

        Integer numbers.

      • description
        型: string · Descriptionnull 許容
        必須
      • document
        型: object · PublicDocumentnull 許容
        必須

        選択した言語のみ。summary/description/best_for はモデル側に保持されます

        • extra
          型: object · Extra
          必須
          • propertyName
            型: anything
        • notice
          型: object · CatalogNoticenull 許容
          必須
          • body
            型: string · Body
            必須
          • link_text
            型: string · Link Textnull 許容
            必須
          • target_slug
            型: string · Target Slugnull 許容
            必須
          • title
            型: string · Titlenull 許容
            必須
        • updated_at
          型: string · Updated At
          必須

          選択した言語のドキュメントの更新日時

      • icon_url
        型: string · Icon Urlnull 許容
        必須
      • id
        型: string · Id
        必須
      • input_modalities
        型: array string[] · Input Modalities
        必須
      • latency_class
        型: string · Latency Classnull 許容
        必須
      • max_completion_tokens
        型: integer · Max Completion Tokensnull 許容
        必須

        Integer numbers.

      • model_kind
        型: string · Model Kind列挙値
        必須
        値
        • chat
        • image_generation
        • video_generation
        • decisions
      • name
        型: string · Name
        必須
      • output_modalities
        型: array string[] · Output Modalities
        必須
      • reasoning
        型: object · Reasoningnull 許容
        必須

        上流の reasoning JSON オブジェクト。不明なフィールドを保持します。利用できない場合は null

        • propertyName
          型: anything
      • released_at
        型: string · Released Atnull 許容
        必須

        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 · Summarynull 許容
        必須
      • supported_parameters
        型: array string[] · Supported Parameters
        必須
      • trial_status
        型: string · Trial Status
        必須
      • updated_at
        型: string · Updated Atnull 許容
        必須
      • video_spec
        型: object · VideoSpecnull 許容
        必須
        • aspect_ratios
          型: array string[] | null · Aspect Ratiosnull 許容
        • audio
          型: object · AudioSpecnull 許容
          • input
            型: boolean · Inputnull 許容
          • output
            型: boolean · Outputnull 許容
          • output_optional
            型: boolean · Output Optionalnull 許容
        • constraints
          型: object · Constraintsnull 許容

          有効なリクエストの組み合わせを示すデータ専用の JSON Schema

          • propertyName
            型: anything
        • duration_seconds
          型: object · DurationSpecnull 許容
          • max
            型: number · Max
            より大きい:  
            0
            必須
          • min
            型: number · Min
            最小値:  
            0
            必須
          • step
            型: number · Step
            より大きい:  
            0
            必須
        • example_request
          型: object · Example Requestnull 許容
          • propertyName
            型: anything
        • input_modes
          型: array string[] | null · Input Modesnull 許容
        • reference_limits
          型: object · Reference Limitsnull 許容
          • propertyName
            null 許容
            • 型: integer

              Integer numbers.

        • request_defaults
          型: object · Request Defaultsnull 許容
          • propertyName
            型: anything
        • resolutions
          型: array string[] | null · Resolutionsnull 許容
      • channels
        型: array object[] · Channels
        • code
          型: string · Code
          必須
        • discount_multiplier
          型: string · Discount Multipliernull 許容
          必須

          0 から 1 の正確な販売乗数。設定済みの料金または上流コストに 1 回だけ適用します

        • is_default
          型: boolean · Is Default
          必須
        • name
          型: string · Name
          必須
        • region
          型: string · Regionnull 許容
          必須
        • runnable
          型: boolean · Runnable
          必須
        • service_tier
          型: string · Service Tier
          必須
        • standard_pricing
          型: object · CatalogPricingnull 許容
          必須

          販売時の割引前の標準単価。upstream_cost チャンネルでは null

          • basis
            定数:  
            standard
            必須
          • billing_kind
            型: string · Billing Kind
            必須
          • channel
            型: string · Channel
            必須
          • currency
            定数:  
            USD
            必須
          • tiers
            型: array object[] · Tiers
            必須

            順序を保持します。最初に一致したティアが基本料金を上書きします

            • conditions
              型: array object[] · Conditions
              必須
              • field
                型: string · Field
                必須

                Felo の料金コンテキスト(例:input_context_tokens)

              • operator
                型: string · Operator列挙値
                必須
                値
                • eq
                • gt
                • gte
              • value
                必須
                • 型: string · Value
            • overrides
              型: object · Overrides
              必須
              • propertyName
                型: string
          • audio
            型: string · Audionull 許容

            入力音声トークンあたりの USD

          • completion
            型: string · Completionnull 許容

            出力トークンあたりの USD

          • credit
            型: string · Creditnull 許容

            USD per credit; billed using the upstream call multiplier

          • input_audio_cache
            型: string · Input Audio Cachenull 許容

            キャッシュされた音声トークンあたりの USD

          • input_cache_read
            型: string · Input Cache Readnull 許容

            キャッシュされた入力トークンあたりの USD

          • input_cache_write
            型: string · Input Cache Writenull 許容

            キャッシュ書き込みトークンあたりの USD

          • input_cache_write_12h
            型: string · Input Cache Write 12Hnull 許容

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

          • input_cache_write_1h
            型: string · Input Cache Write 1Hnull 許容

            1 時間のキャッシュ書き込みトークンあたりの USD。既定の TTL 書き込みとは別です

          • input_image
            型: string · Input Imagenull 許容

            入力画像あたりの USD

          • input_image_cache
            型: string · Input Image Cachenull 許容

            USD per cached image token

          • input_image_token
            型: string · Input Image Tokennull 許容

            入力画像トークンあたりの USD

          • input_video_second
            型: string · Input Video Secondnull 許容

            入力動画 1 秒あたりの USD

          • internal_reasoning
            型: string · Internal Reasoningnull 許容

            推論トークンあたりの USD

          • output_image
            型: string · Output Imagenull 許容

            生成画像あたりの USD

          • output_image_token
            型: string · Output Image Tokennull 許容

            出力画像トークンあたりの USD

          • output_video_second
            型: string · Output Video Secondnull 許容

            生成動画 1 秒あたりの USD

          • output_video_token
            型: string · Output Video Tokennull 許容

            USD per generated video token

          • prompt
            型: string · Promptnull 許容

            入力トークンあたりの USD。null は利用不可、0 は無料を意味します

          • request
            型: string · Requestnull 許容

            リクエストあたりの USD

          • web_search
            型: string · Web Searchnull 許容

            ウェブ検索リクエストあたりの USD

        • markup_multiplier
          型: string · Markup Multipliernull 許容

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

        • pricing_mode
          型: string · Pricing Mode列挙値

          設定済みの単価、または報告されたメディアコストに販売時の割引率を掛けたもの

          値
          • 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
            定数:  
            per_second
            必須
          • request_defaults
            型: object · Request Defaults
            必須
            • propertyName
              • 型: string
          • reservation
            型: object · VideoReservation
            必須
            • max_duration_seconds
              型: integer · Max Duration Seconds
              より大きい:  
              0
              必須

              Integer numbers.

            • output_count
              定数:  
              1

              Integer numbers.

            • strategy
              定数:  
              requested_duration_or_model_max
          • rows
            型: array object[] · Rows
            必須
            • input_image_billing
              型: string · Input Image Billing列挙値
              必須
              値
              • per_image
              • included
              • not_applicable
            • input_mode
              型: string · Input Mode列挙値
              必須
              値
              • 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 · Unit列挙値
              必須
              値
              • output_video_second
              • video_token
            • unit_price_usd
              型: string · Unit Price Usd
              必須
            • aspect_ratio
              型: string · Aspect Rationull 許容
            • derived_output_second_usd
              型: string · Derived Output Second Usdnull 許容
            • generate_audio
              型: boolean · Generate Audionull 許容
            • input_image_price_usd
              型: string · Input Image Price Usdnull 許容
            • reservation_supported
              定数:  
              true
            • reservation_unavailable_reason
              型: null · Reservation Unavailable Reason
            • size
              型: string · Sizenull 許容
          • 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
            定数:  
            public_reference_before_discount
          • currency
            定数:  
            USD
          • settlement_basis
            定数:  
            upstream_cost
          • version
            定数:  
            1

            Integer numbers.

        • sale_pricing
          型: object · VideoSalePricingnull 許容

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

          • basis
            定数:  
            sale_before_discount
            必須
          • currency
            定数:  
            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 · Predicatesnull 許容

              Ordered rule predicates including range comparisons

              • field
                型: string · Field
                必須

                Felo の料金コンテキスト(例:input_context_tokens)

              • operator
                型: string · Operator列挙値
                必須
                値
                • eq
                • gt
                • gte
              • value
                必須
                • 型: string · Value
          • minimum_charge_usd
            型: string · Minimum Charge Usdnull 許容

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

          • selection
            定数:  
            first_match

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

          • unit
            型: string · Unitnull 許容

            Primary billing unit, e.g. output_video_second or video_token

        • second_pricing
          型: object · VideoSecondPricingnull 許容

          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
            定数:  
            sale_before_discount
            必須
          • currency
            定数:  
            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 Rationull 許容
            • generate_audio
              型: boolean · Generate Audionull 許容
            • input_image_usd
              型: string · Input Image Usdnull 許容

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

            • input_mode
              型: string · Input Modenull 許容
            • predicates
              型: array object[] | null · Predicatesnull 許容

              Full conditions for this per-second price row

              • field
                型: string · Field
                必須

                Felo の料金コンテキスト(例:input_context_tokens)

              • operator
                型: string · Operator列挙値
                必須
                値
                • eq
                • gt
                • gte
              • value
                必須
                • 型: string · Value
            • resolution
              型: string · Resolutionnull 許容
          • second_basis
            型: string · Second Basis列挙値
            必須

            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 Typenull 許容

            per_second or video_token

        • settlement_policy
          型: object · PublicSettlementPolicynull 許容

          Published primary pricing and missing-usage fallback policy

          • fallback
            型: string · Fallback列挙値
            必須
            値
            • upstream_cost
            • review_required
          • primary
            定数:  
            configured_rates
            必須
          • version
            定数:  
            1
            必須

            Integer numbers.

      • default_channel
        型: string · Default Channelnull 許容
      • 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 Protocol列挙値null 許容

        モデル全体に対するクライアント向けの推奨のみ。非チャットモデルでは null。呼び出せるプロトコルを制限するものではありません

        値
        • responses
        • messages
    • locale
      型: string · Locale列挙値
      必須
      値
      • en
      • zh-CN
      • zh-TW
      • ja
      • ko
    • schema_version
      定数:  
      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

ヘルプが必要ですか?

  • API・請求・アカウントのご質問はサポートへ。
  • Discord で Felo の開発者と交流できます。
  • 更新履歴 をご覧ください。
  • ボリューム価格や購買についてのご相談は営業窓口へ。
  • LLM での構築をお考えですか?llms.txt をご覧ください。