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

# API 키 관리

> 모델 API 자격 증명을 생성하고, 범위와 한도를 설정하고, 매핑과 폴백을 구성하고, 키를 안전하게 비활성화, 교체 또는 삭제하세요.

API 키는 모델 요청을 인증합니다. 애플리케이션이나 용도별로 별도의 키를 생성하면 사용량을 추적하고 접근을 개별적으로 비활성화할 수 있습니다.

<h2 id="create-key">
  키 생성
</h2>

1. 콘솔에서 **API 키**를 열고 계정과 워크스페이스를 확인합니다.
2. 알아보기 쉬운 이름으로 키를 생성합니다.
3. 필요에 따라 모델 범위, 사용 한도, 만료일을 설정한 후 저장합니다.
4. 키를 환경 변수나 시크릿 관리 도구에 복사하고 [빠른 시작](/ko/quick-start)을 따릅니다.

생성 대화 상자에 전체 키가 한 번만 표시된다고 안내되면 닫기 전에 저장하세요. 전체 키를 프런트엔드 코드, 공개 저장소, 지원 티켓에 포함하지 마세요.

<h2 id="advanced-settings">
  고급 설정
</h2>

| 목표 | 기능 |
| - | - |
| 애플리케이션의 모델 이름을 유지하면서 다른 모델 호출 | [모델 매핑](/ko/api/Model-Mapping-Fallback) |
| 폴백 조건이 충족되면 백업 모델 사용 | [오류 시 폴백](/ko/api/Model-Mapping-Fallback) |
| 구조화된 출력에서 지원되는 JSON 형식 오류 복구 | [구조화된 출력 복구](/ko/api/structured-output-repair) |

저장한 후 실제 요청으로 구성을 확인하세요. 설정으로 대상 모델에 없는 입력, 출력, 도구 기능이 추가되지는 않습니다.

<h2 id="manage-key">
  비활성화, 교체, 삭제
</h2>

* **비활성화**: 해당 키를 사용한 요청을 일시적으로 중지합니다. 다시 활성화하기 전에 유효성과 만료일을 확인하세요.
* **교체**: 새 키를 생성하고, 애플리케이션을 업데이트하고, 요청을 확인한 후 이전 키를 비활성화합니다.
* **삭제**: 영향을 받는 애플리케이션이 자격 증명을 전환했는지 확인한 후 삭제를 완료합니다.

엔터프라이즈 워크스페이스에서는 [멤버 키 및 시스템 키](/ko/enterprise/keys)를 제공합니다. 소유권, 권한, 만료 규칙은 해당 가이드를 참조하세요.

<h2 id="troubleshooting">
  요청이 제한되는 경우
</h2>

키 상태, 만료일, 모델 범위, 남은 사용 한도, 계정 잔액을 확인하세요. 엔터프라이즈 요청에는 [워크스페이스 예산](/ko/enterprise/budgets)도 적용됩니다. 유효하지 않은 자격 증명으로 반복해서 재시도하지 말고 [요청 로그](/ko/console/request-logs)에서 오류와 Tid를 확인하세요.

계정 리소스를 관리하려면 [관리 키](/ko/platform/management-keys)를 사용하세요.

마지막 업데이트: 2026-10-13


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.