获取可用模型

使用 GET /models 获取当前凭据可用于 API 调用的模型 ID。这是面向应用代码的查询：从响应中的 data[].id 选择模型 ID，再填入后续请求的 model 字段。

如需在控制台中搜索、筛选和比较模型，请参阅 Genesis 指南中的模型广场。模型广场用于人工比较；GET /models 用于确认当前凭据实际可以调用哪些模型。

通过 API 查询

curl "$GENESIS_BASE_URL/models" \
  -H "Authorization: Bearer $GENESIS_ACCESS_TOKEN"

将 $GENESIS_ACCESS_TOKEN 替换为个人访问令牌，或已授予 Genesis 权限的服务账号 API Key。GET /models 请求必须携带 Bearer 凭据；创建凭据和认证失败排查请参阅身份认证。

请求不需要请求体。请求成功后，从 data[].id 读取模型 ID。模型广场中能看到的模型不一定都出现在当前结果中；应用只应使用当前结果返回的模型 ID。

响应示例

{
  "object": "list",
  "data": [
    {
      "id": "<model-id>"
    }
  ]
}

字段

类型

返回条件

说明

object

string

成功响应返回

列表响应的对象类型。

data

array

成功响应返回

当前凭证可访问的模型列表。

data[].id

string

每个模型项返回

模型 ID。将此值作为后续请求的 model 字段。

data[].type

string

当前响应包含时返回

模型类型。可用于辅助筛选。

data[].capabilities

array

当前响应包含时返回

模型支持能力。可用于确认特定调用形态或输入能力。

type、capabilities 以及其他模型元数据可能随模型和部署变化。应用应以 id 作为调用所需的最小字段，并在使用可选字段前兼容缺失或新增字段。

使用查询结果

  1. 根据选择模型与能力确定所需的任务类型和能力。

  2. 调用 GET /models，从 data[].id 选择目标模型。

  3. 将模型 ID 填入目标接口请求的 model 字段。

  4. 先发送最小请求，确认目标模型支持所需的输入和可选参数。

如果目标模型未出现在响应中，请先在模型广场检查模型状态；使用服务账号时，再检查其 Genesis 产品权限和目标模型范围。不要仅按名称替换为相近模型；不同模型可能支持不同的输入、参数和响应行为。

下一步

最后更新于