Classic/VPC 환경에서 이용 가능합니다.
API 키 발급 화면에서는 생성한 키의 발급 이력과 사용 가능 여부를 한눈에 확인할 수 있습니다.
API 키
CLOVA Studio API는 권한을 가진 사용자만 호출할 수 있도록 식별 도구인 API 키를 계정별로 발급하고 있습니다. API 키는 API 호출 시 인증 정보로 전달하는 요청 헤더의 파라미터로 사용합니다. 따라서 CLOVA Studio API를 사용하려면 우선 API 키를 발급받아야 합니다.
API 키 발급
API 키는 네이버 클라우드 플랫폼 콘솔의 CLOVA Studio에서 발급할 수 있습니다. 발급 방법은 다음과 같습니다.
- 네이버 클라우드 플랫폼 콘솔에서 Services > AI Services > CLOVA Studio메뉴를 차례대로 클릭해 주십시오.
- 화면 좌측에서 API 키 메뉴를 클릭해 주십시오.
- API 키 화면이 나타나면 발급할 API 키 탭 메뉴를 클릭한 다음 발급 버튼을 클릭해 주십시오.
- 테스트 API 키: [테스트] 탭 메뉴 클릭 > [테스트 API 키 발급] 버튼 클릭
- 서비스 앱을 제외한 CLOVA Studio API 호출 시 이용 가능
- 네이버 클라우드 플랫폼 메인 계정 기준 최대 10개까지 생성 가능
- 서비스 API 키: [서비스] 탭 메뉴 클릭 > [서비스 API 키 발급] 버튼 클릭
- 등록 완료된 서비스 앱의 CLOVA Studio API 호출 시 이용 가능
- 네이버 클라우드 플랫폼 메인 계정 기준 최대 10개까지 생성 가능
- 테스트 API 키: [테스트] 탭 메뉴 클릭 > [테스트 API 키 발급] 버튼 클릭
- API 키 복사 팝업 창이 나타나면 [발급] 버튼을 클릭해 주십시오.
- [복사] 버튼을 클릭한 다음 [완료] 버튼을 클릭해 주십시오.
서비스 키가 필요한 경우에는 서비스 앱을 새로 신청해 발급받아야 합니다.
API 키 복사 팝업 창을 닫은 후에는 발급한 API 키 확인이 불가능합니다. 따라서 발급 시점에 반드시 별도의 안전한 공간에 보관하여 주십시오.
테스트 앱
테스트앱의 API 키를 확인하는 방법은 다음과 같습니다.
- 네이버 클라우드 플랫폼 콘솔에서 Services > AI Services > CLOVA Studio 메뉴를 차례대로 클릭해 주십시오.
- 화면 좌측에서 API 키 메뉴를 클릭해 주십시오. 탭 메뉴를 클릭해 주십시오.
- API 키 화면이 나타나면 [Deprecated] 탭 메뉴를 클릭해 주십시오.
을 클릭한 다음 복사 메뉴를 클릭하여 API 키를 확인해 주십시오.- 우측 상단의 [API Gateway 키 보기] 버튼을 클릭해 주십시오.
API Gateway 키를 재발급하는 즉시 이전 키로 이용 중이었던 테스트 앱, 서비스 앱의 이용이 불가능해 집니다.
따라서 영향도 확인 및 사전 조치 후 반드시 필요한 경우에만 진행해 주십시오.
서비스 앱
서비스 앱의 API 키를 확인하는 방법은 다음과 같습니다.
- 네이버 클라우드 플랫폼 콘솔에서 Services > AI Services > CLOVA Studio 메뉴를 차례대로 클릭해 주십시오.
- 화면 좌측에서 서비스 앱 신청 메뉴를 클릭해 주십시오.
- 서비스 앱의 코드 보기 버튼을 클릭해 주십시오.
- [기존] 탭 메뉴를 클릭하여 서비스 앱의 구 버전 API 키를 확인한 다음 API Gateway 키를 확인해 주십시오.
- API 키:
X-NCP-CLOVASTUDIO-API-KEY - API Gateway 키:
X-NCP-APIGW-API-KEY
- API 키:
API 보안 설정
API 키가 제3자에게 유출되는 경우, CLOVA Studio 리소스를 임의로 이용하는 등 보안 문제가 발생할 수 있으므로 적절한 사전 대비와 대응이 필요합니다.
API 키 삭제 및 재발급
API 키를 사용하지 않거나 제3자의 도용이 의심된다면 발급한 API 키를 삭제한 후 다시 발급해야 합니다. 삭제 및 재발급 방법은 다음과 같습니다.
- 네이버 클라우드 플랫폼 콘솔에서 Services > AI Services > CLOVA Studio 메뉴를 차례대로 클릭해 주십시오.
- 화면 좌측에서 API 키 메뉴를 클릭해 주십시오.
- API 키 화면이 나타나면 삭제할 API 키가 있는 탭 메뉴를 클릭해 주십시오.
- 삭제할 API 키의
을 클릭한 다음 삭제 메뉴를 클릭해 주십시오. - API 키 삭제 팝업 창이 나타나면 [삭제] 버튼을 클릭해 주십시오.
- API 키 발급을 참조하여 새 API 키를 발급해 주십시오.
삭제한 API 키는 유효하지 않은 키로 인식되기 때문에 더 이상 API 호출에 사용할 수 없습니다. 따라서 영향도 확인 및 사전 조치 후 반드시 필요한 경우에만 진행해 주십시오.