List callable models¶
List the Genesis models available to the current credential and obtain their identifiers, capabilities, and prices.
GET https://token.moi.matrixorigin.cn/v1/models
Before you begin¶
Prepare a personal access token or service account API key for Genesis. See Access credentials for credential selection and permissions.
Query parameters¶
Set $GENESIS_ACCESS_TOKEN to your personal access token or service account API key.
curl -G "https://token.moi.matrixorigin.cn/v1/models" \
-H "Authorization: Bearer $GENESIS_ACCESS_TOKEN" \
--data-urlencode "type=chat"
Parameter |
Type |
Required |
Description |
|---|---|---|---|
|
string |
No |
Filter by |
Successful response¶
A successful request returns the models callable with the current credential and their metadata.
The example prices below are illustrative; use the prices returned for your selected model.
{
"object": "list",
"data": [
{
"id": "$MODEL_ID",
"object": "model",
"type": "chat",
"sub_type": "text",
"capabilities": [
"multi_turn",
"messages"
],
"pricing": {
"pricing_mode": "retail",
"input_price_per_million": "0.50",
"output_price_per_million": "1.50",
"currency": "USD"
},
"created": 1780000000,
"owned_by": "taas"
}
]
}
Field |
Type |
Description |
|---|---|---|
|
string |
Always |
|
array of object |
Models available to the credential after filtering. |
|
string |
Model identifier to pass as |
|
string |
Always |
|
string |
Model family: |
|
string |
Input subtype: |
|
array of string |
Capability tags used to select a compatible API and input format, such as |
|
object |
Model prices. Unit prices use decimal strings; individual price fields may be omitted. |
|
string |
Pricing source: |
|
string |
Price per million input tokens. |
|
string |
Price per million output tokens. |
|
string |
Price per million cache-write tokens. |
|
string |
Price per million cache-read tokens. |
|
string |
OCR price per page. |
|
string |
Price per image. |
|
string |
Price per high-definition image. |
|
string |
Price per second of video. |
|
string |
Price per second of high-definition video. |
|
string |
Text-to-speech price per 10,000 characters. |
|
string |
High-definition text-to-speech price per 10,000 characters. |
|
string |
Speech recognition price per minute. |
|
string |
Real-time speech recognition price per minute. |
|
string |
Currency for the prices, such as |
|
integer |
Model creation time as a Unix timestamp in seconds. |
|
string |
Model owner label returned as |
Error response¶
HTTP 401 indicates missing or invalid credentials. Check that the credentials remain valid and include authentication in the request.
{
"error": {
"message": "Invalid or missing TaaS API key",
"type": "invalid_api_key",
"code": "invalid_api_key"
}
}
Field |
Type |
Description |
|---|---|---|
|
object |
Error details. |
|
string |
Description of missing or invalid credentials. |
|
string |
Error type. |
|
string |
Error code. |
Next steps¶
Use data[].id as model when creating Chat Completions, Responses, Messages, Embeddings, or Rerank requests. Select an API and input format supported by the model’s capability tags.