> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aihubmix.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 获取当前用户信息与余额

> 获取当前用户信息与账户余额

用于查询当前登录用户的基本信息与余额额度。

## 请求参数

### 请求头（headers）

<ResponseField type="string" required>
  请求身份认证。接口使用 AIHubMix Manage Key 进行身份认证。
</ResponseField>

<ResponseField type="string">
  请求内容类型。此参数必须设置为 application/json。
</ResponseField>

## 响应参数

<ResponseField name="data" type="object">
  用户信息对象，包含基本资料、余额额度与提醒设置。

  <ResponseField name="username" type="string">
    用户名。
  </ResponseField>

  <ResponseField name="display_name" type="string">
    用户展示名。
  </ResponseField>

  <ResponseField name="role" type="integer">
    用户角色标识（数值越大权限越高，如管理员）。
  </ResponseField>

  <ResponseField name="status" type="integer">
    账户状态（1 为正常）。
  </ResponseField>

  <ResponseField name="email" type="string">
    邮箱。
  </ResponseField>

  <ResponseField name="quota" type="integer">
    账户余额，实际金额（美元）为： quota / 500000。
  </ResponseField>

  <ResponseField name="used_quota" type="integer">
    已使用额度，实际金额（美元）为： used\_quota / 500000。
  </ResponseField>

  <ResponseField name="request_count" type="integer">
    累计请求次数。
  </ResponseField>

  <ResponseField name="group" type="string">
    账户分组。
  </ResponseField>

  <ResponseField name="aff_code" type="string">
    邀请码。
  </ResponseField>

  <ResponseField name="notify" type="boolean">
    是否接受低余额提醒。
  </ResponseField>

  <ResponseField name="quota_remind_threshold" type="integer">
    余额低于 quota\_remind\_threshold / 500000 时接收邮件提醒。
  </ResponseField>

  <ResponseField name="notify_email" type="string">
    接收提醒的邮箱地址。
  </ResponseField>

  <ResponseField name="ext" type="string">
    扩展字段（预留，通常为空字符串）。
  </ResponseField>
</ResponseField>

<ResponseField name="message" type="string">
  请求失败的详细信息。请求成功时不会返回此参数。
</ResponseField>

<ResponseField name="success" type="boolean">
  是否成功
</ResponseField>

<ResponseExample>
  ```json 200 theme={null}
  {
    "data": {
      "username": "your_name",
      "display_name": "your_name",
      "role": 1,
      "status": 1,
      "email": "you@example.com",
      "quota": 29071257,
      "used_quota": 286403484,
      "request_count": 614422,
      "group": "default",
      "aff_code": "XXXX",
      "notify": true,
      "quota_remind_threshold": 10000000,
      "notify_email": "you@example.com",
      "ext": ""
    },
    "message": "",
    "success": true
  }
  ```
</ResponseExample>

***

更新时间：2026-06-26