本章节涵盖账户级的自助查询接口。
1. 获取可用模型列表
获取你当前账户可访问的模型名称列表。用于:
•在你的应用中动态渲染「模型选择器」
•创建 API Key 时勾选允许的模型
•校验用户输入的模型名是否有效
请求
•方法:
GET•路径:
/api/user/modelsHeader:
| 名称 | 是否必填 | 说明 |
|---|---|---|
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 | — | 稍后重试 |