CLOVA Studio 개요

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

CLOVA Studio는 초대규모(Hyperscale) AI 기술인 HyperCLOVA X 언어 모델을 활용하여 사용자가 입력한 내용에 따라 AI 기술을 통해 생성된 문구를 출력하는 네이버 클라우드 플랫폼의 서비스입니다. CLOVA Studio 서비스에서는 문장 생성, 튜닝, 익스플로러, 스킬 트레이너 기능에 대한 API를 RESTful 형태로 제공합니다.

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 호출 시 이용 가능
   • 서비스 API 키: 서비스 탭 선택 > 서비스 API 키 발급
     • 서비스 앱을 포함한 모든 CLOVA Studio API 호출 시 이용 가능
4. API 키 발급 팝업 창이 나타나면 발급 버튼을 클릭해 주십시오.
   • API 키 복사 팝업 창에서 발급된 API 키를 복사합니다.

API 보안 설정

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

API 키 삭제 및 재발급

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

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

공통 설정

CLOVA Studio API에서 공통으로 사용하는 형식 및 설정을 설명합니다.

테스트 앱 생성

CLOVA Studio API를 사용하려면 테스트 앱 또는 서비스 앱을 생성해야 합니다. 앱은 네이버 클라우드 플랫폼 콘솔에서 생성할 수 있습니다. 자세한 내용은 CLOVA Studio 사용 가이드를 참조해 주십시오.

요청

공통 요청 형식을 설명합니다.

API URL

요청 API URL은 다음과 같습니다.

https://clovastudio.stream.gov-ntruss.com/

요청 헤더

요청 헤더에 대한 설명은 다음과 같습니다.

응답

공통 응답 형식을 설명합니다.

응답 바디

응답 바디에 대한 설명은 다음과 같습니다.

응답 예시

응답 예시는 다음과 같습니다.

• 성공

  {
    "status": {
      "code": "20000",
      "message": "OK"
    },
    "result": {}
  }
  

• 실패(클라이언트 오류)

  {
  "status": {
  "code": "40102",
  "message": "Invalid access token"
      }
  }
  

• 실패(서버 오류)

  {
  "status": {
  "code": "50000",
  "message": "Internal Server Error"
      }
  }
  

CLOVA Studio API

CLOVA Studio에서 제공하는 API는 다음과 같습니다.

CLOVA Studio 연관 리소스

CLOVA Studio API에 대한 사용자의 이해를 돕기 위해 다양한 연관 리소스를 제공하고 있습니다.

• CLOVA Studio API 사용 방법
  • API 개요: 네이버 클라우드 플랫폼에서 발급받은 Access Key, Secret Key 발급 및 확인, 요청 헤더에 필요한 서명 생성 방법
  • Sub Account 사용 가이드: 네이버 클라우드 플랫폼에서 발급받은 서브 계정의 Access Key 발급 및 확인 방법
• CLOVA Studio 서비스 사용 방법
  • CLOVA Studio 사용 가이드: 네이버 클라우드 플랫폼 콘솔에서 CLOVA Studio 사용하는 방법
  • Ncloud 사용 환경 가이드: VPC, Classic 환경 및 지원 여부에 관한 사용 가이드
  • 요금 소개, 특징, 상세 기능: CLOVA Studio의 요금 체계, CLOVA Studio의 특징, 상세 기능 및 활용 예시 요약
  • 서비스 최신 소식: CLOVA Studio 관련 최신 소식
  • 문의하기: 사용 가이드를 통해서도 궁금증이 해결되지 않는 경우 직접 문의