Get model filter options¶

Get model counts by type, series, and pricing status for catalog filters.

GET https://billing.moi.matrixorigin.cn/api/v1/taas/models/filter-options

Before you begin¶

Prepare a personal access token. For creation and management, see Manage personal access tokens.

Results are scoped to data accessible to the current user.

Query parameters¶

Replace $MOI_PERSONAL_ACCESS_TOKEN in the example with your personal access token.

Request example

curl --get "https://billing.moi.matrixorigin.cn/api/v1/taas/models/filter-options" \
  -H "X-API-Key: $MOI_PERSONAL_ACCESS_TOKEN"

Parameters

Parameter	Type	Required	Description
`status`	string	No	Filter by enabled status.
`q`	string	No	Search name, alias, description, series, type, or provider name.
`search`	string	No	Search term used when `q` is empty.
`search_logos`	string	No	Add series matches to the search; repeat or comma-separate values.
`search_types`	string	No	Add type matches to the search; repeat or comma-separate values.
`series_type`	string	No	Model type used for series counts; no restriction when omitted.

Successful response¶

Returns HTTP 200 with model filter options and counts.

Response example

{
  "total": 4,
  "type_counts": [
    {
      "type": "chat",
      "count": 4
    }
  ],
  "series_counts": [
    {
      "logo": "example",
      "count": 4
    }
  ],
  "pricing": {
    "priced": 4,
    "unpriced": 0
  }
}

Fields

Field	Type	Description
`total`	integer	Model count matching visibility, enabled status, and search conditions.
`type_counts`	array of object	Counts by model type.
`type_counts[].type`	string	Model type.
`type_counts[].count`	integer	Model count.
`series_counts`	array of object	Counts by model series.
`series_counts[].logo`	string	Series identifier.
`series_counts[].count`	integer	Model count.
`pricing`	object	Counts by pricing status.
`pricing.priced`	integer	Models with a positive configured price.
`pricing.unpriced`	integer	Models without a positive configured price.

In field paths, [] denotes each array item.

Last updated on Oct 15, 2026