List model selection options¶

Get display names, inference names, and capabilities for a model selector.

GET https://billing.moi.matrixorigin.cn/api/v1/taas/models/select-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/select-options" \
  -H "X-API-Key: $MOI_PERSONAL_ACCESS_TOKEN" \
  --data-urlencode "page_size=2"

Save the returned next_page_token as $NEXT_PAGE_TOKEN, retain the same filters, and request the next page. Stop when this value is empty or omitted.

curl --get "https://billing.moi.matrixorigin.cn/api/v1/taas/models/select-options" \
  -H "X-API-Key: $MOI_PERSONAL_ACCESS_TOKEN" \
  --data-urlencode "page_size=2" \
  --data-urlencode "page_token=$NEXT_PAGE_TOKEN"

Parameters

Parameter	Type	Required	Description
`type`	string	No	Filter by model type.
`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.
`pricing_status`	string	No	Pricing filter: `priced` or `unpriced`.
`logos`	string	No	Model series; repeat the parameter or separate values with commas.
`logo`	string	No	Alias for `logos`; values are combined.
`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.
`context_max`	integer	No	Only models with a positive context window no greater than this value.
`page_size`	integer	No	Page size; default 100, maximum 1000.
`page_token`	string	No	Next-page token from the previous response; omit for the first request.

Successful response¶

Returns HTTP 200 with model selection options.

Response example

{
  "items": [
    {
      "id": "model_example",
      "display_name": "Example Chat",
      "model_id": "example-chat-model",
      "capabilities": [
        "chat"
      ],
      "debug_capabilities": []
    }
  ],
  "total": 1,
  "next_page_token": ""
}

Fields

Field	Type	Description
`items`	array of object	Records on this page.
`items[].id`	string	Catalog object ID.
`items[].display_name`	string	Alias if configured; otherwise the model name.
`items[].model_id`	string	Inference model name, corresponding to name in the model catalog.
`items[].capabilities`	array of string	Inference capabilities.
`items[].debug_capabilities`	array of string	Available debugging capabilities; omitted when empty.
`total`	integer	Total records matching the filters.
`next_page_token`	string	Next-page token; empty or omitted on the last page.

In field paths, [] denotes each array item.

Last updated on Sep 15, 2026