请输入
菜单

模型列表

本章节涵盖账户级的自助查询接口。

1. 获取可用模型列表

获取你当前账户可访问的模型名称列表。用于:

•在你的应用中动态渲染「模型选择器」
•创建 API Key 时勾选允许的模型
•校验用户输入的模型名是否有效

请求

•方法:GET
•路径:/api/user/models

Header:

名称 是否必填 说明
Authorization 是 系统访问令牌

Query 参数(可选):

参数 类型 默认 说明
group string — 分组名称,可选。不传返回你所有可用分组下的模型(已去重);传 auto 返回自动分组下的模型;传其他分组名返回该分组下的模型。分组不在你的可用分组内时返回空数组。可用分组可通过 GET /api/user/self/groups 查看

无请求体。

响应

成功响应示例:

模型列表由当前账号的分组和系统配置动态决定,以下仅为格式示例,实际名称和数量以接口返回为准。
{
  "success": true,
  "message": "",
  "data": [
    "gpt-4o",
    "gpt-4o-mini",
    "claude-sonnet-4-6",
    "claude-opus-4-6",
    "qwen3.7-plus",
    "qwen3.7-max",
    "glm-5.2",
    "kimi-k2.7-code",
    "doubao-seed-2.1-pro"
  ]
}

字段说明:

字段 类型 说明
data string[] 你可用的所有模型名。元素为原始模型名字符串,无固定顺序,也不区分分类

示例

curl -sS "https://ailink.nativex.com/api/user/models" \
  -H "Authorization: Bearer <你的系统访问令牌>"

只查询某个分组下的模型:

curl -sS "https://ailink.nativex.com/api/user/models?group=default" \
  -H "Authorization: Bearer <你的系统访问令牌>"

说明

•返回的列表随你所在用户分组而变化。切换分组或管理员上下架模型后,本接口结果会实时更新。
•返回列表不包含模型的输入/输出定价、上下文长度等元数据。定价请参考 AiLink 控制台的「模型价格」页面。
•如果账户被禁用或未通过身份校验,返回 401。

常见错误

HTTP message 处理
401 Unauthorized, ... 检查 Authorization 头是否填写、令牌是否失效
500 — 稍后重试
最近修改: 2026-10-29