> ## 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의 이름, 만료 시간, 쿼터, 모델/IP 제한 및 상태를 업데이트합니다.

## 요청 파라미터

### 요청 헤더

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

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

### 경로 파라미터

<ParamField body="id" type="integer" required>
  KEY ID.
</ParamField>

### 요청 본문

<ParamField body="name" type="string">
  새 Key의 이름.
</ParamField>

<ParamField body="expired_time" type="integer">
  만료 시간 (UNIX 타임스탬프), -1은 만료되지 않음을 의미합니다.
</ParamField>

<ParamField body="unlimited_quota" type="boolean">
  쿼터가 무제한인지 여부. true는 무제한, false는 쿼터가 활성화됨을 의미합니다(remain\_quota 필요).
</ParamField>

<ParamField body="remain_quota" type="integer">
  남은 쿼터. remain\_quota는: 원하는 쿼터 \* 500000 (예: 원하는 쿼터가 10이면 5000000을 전달). unlimited\_quota가 true인 경우 -1을 전달하는 것이 좋습니다.
</ParamField>

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

<ParamField body="models" type="text">
  현재 Key가 사용할 수 있는 모델에 대한 제한 (비어 있거나 제공되지 않으면 제한 없음).
</ParamField>

<ParamField body="subnet" type="text">
  IP 제한 (비어 있거나 제공되지 않으면 제한 없음).
</ParamField>

## 응답 파라미터

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

<ResponseField name="message" type="string">
  요청 실패에 대한 상세 정보. 요청 성공 시 비어 있거나 반환되지 않을 수 있습니다.
</ResponseField>

<ResponseField name="data" type="object">
  업데이트된 Key 객체.

  <ResponseField name="id" type="integer" />

  <ResponseField name="user_id" type="integer" />

  <ResponseField name="status" type="integer" />

  <ResponseField name="name" type="string" />

  <ResponseField name="created_time" type="integer" />

  <ResponseField name="accessed_time" type="integer" />

  <ResponseField name="expired_time" type="integer" />

  <ResponseField name="remain_quota" type="integer" />

  <ResponseField name="unlimited_quota" type="boolean" />

  <ResponseField name="used_quota" type="integer" />

  <ResponseField name="models" type="text" />

  <ResponseField name="subnet" type="text" />
</ResponseField>

***

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