模型列表 v2

GET /v2/models 与 GET /v2/models/{model} — 增强模型列表与单模型详情，含描述、标签、图标与上下文长度。

GET/v2/models

GET/v2/models/{model}

v2 是推荐的模型查询接口：在 v1 的基础上增加了 description、tags、icon、context_length 等展示与决策元数据。需 Bearer 令牌鉴权。

不要在代码里写死模型列表。 可用模型随账号、套餐与平台渠道动态变化，不同令牌调用同一接口返回的列表可能不同。始终通过接口动态查询，或至少做成可配置项。

v1 与 v2 的差异

两个列表接口返回相同的模型集合与能力信息，差异在扩展元数据与响应信封：

维度	`/v1/models`	`/v2/models`
响应信封	`success: true` + `object` + `data`	与 v1 相同
能力标签 `capabilities`	✅ 有	✅ 有（结构相同）
`supported_endpoint_types`	✅ 有	✅ 有
顶层 `tool_support` 字段	✅ 有（冗余于 capabilities）	❌ 无，仅在 `capabilities` 内
`description` / `tags` / `icon`	❌ 无	✅ 有
`context_length`	❌ 无	✅ 有（部分模型缺省时不返回该字段）
适用场景	兼容 OpenAI SDK 的模型发现	需要展示元数据或精确判断上下文长度

建议：新接入一律用 /v2/models；仅当需要与只认 OpenAI 格式的第三方 SDK 对接时用 /v1/models。

列表响应

响应200

{
  "success": true,
  "object": "list",
  "data": [
    {
      "id": "claude-opus-5",
      "object": "model",
      "created": 1626777600,
      "owned_by": "custom",
      "capabilities": {
        "tool_support": true,
        "image_generation": false,
        "text_to_image": false,
        "image_to_image": false,
        "multi_modal": true,
        "video_generation": false,
        "audio_generation": false,
        "embeddings": false,
        "rerank": false
      },
      "supported_endpoint_types": ["anthropic"],
      "description": "Strongest Claude Opus model for coding, agents, and professional work",
      "tags": ["Text Input", "Image Input", "PDF Input", "Text Output", "Files", "Reasoning"],
      "icon": "Claude.Color",
      "context_length": 1000000
    }
  ]
}

扩展元数据字段：

descriptionstring

模型一句话描述（英文），适合做选择器提示文案

tagsstring[]

能力维度标签，如 Text Input、Image Input、Reasoning、Files

iconstring

模型品牌图标标识，供 UI 展示使用

context_lengthinteger

上下文窗口 token 数。未配置的模型不返回该字段（omitempty），判断前需先检查字段存在性

capabilities 九个能力标签与 supported_endpoint_types 的完整说明见模型能力。

请求示例

curl https://api.jimu.chat/v2/models \
  -H "Authorization: Bearer $JIMU_API_KEY"

import os, requests

resp = requests.get(
    "https://api.jimu.chat/v2/models",
    headers={"Authorization": f"Bearer {os.environ['JIMU_API_KEY']}"},
).json()
for m in resp["data"]:
    print(m["id"], m.get("context_length"), m["capabilities"]["tool_support"])

const resp = await fetch("https://api.jimu.chat/v2/models", {
  headers: { Authorization: `Bearer ${process.env.JIMU_API_KEY}` },
}).then((r) => r.json());
for (const m of resp.data) {
  console.log(m.id, m.context_length, m.capabilities.tool_support);
}

单模型详情

GET /v2/models/{model} 返回结构与列表中的单项一致，{model} 需 URL 编码：

curl https://api.jimu.chat/v2/models/claude-opus-5 \
  -H "Authorization: Bearer $JIMU_API_KEY"

import os, requests

resp = requests.get(
    "https://api.jimu.chat/v2/models/claude-opus-5",
    headers={"Authorization": f"Bearer {os.environ['JIMU_API_KEY']}"},
).json()
print(resp["context_length"], resp["capabilities"])

const model = await fetch(
  `https://api.jimu.chat/v2/models/${encodeURIComponent("claude-opus-5")}`,
  { headers: { Authorization: `Bearer ${process.env.JIMU_API_KEY}` } },
).then((r) => r.json());
console.log(model.context_length, model.capabilities);

单模型接口不做存在性校验。 查询不存在的模型名也返回 HTTP 200，只是各字段为零值（owned_by: "custom"、能力全 false、端点类型为空数组）。判断模型是否真实可用，应以它是否出现在 /v2/models 列表中为准，或检查返回的 supported_endpoint_types 是否非空。

模型列表 v1

GET /v1/models — OpenAI 兼容格式的可用模型列表，含能力标签与端点类型。

模型能力

九个能力标签的含义与调用前校验方法，以及 supported_endpoint_types 字段说明。