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

type

string

No

Filter by chat, embedding, or rerank. Omit it or use all to return all model types available to the credential.

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

object

string

Always list.

data

array of object

Models available to the credential after filtering.

data[].id

string

Model identifier to pass as model in an inference request.

data[].object

string

Always model.

data[].type

string

Model family: chat, embedding, or rerank.

data[].sub_type

string

Input subtype: text or multimodal.

data[].capabilities

array of string

Capability tags used to select a compatible API and input format, such as messages, responses, embedding_1536d, and rerank.text.

data[].pricing

object

Model prices. Unit prices use decimal strings; individual price fields may be omitted.

data[].pricing.pricing_mode

string

Pricing source: retail for retail pricing or enterprise_plan for plan pricing.

data[].pricing.input_price_per_million

string

Price per million input tokens.

data[].pricing.output_price_per_million

string

Price per million output tokens.

data[].pricing.cache_creation_price_per_million

string

Price per million cache-write tokens.

data[].pricing.cache_hit_price_per_million

string

Price per million cache-read tokens.

data[].pricing.ocr_price_per_page

string

OCR price per page.

data[].pricing.image_price_per_image

string

Price per image.

data[].pricing.image_hd_price_per_image

string

Price per high-definition image.

data[].pricing.video_price_per_second

string

Price per second of video.

data[].pricing.video_hd_price_per_second

string

Price per second of high-definition video.

data[].pricing.tts_price_per_10k_chars

string

Text-to-speech price per 10,000 characters.

data[].pricing.tts_hd_price_per_10k_chars

string

High-definition text-to-speech price per 10,000 characters.

data[].pricing.asr_price_per_minute

string

Speech recognition price per minute.

data[].pricing.asr_realtime_price_per_minute

string

Real-time speech recognition price per minute.

data[].pricing.currency

string

Currency for the prices, such as USD.

data[].created

integer

Model creation time as a Unix timestamp in seconds.

data[].owned_by

string

Model owner label returned as taas.

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

error

object

Error details.

error.message

string

Description of missing or invalid credentials.

error.type

string

Error type.

error.code

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.

Last updated on