获取模型列表

获取平台当前可用的全部模型，按模型能力和模型厂商两级分组。获取 modelId 后，可在其他需要指定模型的接口中引用。

本接口按账号维度限流，60 次/分钟。平台模型列表变动不频繁，建议在调用侧缓存结果。

请求方式

GET

调用地址

https://api-${endpoint}.gptbots.ai/v1/model/list

调用验证

本接口使用账号维度的 DevKey / DevSecret，以 HTTP 基本认证传递：

Authorization: Basic base64(${DevKey}:${DevSecret})

                      
                      Authorization: Basic base64(${DevKey}:${DevSecret})

此代码块在浮窗中显示

即把 DevKey 和 DevSecret 用英文冒号拼接后整体做 Base64 编码，前面加 Basic （注意有一个空格）。

DevKey / DevSecret 的获取方式：登录控制台，进入 个人中心 - 账号 - 开发者信息，可查看**开发者标识（DevKey）**和 API DevSecret。

⚠️ 注意与 Agent 维度鉴权区分：对话等接口使用 Agent 的 API Key（Authorization: Bearer ${API Key}）进行验证，本接口使用账号的 DevKey / DevSecret + Basic 认证，两者不可混用。

Base64 是可逆编码而非加密，请将编码结果与明文密码同等对待，不要提交进代码库或写入公开文档。

请求

请求示例

curl -X GET 'https://api-${endpoint}.gptbots.ai/v1/model/list' \ -H 'Authorization: Basic ${base64(DevKey:DevSecret)}'

                      
                      curl -X GET 'https://api-${endpoint}.gptbots.ai/v1/model/list' \
-H 'Authorization: Basic ${base64(DevKey:DevSecret)}'

此代码块在浮窗中显示

请求头

字段	类型	描述
Authorization	Basic base64( ${DevKey}:$ {DevSecret})	使用账号维度的 DevKey / DevSecret 进行 HTTP Basic 认证，请在个人中心 - 账号 - 开发者信息页面获取凭据。

请求参数

无。

响应

响应示例

{ "code": 0, "message": "OK", "data": { "CHAT": { "OPEN_AI": [ { "aiModelVersion": "gpt-4o", "modelId": "65f2c1a8d3b4e5f601234567" }, { "aiModelVersion": "gpt-3.5-turbo", "modelId": "65f2c1a8d3b4e5f601234568" } ], "ANTHROPIC_CLAUDE": [ { "aiModelVersion": "claude-opus-4-8", "modelId": "65f2c1a8d3b4e5f601234569" } ] }, "EMBEDDING": { "OPEN_AI_EMB": [ { "aiModelVersion": "text-embedding-3-large", "modelId": "65f2c1a8d3b4e5f60123456a" } ] }, "RERANK": { }, "SPEECH2TEXT": { }, "TEXT2SPEECH": { }, "MODERATION": { }, "ANONYMIZATION": { } } }

                      
                      {
  "code": 0,
  "message": "OK",
  "data": {
    "CHAT": {
      "OPEN_AI": [
        { "aiModelVersion": "gpt-4o", "modelId": "65f2c1a8d3b4e5f601234567" },
        { "aiModelVersion": "gpt-3.5-turbo", "modelId": "65f2c1a8d3b4e5f601234568" }
      ],
      "ANTHROPIC_CLAUDE": [
        { "aiModelVersion": "claude-opus-4-8", "modelId": "65f2c1a8d3b4e5f601234569" }
      ]
    },
    "EMBEDDING": {
      "OPEN_AI_EMB": [
        { "aiModelVersion": "text-embedding-3-large", "modelId": "65f2c1a8d3b4e5f60123456a" }
      ]
    },
    "RERANK": { },
    "SPEECH2TEXT": { },
    "TEXT2SPEECH": { },
    "MODERATION": { },
    "ANONYMIZATION": { }
  }
}

此代码块在浮窗中显示

成功响应

字段	类型	描述
code	int	`0` 表示成功，非 0 见错误码。
message	string	结果描述，成功为 `OK`。
data	JSON Object	模型数据，按模型能力、模型厂商两级分组，见下。
aiModelVersion	string	模型版本名称，如 `gpt-4o`，用于展示。
modelId	string	模型版本 ID，其他接口引用模型时使用该值。模型版本名称可能因平台调整而变化，`modelId` 是稳定标识。

data 的两级结构

data └── 模型能力外层 key，7 种，固定顺序 └── 模型厂商内层 key，如 OPEN_AI └── [ 模型列表 ]

                      
                      data
 └── 模型能力          外层 key，7 种，固定顺序
      └── 模型厂商      内层 key，如 OPEN_AI
           └── [ 模型列表 ]

此代码块在浮窗中显示

外层 key 为模型能力，固定为下列 7 种，且按此顺序返回：

能力	含义
CHAT	对话（大语言模型）
EMBEDDING	向量化
RERANK	向量重排
SPEECH2TEXT	语音识别（ASR）
TEXT2SPEECH	语音合成（TTS）
MODERATION	内容审查
ANONYMIZATION	匿名化

内层 key 为模型厂商标识。以 CHAT 为例，可能出现的取值包括 OPEN_AI、AZURE、ANTHROPIC_CLAUDE、GEMINI、ALI_QWEN、DEEP_SEEK、KIMI、META_LLAMA、MISTRAL、ZHIPU_CHATGLM、HUNYUAN、ERINE、XAI_GROK、BYTEDANCE_SEED、SENSE 等；其他能力下的厂商标识不同（如 EMBEDDING 下有 OPEN_AI_EMB、JINA_EMB 等）。

某项能力当前无可用模型时，其值为空对象 {}，key 仍会出现，不会被省略，遍历前请先判空。

平台会新增/下线厂商，请以接口实际返回为准，不要将厂商列表硬编码进代码。

厂商和模型按平台配置的展示优先级排序，排序仅供展示参考，请勿依赖排序结果做业务逻辑（如"取第一个即默认模型"）。

失败响应

字段	类型	描述
code	int	错误码。
message	string	错误详情。

错误码

Code	Message
40101	Authorization 为空
40102	Authorization 格式错误，请检查 `Basic` 前缀（含空格）与 Base64 编码是否正确
40001	请求超出频率限制，本接口限流 60 次/分钟
50000	服务内部错误，请稍后重试