# List the public model catalog

```{raw} html
<div class="mo-api-page-show-toc" aria-hidden="true"></div>
```

List capabilities and prices for enabled, publicly visible models.

```text
GET https://billing.moi.matrixorigin.cn/api/v1/taas/public/models
```

## Before you begin

No authentication is required.

## Query parameters

:::::::{div} mo-api-tabs
::::::{tab-set}
:::::{tab-item} Request example

```bash
curl --get "https://billing.moi.matrixorigin.cn/api/v1/taas/public/models" \
  --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.

```bash
curl --get "https://billing.moi.matrixorigin.cn/api/v1/taas/public/models" \
  --data-urlencode "page_size=2" \
  --data-urlencode "page_token=$NEXT_PAGE_TOKEN"
```

:::::
:::::{tab-item} Parameters

::::{div} mo-api-parameter-table

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `type` | string | No | Filter by model type. |
| `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 the public model catalog and pricing.

:::::::{div} mo-api-tabs mo-api-response-tabs
::::::{tab-set}
:::::{tab-item} Response example

```json
{
  "items": [
    {
      "id": "model_example",
      "name": "example-chat-model",
      "alias": "Example Chat",
      "logo": "example",
      "description": "Example chat model.",
      "type": "chat",
      "capabilities": [
        "chat"
      ],
      "context_window": 32768,
      "input_price_per_million": "0",
      "output_price_per_million": "0",
      "cache_creation_price_per_million": "0",
      "cache_hit_price_per_million": "0",
      "ocr_price_per_page": "0",
      "image_price_per_image": "0",
      "image_hd_price_per_image": "0",
      "video_price_per_second": "0",
      "video_hd_price_per_second": "0",
      "tts_price_per_10k_chars": "0",
      "tts_hd_price_per_10k_chars": "0",
      "asr_price_per_minute": "0",
      "asr_realtime_price_per_minute": "0",
      "currency": "CNY"
    }
  ],
  "total": 1,
  "next_page_token": ""
}
```

:::::
:::::{tab-item} Fields

| Field | Type | Description |
| --- | --- | --- |
| `items` | array of object | Records on this page. |
| `items[].id` | string | Catalog object ID, used for management queries such as model health. |
| `items[].name` | string | Model name used in inference requests. |
| `items[].alias` | string | Display alias; omitted when unset. |
| `items[].logo` | string | Model series identifier; omitted when unset. |
| `items[].description` | string | Model description; omitted when unset. |
| `items[].type` | string | Model type. |
| `items[].capabilities` | array of string | Supported inference capabilities; omitted when unset. |
| `items[].context_window` | integer | Context window in tokens; omitted when unset. |
| `items[].input_price_per_million` | string | Price per million input tokens. Omitted when unset. |
| `items[].output_price_per_million` | string | Price per million output tokens. Omitted when unset. |
| `items[].cache_creation_price_per_million` | string | Price per million cache-creation tokens. Omitted when unset. |
| `items[].cache_hit_price_per_million` | string | Price per million cache-read tokens. Omitted when unset. |
| `items[].ocr_price_per_page` | string | OCR price per page. Omitted when unset. |
| `items[].image_price_per_image` | string | Price per image. Omitted when unset. |
| `items[].image_hd_price_per_image` | string | Price per HD image. Omitted when unset. |
| `items[].video_price_per_second` | string | Price per second of video. Omitted when unset. |
| `items[].video_hd_price_per_second` | string | Price per second of HD video. Omitted when unset. |
| `items[].tts_price_per_10k_chars` | string | TTS price per 10,000 characters. Omitted when unset. |
| `items[].tts_hd_price_per_10k_chars` | string | HD TTS price per 10,000 characters. Omitted when unset. |
| `items[].asr_price_per_minute` | string | ASR price per minute. Omitted when unset. |
| `items[].asr_realtime_price_per_minute` | string | Real-time ASR price per minute. Omitted when unset. |
| `items[].currency` | string | Currency of model prices. |
| `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.

:::::
::::::
:::::::