> ## 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>
  請求的身份驗證。本 API 使用 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