> ## 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.

# KEY 목록 가져오기

> 모든 KEY 목록을 조회하며, num 파라미터로 수량을 제어할 수 있습니다

## 요청 파라미터

### 요청 헤더

<ResponseField type="string" required>
  요청 인증. 이 API는 인증을 위해 AIHubMix Manage Key를 사용합니다.
</ResponseField>

<ResponseField type="string">
  요청의 콘텐츠 타입. 이 파라미터는 application/json으로 설정되어야 합니다.
</ResponseField>

## 응답 파라미터

<ResponseField name="data" type="object">
  사용자 Key와 관련된 정보 (일반적으로 id, name 등을 포함).

  <ResponseField name="id" type="integer">
    Key ID.
  </ResponseField>

  <ResponseField name="user_id" type="integer">
    사용자 ID.
  </ResponseField>

  <ResponseField name="status" type="integer">
    Key 상태. 0은 비활성화, 1은 활성화를 의미합니다.
  </ResponseField>

  <ResponseField name="name" type="string">
    Key 이름.
  </ResponseField>

  <ResponseField name="created_time" type="integer">
    Key 생성 시간, UNIX 타임스탬프로 저장됩니다.
  </ResponseField>

  <ResponseField name="accessed_time" type="integer">
    Key 액세스 시간, UNIX 타임스탬프로 저장됩니다.
  </ResponseField>

  <ResponseField name="expired_time" type="string">
    Key 만료 시간, -1은 만료되지 않음을 나타냅니다.
  </ResponseField>

  <ResponseField name="remain_quota" type="string">
    남은 쿼터, -1은 무제한을 나타냅니다.
  </ResponseField>

  <ResponseField name="unlimited_quota" type="boolean">
    쿼터 제한이 있는지 여부.
  </ResponseField>

  <ResponseField name="used_quota" type="integer">
    사용된 쿼터: used\_quota / 500000
  </ResponseField>

  <ResponseField name="models" type="text">
    현재 Key 사용에 제한된 모델.
  </ResponseField>

  <ResponseField name="subnet" type="text">
    IP 제한.
  </ResponseField>
</ResponseField>

<ResponseField name="message" type="string">
  요청 실패에 대한 상세 정보. 요청 성공 시에는 이 파라미터가 반환되지 않습니다.
</ResponseField>

<ResponseField name="success" type="boolean">
  성공 여부를 나타냅니다.
</ResponseField>

***

마지막 업데이트: 2026-06-01