API 키 관리

API 키는 추론 엔드포인트를 호출할 때 사용하는 인증정보입니다. API 키를 생성한 후 사용할 엔드포인트에 연결해야 합니다.

API 키 목록 확인

1. AI Service > Advanced AI Space 메뉴로 이동합니다.
2. 인증 정보 > API 키 메뉴를 클릭합니다.

항목	설명
이름	API 키 식별 이름
Key	일부 마스킹된 API 키 전체 값은 생성 직후에만 확인 가능
연결된 엔드포인트 수	API 키가 연결된 엔드포인트 수
생성자	API 키를 생성한 사용자
생성 일시	API 키 생성 일시
만료 일시	API 키 만료 일시

API 키 생성

API 키 보관

API 키 전체 값은 생성 완료 화면에서 한 번만 표시됩니다. 화면을 닫기 전에 안전한 위치에 보관하세요. 분실한 키는 다시 확인할 수 없습니다.

1. 인증 정보 > API 키에서 [API 키 생성] 버튼을 클릭합니다.
2. API 키 이름을 입력합니다. 이름은 2~30자로 입력합니다.
3. 필요한 경우 적용 엔드포인트 설정에서 [엔드포인트 추가]를 클릭하고 API 키를 사용할 엔드포인트를 선택합니다.
4. 선택한 엔드포인트에 API 제한 설정(Tier)을 적용하려면 설정 Tier에서 해당 엔드포인트에 등록된 Tier 중 하나를 선택합니다. 선택한 Tier의 요청 수, 입력 토큰, 출력 토큰과 집계 주기를 함께 확인할 수 있습니다.
5. 사용량 제한을 적용하지 않으려면 설정 Tier에서 선택 안함을 선택합니다.
6. [생성] 버튼을 클릭합니다.
7. API 키 정보 화면에서 API 키 전체 값과 적용 엔드포인트를 확인합니다.
8. API 키 전체 값을 복사하여 안전하게 보관한 후 [확인] 버튼을 클릭합니다.

API 키의 기본 유효기간은 생성일로부터 370일이며, API 키 이름은 생성한 후 수정할 수 없습니다.

엔드포인트 연결

하나의 API 키를 여러 엔드포인트에 연결할 수 있습니다. 엔드포인트에 연결되지 않은 API 키로는 추론 요청을 인증할 수 없습니다.

연결된 엔드포인트 변경

API 키를 생성한 후에도 사용할 엔드포인트와 Tier를 변경할 수 있습니다.

1. 인증 정보 > API 키에서 변경할 API 키의 더보기 메뉴를 엽니다.
2. [엔드포인트 설정]을 클릭합니다.
3. 엔드포인트를 추가하거나 연결을 해제합니다.
4. 필요한 경우 엔드포인트별 Tier를 선택하거나 Tier 선택을 해제합니다.
5. 변경 내용을 저장합니다.

API 키 삭제

1. 인증 정보 > API 키에서 삭제할 API 키의 더보기 메뉴를 엽니다.
2. [삭제]를 클릭합니다.
3. 삭제 확인 창에 영구 삭제를 입력합니다.
4. API 키 이름과 연결된 엔드포인트 수를 확인한 후 [삭제] 버튼을 클릭합니다.

API 키를 삭제하면 해당 키를 사용하는 모든 엔드포인트 호출이 인증되지 않습니다. 애플리케이션에서 사용 중인지 먼저 확인하세요.

다음 단계

API 키와 엔드포인트 연결을 완료했다면 추론 API 호출을 참고하세요.