请输入
菜单

个人资料

本章节接口用于查询当前账户的个人资料、可用分组和可用模型,均为 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 接口,请求方式和返回格式见「模型列表」章节,同样只需要「个人资料 · 查看」权限。

最近修改: 2026-10-29