返回模型目录
返回模型目录

MODEL CATALOG API

模型目录接口

通过公开只读接口获取模型目录、价格与能力数据。

获取模型列表

GET/v1/router/model-catalog/list

公开可读,无需鉴权,不消耗额度。支持模型类型、输入模态、排序和分页。

接口路径与请求示例依据 2026-10-10 测试站页面。本页不会发送请求;下方数据结构仅作展示,完整接口契约以服务端文档为准。

请求示例

curl "https://easyx.ai/v1/router/model-catalog/list" \
  --get \
  --data-urlencode "types=text" \
  --data-urlencode "input_modalities=text" \
  --data-urlencode "sort_by=input_price" \
  --data-urlencode "page_size=50"

示例中的查询参数

参数用途示例值
types按模型类型筛选text
input_modalities按输入模态筛选,可重复传入text / image
sort_by排序字段input_price
page_size每页条数50

数据结构示意

下例沿用目录列表的返回结构,不代表每一次响应都包含全部字段。

{
  "items": [
    {
      "external_id": "anthropic/claude-opus-5",
      "vendor": "anthropic",
      "vendor_name": "Anthropic",
      "display_name": "Claude Opus 5",
      "type": "text",
      "input_modalities": [
        "text",
        "image"
      ],
      "output_modalities": [
        "text"
      ],
      "features": [
        "function_calling",
        "reasoning"
      ],
      "context_length": 1000000,
      "billing_unit": "per_token",
      "input_price": "5.00000000",
      "output_price": "25.00000000"
    }
  ],
  "total": 480,
  "page": 1,
  "page_size": 50
}