> ## 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 상세 정보 조회

> token_id를 기반으로 KEY에 대한 상세 정보를 가져옵니다

## 요청 파라미터

### 요청 헤더

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

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

### 경로 파라미터

<ParamField path="token_id" type="integer" required>
  KEY ID.
</ParamField>

## 응답 파라미터

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

<ResponseField name="message" type="string">
  메시지 (비어 있을 수 있음). 요청 실패 시 실패 사유를 반환합니다.
</ResponseField>

<ResponseField name="data" type="object">
  Key 상세 객체. 요청 실패 시, data는 빈 객체 `{}`일 수 있습니다.

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

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

  <ResponseField name="key" type="string">
    Key 문자열 (호출/인증에 사용).
  </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="integer">
    Key 만료 시간 (UNIX 타임스탬프); -1은 만료되지 않음을 의미합니다.
  </ResponseField>

  <ResponseField name="remain_quota" type="integer">
    남은 쿼터; -1은 무제한을 의미합니다.
  </ResponseField>

  <ResponseField name="unlimited_quota" type="boolean">
    쿼터가 무제한인지 여부를 나타냅니다. true는 무제한, false는 제한됨을 의미합니다.
  </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>

***

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