Models

通过模型列表接口查询当前 API Key 具备调用权限的模型列表、可用状态与基础属性。

模型列表接口用于程序化获取当前 API Key 有权限访问的所有模型信息,便于动态加载模型选项、验证调用权限与核对模型标识符。

接口地址

GET https://console.anystarx.com/v1/models

命令行调用示例

curl https://console.anystarx.com/v1/models \
  -H "Authorization: Bearer YOUR_API_KEY"

响应数据字段说明

接口调用成功后返回包含模型对象的 JSON 列表,标准字段包括:

  • id:模型的完整标识符字符串,直接用于各类调用接口的 model 字段。
  • object:固定返回 model
  • created:模型创建或上线的时间戳。
  • owned_by:模型归属的提供商或组织标识。

除上述标准字段外,部分模型对象可能包含上游返回的上下文窗口上限、模型功能标签(如是否支持视觉输入或工具调用)等元数据。

基于模型列表排查权限

当调用对话或视频接口遇到 model_not_found 或 403 错误时,可以通过该接口排查原因:

  1. 发起 GET https://console.anystarx.com/v1/models 请求,获取完整的可用列表。
  2. 在返回的列表中检索正在使用的模型 ID。
  3. 如果列表中不存在该模型,说明当前账号尚未开通该模型的调用权限,或该模型处于维护下线状态。
  4. 如果列表中存在该模型,则说明权限正常,问题通常出在请求路由拼写或具体请求体参数上。

模型标识符使用规范

在调用具体业务接口时,请求体中的 model 字段必须精确使用模型列表返回的 id 字符串。不要使用控制台界面中经过本土化翻译的展示名、中文别名或营销简称,否则会导致网关无法匹配到正确的上游路由。

本页内容