> ## 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">
    계정 잔액. 실제 금액(USD)은 quota / 500000 입니다.
  </ResponseField>

  <ResponseField name="used_quota" type="integer">
    사용한 잔액. 실제 금액(USD)은 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