Felo API PlatformFelo API Platform
v0.4.0
OpenAPI 3.1.0

خواندن فهرست ناشناس مدل‌ها

سرور:https://openapi.felo.ai
کتابخانه‌های کلاینت

خواندن فهرست ناشناس مدل‌ها

​

فهرست ناشناس مدل‌ها، schema_version=2. کانال‌ها pricing_mode، standard_pricing و discount_multiplier را افشا می‌کنند. کانال‌های upstream_cost از هزینه تصویر یا ویدیوی گزارش‌شده ضرب‌در تخفیف ثابت‌شده استفاده می‌کنند؛ standard_pricing آن‌ها null است، نه صفر. default_channel کد کانال پیش‌فرض را مشخص می‌کند. recommended_protocol یک توصیه کلاینت در سطح مدل است (responses/messages، برای مدل‌های غیرچت null)، نه محدودیت پروتکل. هیچ پیکربندی پروتکل یا فراداده Playground برگردانده نمی‌شود. reasoning شیء JSON بالادست را حفظ می‌کند، یا در صورت عدم دسترسی null است.

پارامترهای پرس‌وجو
  • locale
    نوع: string فهرست مقادیر
    مقادیر
    • en
    • zh-CN
    • zh-TW
    • ja
    • ko
  • q
    نوع: string
  • id
    نوع: string
  • model_kind
    نوع: string فهرست مقادیر
    مقادیر
    • chat
    • image_generation
    • video_generation
    • decisions
  • fmt
    نوع: string فهرست مقادیر
    مقادیر
    • cards
    • full
هدرها
  • If-None-Match
    نوع: string
پاسخ‌ها
  • 200
    نوع: object · ModelCatalogResponse

    مدل‌های قابل مشاهده؛ شناسه ناشناخته دقیق آرایه خالی برمی‌گرداند.

    • data
      نوع: object · CatalogData
      الزامی
      • models
        نوع: array object[] · Models
        الزامی
        • author
          نوع: string · Authorتهی‌پذیر
          الزامی
        • author_display_name
          نوع: string · Author Display Nameتهی‌پذیر
          الزامی
        • 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فهرست مقادیرتهی‌پذیر
          الزامی
          مقادیر
          • en
          • zh-CN
          • zh-TW
          • ja
          • ko
        • context_length
          نوع: integer · Context Lengthتهی‌پذیر
          الزامی

          Integer numbers.

        • description
          نوع: string · Descriptionتهی‌پذیر
          الزامی
        • document
          نوع: object · PublicDocumentتهی‌پذیر
          الزامی

          فقط زبان انتخاب‌شده؛ summary/description/best_for روی مدل می‌مانند

          • extra
            نوع: object · Extra
            الزامی
            • propertyName
              نوع: anything
          • notice
            نوع: object · CatalogNoticeتهی‌پذیر
            الزامی
            • body
              نوع: string · Body
              الزامی
            • link_text
              نوع: string · Link Textتهی‌پذیر
              الزامی
            • target_slug
              نوع: string · Target Slugتهی‌پذیر
              الزامی
            • title
              نوع: string · Titleتهی‌پذیر
              الزامی
          • updated_at
            نوع: string · Updated At
            الزامی

            زمان به‌روزرسانی سند زبان انتخاب‌شده

        • icon_url
          نوع: string · Icon Urlتهی‌پذیر
          الزامی
        • id
          نوع: string · Id
          الزامی
        • input_modalities
          نوع: array string[] · Input Modalities
          الزامی
        • latency_class
          نوع: string · Latency Classتهی‌پذیر
          الزامی
        • max_completion_tokens
          نوع: integer · Max Completion Tokensتهی‌پذیر
          الزامی

          Integer numbers.

        • model_kind
          نوع: string · Model Kindفهرست مقادیر
          الزامی
          مقادیر
          • chat
          • image_generation
          • video_generation
          • decisions
        • name
          نوع: string · Name
          الزامی
        • output_modalities
          نوع: array string[] · Output Modalities
          الزامی
        • reasoning
          نوع: object · Reasoningتهی‌پذیر
          الزامی

          شیء JSON استدلال بالادست؛ فیلدهای ناشناخته را حفظ می‌کند؛ در صورت عدم دسترسی null

          • propertyName
            نوع: anything
        • released_at
          نوع: string · Released Atتهی‌پذیر
          الزامی
        • short_name
          نوع: string · Short Name
          الزامی
        • slug
          نوع: string · Slug
          الزامی
        • sort_order
          نوع: integer · Sort Order
          الزامی

          Integer numbers.

        • summary
          نوع: string · Summaryتهی‌پذیر
          الزامی
        • supported_parameters
          نوع: array string[] · Supported Parameters
          الزامی
        • trial_status
          نوع: string · Trial Status
          الزامی
        • updated_at
          نوع: string · Updated Atتهی‌پذیر
          الزامی
        • video_spec
          نوع: object · VideoSpecتهی‌پذیر
          الزامی
          • aspect_ratios
            نوع: array string[] | null · Aspect Ratiosتهی‌پذیر
          • audio
            نوع: object · AudioSpecتهی‌پذیر
            • input
              نوع: boolean · Inputتهی‌پذیر
            • output
              نوع: boolean · Outputتهی‌پذیر
            • output_optional
              نوع: boolean · Output Optionalتهی‌پذیر
          • constraints
            نوع: object · Constraintsتهی‌پذیر

            JSON Schema فقط‌داده برای ترکیب‌های معتبر درخواست

            • propertyName
              نوع: anything
          • duration_seconds
            نوع: object · DurationSpecتهی‌پذیر
            • max
              نوع: number · Max
              بزرگ‌تر از:  
              0
              الزامی
            • min
              نوع: number · Min
              حداقل:  
              0
              الزامی
            • step
              نوع: number · Step
              بزرگ‌تر از:  
              0
              الزامی
          • example_request
            نوع: object · Example Requestتهی‌پذیر
            • propertyName
              نوع: anything
          • input_modes
            نوع: array string[] | null · Input Modesتهی‌پذیر
          • reference_limits
            نوع: object · Reference Limitsتهی‌پذیر
            • propertyName
              تهی‌پذیر
              • نوع: integer

                Integer numbers.

          • request_defaults
            نوع: object · Request Defaultsتهی‌پذیر
            • propertyName
              نوع: anything
          • resolutions
            نوع: array string[] | null · Resolutionsتهی‌پذیر
        • channels
          نوع: array object[] · Channels
          • code
            نوع: string · Code
            الزامی
          • discount_multiplier
            نوع: string · Discount Multiplierتهی‌پذیر
            الزامی

            ضریب فروش دقیق از 0 تا 1؛ یک‌بار روی نرخ‌های پیکربندی‌شده یا هزینه بالادست اعمال شود

          • is_default
            نوع: boolean · Is Default
            الزامی
          • name
            نوع: string · Name
            الزامی
          • region
            نوع: string · Regionتهی‌پذیر
            الزامی
          • runnable
            نوع: boolean · Runnable
            الزامی
          • service_tier
            نوع: string · Service Tier
            الزامی
          • standard_pricing
            نوع: object · CatalogPricingتهی‌پذیر
            الزامی

            نرخ‌های واحد استاندارد پیش از تخفیف فروش؛ برای کانال‌های 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 · Audioتهی‌پذیر

              دلار آمریکا به ازای هر توکن صدای ورودی

            • completion
              نوع: string · Completionتهی‌پذیر

              دلار آمریکا به ازای هر توکن خروجی

            • input_audio_cache
              نوع: string · Input Audio Cacheتهی‌پذیر

              دلار آمریکا به ازای هر توکن صدای کش‌شده

            • input_cache_read
              نوع: string · Input Cache Readتهی‌پذیر

              دلار آمریکا به ازای هر توکن ورودی کش‌شده

            • input_cache_write
              نوع: string · Input Cache Writeتهی‌پذیر

              دلار آمریکا به ازای هر توکن نوشتن کش

            • input_cache_write_1h
              نوع: string · Input Cache Write 1Hتهی‌پذیر

              دلار آمریکا به ازای هر توکن نوشتن کش 1 ساعته؛ جدا از نوشتن‌های TTL پیش‌فرض

            • input_image
              نوع: string · Input Imageتهی‌پذیر

              دلار آمریکا به ازای هر تصویر ورودی

            • input_image_token
              نوع: string · Input Image Tokenتهی‌پذیر

              دلار آمریکا به ازای هر توکن تصویر ورودی

            • input_video_second
              نوع: string · Input Video Secondتهی‌پذیر

              دلار آمریکا به ازای هر ثانیه ویدیوی ورودی

            • internal_reasoning
              نوع: string · Internal Reasoningتهی‌پذیر

              دلار آمریکا به ازای هر توکن استدلال

            • output_image
              نوع: string · Output Imageتهی‌پذیر

              دلار آمریکا به ازای هر تصویر تولیدشده

            • output_image_token
              نوع: string · Output Image Tokenتهی‌پذیر

              دلار آمریکا به ازای هر توکن تصویر خروجی

            • output_video_second
              نوع: string · Output Video Secondتهی‌پذیر

              دلار آمریکا به ازای هر ثانیه ویدیوی تولیدشده

            • prompt
              نوع: string · Promptتهی‌پذیر

              دلار آمریکا به ازای هر توکن ورودی؛ null یعنی در دسترس نیست، 0 یعنی رایگان

            • request
              نوع: string · Requestتهی‌پذیر

              دلار آمریکا به ازای هر درخواست

            • web_search
              نوع: string · Web Searchتهی‌پذیر

              دلار آمریکا به ازای هر درخواست جستجوی وب

          • pricing_mode
            نوع: string · Pricing Modeفهرست مقادیر

            نرخ‌های واحد پیکربندی‌شده، یا هزینه رسانه گزارش‌شده ضرب‌در تخفیف فروش

            مقادیر
            • configured_rates
            • upstream_cost
        • default_channel
          نوع: string · Default Channelتهی‌پذیر
        • recommended_protocol
          نوع: string · Recommended Protocolفهرست مقادیرتهی‌پذیر

          فقط توصیه کلاینت در سطح مدل؛ برای مدل‌های غیرچت null؛ پروتکل‌های قابل فراخوانی را محدود نمی‌کند

          مقادیر
          • responses
          • messages
      • total
        نوع: integer · Total
        الزامی

        Integer numbers.

    • locale
      نوع: string · Localeفهرست مقادیر
      الزامی
      مقادیر
      • en
      • zh-CN
      • zh-TW
      • ja
      • ko
    • schema_version
      مقدار ثابت:  
      2
      الزامی

      Integer numbers.

    application/json
  • 304

    بازنمایی بدون تغییر؛ بدنه خالی

  • 400

    زبان پشتیبانی‌نشده

  • 422

    projection یا kind نامعتبر

  • 503

    فهرست موقتاً در دسترس نیست

Request Example for get/api/platform/model-catalog
curl https://openapi.felo.ai/api/platform/model-catalog
{
  "schema_version": 2,
  "locale": "en",
  "data": {
    "total": 1,
    "models": [
      {
        "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": "مدل نمونه.",
        "description": "متن توضیحی، نه یک مدل واقعی.",
        "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",
              "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"
          }
        ]
      }
    ]
  }
}
Read the anonymous model catalog