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 사이의 정확한 판매 배수이며, 구성된 요율 또는 업스트림 비용에 한 번 적용합니다

        • 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 허용

            입력 영상 초당 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 허용

            생성된 영상 초당 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를 읽어 보세요.