查询可调用模型

查询当前凭据可见且已启用的 Genesis 模型，获取调用标识、能力和价格。模型列表用于发现模型，不保证每个模型都支持所有同类型调用接口。

GET https://token.moi.matrixorigin.cn/v1/models

调用前准备

准备用于 Genesis 调用的个人访问令牌或服务账号 API Key。创建和权限配置参阅管理 Genesis 访问凭据。

查询参数

将 $GENESIS_ACCESS_TOKEN 替换为个人访问令牌或服务账号 API Key。

curl -G "https://token.moi.matrixorigin.cn/v1/models" \
  -H "Authorization: Bearer $GENESIS_ACCESS_TOKEN" \
  --data-urlencode "type=chat"

参数

类型

是否必填

说明

type

string

否

按模型类型筛选：chat、embedding 或 rerank。chat 只表示对话模型，不保证模型支持所有对话生成接口。省略或传入 all 时返回当前凭据可见的全部类型。

成功响应

成功时返回当前凭据可见且已启用的模型列表及模型信息。模型是否支持具体调用接口，还取决于 capabilities 和当前可用的模型路由。

下方价格仅用于说明响应格式，实际价格以所选模型返回的值为准。

{
  "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"
    }
  ]
}

字段

类型

说明

object

string

固定为 list。

data

array of object

筛选后当前凭据可见且已启用的模型。列表中的模型不一定支持所有同类型调用接口。

data[].id

string

模型调用标识，填入推理请求的 model。

data[].object

string

固定为 model。

data[].type

string

模型类型：chat、embedding 或 rerank。chat 表示模型家族，不等同于支持 Chat Completions。

data[].sub_type

string

输入子类型：text 或 multimodal。

data[].capabilities

array of string

模型能力标签。messages 和 responses 分别表示支持对应调用接口；其他标签表示输入类型、流式输出或工具调用等能力。Chat Completions 当前没有单独的能力标签。

data[].pricing

object

模型价格。单价使用十进制字符串；各单价字段可能省略。

data[].pricing.pricing_mode

string

价格来源；retail 为标准定价，enterprise_plan 为企业套餐定价。

data[].pricing.input_price_per_million

string

每百万输入 Token 的价格。

data[].pricing.output_price_per_million

string

每百万输出 Token 的价格。

data[].pricing.cache_creation_price_per_million

string

每百万缓存写入 Token 的价格。

data[].pricing.cache_hit_price_per_million

string

每百万缓存命中 Token 的价格。

data[].pricing.ocr_price_per_page

string

OCR 每页价格。

data[].pricing.image_price_per_image

string

图像每张价格。

data[].pricing.image_hd_price_per_image

string

高清图像每张价格。

data[].pricing.video_price_per_second

string

视频每秒价格。

data[].pricing.video_hd_price_per_second

string

高清视频每秒价格。

data[].pricing.tts_price_per_10k_chars

string

语音合成每万字符价格。

data[].pricing.tts_hd_price_per_10k_chars

string

高清语音合成每万字符价格。

data[].pricing.asr_price_per_minute

string

语音识别每分钟价格。

data[].pricing.asr_realtime_price_per_minute

string

实时语音识别每分钟价格。

data[].pricing.currency

string

上述价格的币种，例如 USD。

data[].created

integer

模型创建时间，Unix 秒级时间戳。

data[].owned_by

string

模型归属标记，返回 taas。

错误响应

未提供有效凭据时返回 HTTP 401。检查访问凭据是否有效，并在请求中携带认证信息。

{
  "error": {
    "message": "Invalid or missing TaaS API key",
    "type": "invalid_api_key",
    "code": "invalid_api_key"
  }
}

字段

类型

说明

error

object

错误信息。

error.message

string

凭据缺失或无效的说明。

error.type

string

错误类别。

error.code

string

错误代码。

后续操作

将 data[].id 作为 model 传入推理请求。按目标接口选择模型：

  • Messages：选择 capabilities 包含 messages 的模型。

  • Responses：选择 capabilities 包含 responses 的模型。

  • Embeddings 和 Rerank：根据对应的 embedding.* 或 rerank.* 标签选择输入类型。

  • Chat Completions：先使用 type=chat 缩小模型范围。当前模型列表不提供 Chat Completions 专用能力标签；如果调用返回 endpoint_capability_mismatch，请选择其他 chat 模型。

最后更新于