API 키

Prev Next

Classic/VPC 환경에서 이용 가능합니다.

API 키 발급 화면에서는 생성한 키의 발급 이력과 사용 가능 여부를 한눈에 확인할 수 있습니다.

API 키

CLOVA Studio API는 권한을 가진 사용자만 호출할 수 있도록 식별 도구인 API 키를 계정별로 발급하고 있습니다. API 키는 API 호출 시 인증 정보로 전달하는 요청 헤더의 파라미터로 사용합니다. 따라서 CLOVA Studio API를 사용하려면 우선 API 키를 발급받아야 합니다.

API 키 발급

API 키는 네이버 클라우드 플랫폼 콘솔의 CLOVA Studio에서 발급할 수 있습니다. 발급 방법은 다음과 같습니다.

  1. 네이버 클라우드 플랫폼 콘솔에서 Services > AI Services > CLOVA Studio메뉴를 차례대로 클릭해 주십시오.
  2. 화면 좌측에서 API 키 메뉴를 클릭해 주십시오.
  3. API 키 화면이 나타나면 발급할 API 키 탭 메뉴를 클릭한 다음 발급 버튼을 클릭해 주십시오.
    • 테스트 API 키: [테스트] 탭 메뉴 클릭 > [테스트 API 키 발급] 버튼 클릭
      • 서비스 앱을 제외한 CLOVA Studio API 호출 시 이용 가능
      • 네이버 클라우드 플랫폼 메인 계정 기준 최대 10개까지 생성 가능
    • 서비스 API 키: [서비스] 탭 메뉴 클릭 > [서비스 API 키 발급] 버튼 클릭
      • 등록 완료된 서비스 앱의 CLOVA Studio API 호출 시 이용 가능
      • 네이버 클라우드 플랫폼 메인 계정 기준 최대 10개까지 생성 가능
  4. API 키 복사 팝업 창이 나타나면 [발급] 버튼을 클릭해 주십시오.
  5. [복사] 버튼을 클릭한 다음 [완료] 버튼을 클릭해 주십시오.
참고

서비스 키가 필요한 경우에는 서비스 앱을 새로 신청해 발급받아야 합니다.

주의

API 키 복사 팝업 창을 닫은 후에는 발급한 API 키 확인이 불가능합니다. 따라서 발급 시점에 반드시 별도의 안전한 공간에 보관하여 주십시오.

테스트 앱

테스트앱의 API 키를 확인하는 방법은 다음과 같습니다.

  1. 네이버 클라우드 플랫폼 콘솔에서 Services > AI Services > CLOVA Studio 메뉴를 차례대로 클릭해 주십시오.
  2. 화면 좌측에서 API 키 메뉴를 클릭해 주십시오. 탭 메뉴를 클릭해 주십시오.
  3. API 키 화면이 나타나면 [Deprecated] 탭 메뉴를 클릭해 주십시오.
  4. i_clovastudio-more.png을 클릭한 다음 복사 메뉴를 클릭하여 API 키를 확인해 주십시오.
  5. 우측 상단의 [API Gateway 키 보기] 버튼을 클릭해 주십시오.
주의

API Gateway 키를 재발급하는 즉시 이전 키로 이용 중이었던 테스트 앱, 서비스 앱의 이용이 불가능해 집니다.
따라서 영향도 확인 및 사전 조치 후 반드시 필요한 경우에만 진행해 주십시오.

서비스 앱

서비스 앱의 API 키를 확인하는 방법은 다음과 같습니다.

  1. 네이버 클라우드 플랫폼 콘솔에서 Services > AI Services > CLOVA Studio 메뉴를 차례대로 클릭해 주십시오.
  2. 화면 좌측에서 서비스 앱 신청 메뉴를 클릭해 주십시오.
  3. 서비스 앱의 코드 보기 버튼을 클릭해 주십시오.
  4. [기존] 탭 메뉴를 클릭하여 서비스 앱의 구 버전 API 키를 확인한 다음 API Gateway 키를 확인해 주십시오.
    • API 키: X-NCP-CLOVASTUDIO-API-KEY
    • API Gateway 키: X-NCP-APIGW-API-KEY

API 보안 설정

API 키가 제3자에게 유출되는 경우, CLOVA Studio 리소스를 임의로 이용하는 등 보안 문제가 발생할 수 있으므로 적절한 사전 대비와 대응이 필요합니다.

API 키 삭제 및 재발급

API 키를 사용하지 않거나 제3자의 도용이 의심된다면 발급한 API 키를 삭제한 후 다시 발급해야 합니다. 삭제 및 재발급 방법은 다음과 같습니다.

  1. 네이버 클라우드 플랫폼 콘솔에서 Services > AI Services > CLOVA Studio 메뉴를 차례대로 클릭해 주십시오.
  2. 화면 좌측에서 API 키 메뉴를 클릭해 주십시오.
  3. API 키 화면이 나타나면 삭제할 API 키가 있는 탭 메뉴를 클릭해 주십시오.
  4. 삭제할 API 키의 i_clovastudio-more.png 을 클릭한 다음 삭제 메뉴를 클릭해 주십시오.
  5. API 키 삭제 팝업 창이 나타나면 [삭제] 버튼을 클릭해 주십시오.
  6. API 키 발급을 참조하여 새 API 키를 발급해 주십시오.
주의

삭제한 API 키는 유효하지 않은 키로 인식되기 때문에 더 이상 API 호출에 사용할 수 없습니다. 따라서 영향도 확인 및 사전 조치 후 반드시 필요한 경우에만 진행해 주십시오.