本章节接口用于查询当前账户的个人资料、可用分组和可用模型,均为 GET 请求,无请求体。
权限要求:
•需要使用带有「个人资料 · 查看」权限的系统访问令牌,认证方式见「认证」章节。
•令牌缺少该权限时返回 HTTP 403。
1. 查看个人资料
获取当前登录账户的基本信息和额度使用情况。
请求
•方法:
GET•路径:
/api/user/self无 Query 参数,无请求体。
响应
成功响应示例:
{
"success": true,
"message": "",
"data": {
"id": 12345,
"username": "example_user",
"display_name": "example_user",
"has_password": true,
"email": "user@example.com",
"github_id": "",
"discord_id": "",
"oidc_id": "",
"wechat_id": "",
"telegram_id": "",
"linux_do_id": "",
"group": "default",
"quota": 5000000,
"used_quota": 10000000,
"request_count": 128
}
}
字段说明:
| 字段 | 类型 | 说明 |
|---|---|---|
id |
int | 用户 ID |
username |
string | 用户名 |
display_name |
string | 显示名称 |
has_password |
boolean | 账号是否设置了登录密码 |
email |
string | 绑定邮箱 |
github_id / discord_id / oidc_id / wechat_id / telegram_id / linux_do_id |
string | 第三方账号绑定信息,未绑定为空 |
group |
string | 当前所属用户分组 |
quota |
int | 剩余额度(quota 单位),折算美元 = quota / 500000(默认比例,具体见控制台) |
used_quota |
int | 已使用额度(quota 单位) |
request_count |
int | 累计请求次数 |
该接口不会返回登录密码、系统访问令牌和管理员备注。
示例
curl -sS "https://ailink.nativex.com/api/user/self" \
-H "Authorization: Bearer <你的系统访问令牌>"
2. 查看可用分组
获取当前账户可以使用的分组,以及各分组对应的计费倍率。创建 API Key 时选择的分组必须在此列表内。
请求
•方法:
GET•路径:
/api/user/self/groups无 Query 参数,无请求体。
响应
成功响应示例:
分组名称、倍率和描述由系统配置决定,以下仅为格式示例,实际内容以接口返回为准。
{
"success": true,
"message": "",
"data": {
"default": {
"ratio": 1,
"desc": "默认分组"
},
"auto": {
"ratio": "自动",
"desc": "自动选择可用分组"
}
}
}
字段说明:
| 字段 | 类型 | 说明 |
|---|---|---|
data |
object | 键为分组名称,值为该分组的详情 |
data.<分组名>.ratio |
number / string | 当前账户使用该分组时的计费倍率;auto 分组固定返回字符串 自动 |
data.<分组名>.desc |
string | 分组描述 |
示例
curl -sS "https://ailink.nativex.com/api/user/self/groups" \
-H "Authorization: Bearer <你的系统访问令牌>"
3. 查看可用模型
可用模型请使用 GET /api/user/models 接口,请求方式和返回格式见「模型列表」章节,同样只需要「个人资料 · 查看」权限。