CLOVA Studio 개요

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

CLOVA Studio 서비스는 초대규모(Hyperscale) AI 기술인 HyperCLOVA X 언어 모델을 활용하여 사용자가 입력한 내용에 따라 AI 기술을 통해 생성된 문구를 출력하는 네이버 클라우드 플랫폼의 서비스입니다.

CLOVA Studio API

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

API 키

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

API 키 발급

API 키 발급과 관리는 CLOVA Studio의 API 키 화면에서 진행합니다. 방법은 다음과 같습니다.

1. CLOVA Studio에 접속해 주십시오.
2. 프로필 > API 키 메뉴를 차례대로 클릭해 주십시오.
3. API 키에서 생성하고자 하는 API 키 종류에 해당하는 탭 선택 후, 우측 상단의 버튼을 클릭해주세요.
   • 테스트 API 키: 테스트 탭 선택 > 테스트 API 키 발급
     • 서비스 앱을 제외한 CLOVA Studio API 호출 시 이용 가능
   • 서비스 API 키: 서비스 탭 선택 > 서비스 API 키 발급
     • 서비스 앱을 포함한 모든 CLOVA Studio API 호출 시 이용 가능
4. API 키 발급 팝업에서 발급 버튼을 클릭하여 API 키를 확인해주세요.
   • 발급받은 API 키를 복사하여 별도의 안전한 공간에 보관하여 이용해주세요.
   주의

   • API 키 복사 팝업을 닫은 후엔 해당 API 키를 다시는 확인하지 못하므로 반드시 발급 시점에 별도의 안전한 공간에 보관하여 이용해주시기 바랍니다.
5. 이후 발급받은 API 키를 이용하여 CLOVA Studio API를 호출해주세요.

API 보안 설정

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

API 키 삭제 및 재발급

API 키를 사용하지 않거나 도용이 의심된다면 발급한 API 키를 삭제해 주십시오. 방법은 다음과 같습니다.

1. CLOVA Studio에 접속해 주십시오.
2. 프로필 > API 키 메뉴를 차례대로 클릭해 주십시오.
3. 삭제하고자 하는 API 키 종류에 해당하는 탭 선택 후, 삭제하고자 하는 API 키 항목 우측의 > 삭제 메뉴를 클릭해주세요.

공통 설정

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

테스트 앱 생성

필요에 따라 CLOVA Studio API를 사용하기 위해 테스트 앱 또는 서비스 앱을 생성해야 할 수 있습니다. 자세한 내용은 CLOVA Studio 사용 가이드를 참조해 주십시오.

요청

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

API URL

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

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

요청 헤더

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

응답

CLOVA Studio API에서 공통으로 사용하는 응답 형식을 설명하고 구문 예시를 안내합니다.

바디

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

구문

공통 응답 구문 예시를 안내합니다.

• 성공

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

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

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

• 실패(서버 오류)

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