> ## 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를 검색합니다

## 요청 파라미터

### 요청 헤더

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

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

### 쿼리 파라미터

<ParamField query="keyword" type="string" required>
  검색 키워드 (일반적으로 KEY 이름과 같은 필드와 일치).
</ParamField>

## 응답 파라미터

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

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

<ResponseField name="data" type="array">
  검색 결과 목록. 배열의 각 요소는 KEY 객체입니다.

  <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