감정 분석 사용 가이드

사전 작업

카카오 i 클라우드의 감정 분석 API를 사용하기 위해서는 조직 소유자 또는 조직 관리자가 카카오 i 클라우드 콘솔에서 클라우드 조직 계정 및 프로젝트 생성, 사용자 초대, 조직 및 프로젝트 역할 추가 등의 작업을 완료해야 합니다. 따라서 카카오 i 클라우드 콘솔 또는 프로젝트 접근이 안 되는 경우에는 조직 소유자/관리자 또는 프로젝트 관리자에게 사용자 등록 또는 프로젝트 역할 추가를 요청하시기 바랍니다.

안내
사용자 초대 및 프로젝트 역할 추가 관련 프로세스는 Kakao i Cloud Console > 관리자 가이드를 참고하시기 바랍니다.

감정 분석 API 시작하기

감정 분석 API를 사용하기 위해서는 도메인 만들기, 인증정보 획득, API 한도 설정, API 호출 작업을 단계적으로 수행해야 합니다.

Step 1. 도메인 만들기

도메인이란 API를 호출하는 서비스의 단위이며, 카카오 i 클라우드에서 발급받을 수 있습니다. 도메인이 생성되면 API 호출 시에 필요한 API Key와 API Endpoint URL도 자동으로 생성됩니다.

카카오 i 클라우드 콘솔에서 좌측 상단 [메뉴] 아이콘을 클릭합니다.
전체 서비스의 Conversation 메뉴를 선택합니다.
서비스 탭에서 시작할 서비스로 감정 분석을 선택합니다.
서비스 이용 시작 팝업창에서 [도메인 만들기] 버튼을 클릭합니다.

도메인 만들기 팝업창에서 생성할 도메인 내용을 입력합니다.

도메인 만들기 이미지 도메인 정보 입력

구분	필수 여부	설명
서비스	필수	`감정 분석` 선택
도메인 이름	필수	해당 도메인의 이름 - 영어 소문자로 시작해야 함 - 4~20자로 제한 - 영문 소문자, 숫자, `-`만 입력 가능
도메인 설명	선택	해당 도메인에 대한 상세 설명을 입력 - 60자로 제한

도메인 탭에서 생성한 도메인을 확인합니다.

이미지 도메인 생성 확인

Step 2. 인증정보 획득하기

도메인을 생성하면, API 호출 시에 필요한 API Key와 API Endpoint URL을 발급받을 수 있습니다.

카카오 i 클라우드 콘솔에서 좌측 상단 [메뉴] 아이콘을 클릭합니다.
전체 서비스의 Conversation 메뉴를 선택합니다.
도메인 탭에서 생성한 도메인의 [인증 정보] 버튼을 클릭합니다.

API 인증정보 팝업창에서 API Key와 API Endpoint URL 정보를 확인합니다.

인증 정보

이미지 API 인증 정보

구분	설명
API Key	API Endpoint URL 호출에 필요한 API의 고유한 키 정보로 암호화하여 제공 - API Key를 재발급 받을 경우에는 기존에 발급받은 정보는 폐기됨
API Endpoint URL	API 호출 시에 사용하는 API Endpoint URL 주소

Step 3. API 한도 설정하기 (선택)

필요 시 API 사용 한도를 설정할 수 있습니다. 별도로 API 한도를 설정하지 않는다면 기본으로 지정된 최대 한도까지 호출할 수 있으며, 설정 한도를 초과할 경우에는 API가 호출되지 않습니다.

카카오 i 클라우드 콘솔에서 좌측 상단 [메뉴] 아이콘을 클릭합니다.
전체 서비스의 Conversation 메뉴를 선택합니다.
도메인 탭에서 생성한 도메인의 [한도 설정] 버튼을 클릭합니다.
API 사용 한도 설정 (선택) 팝업창에서 API 한도를 설정합니다.

이미지 API 사용 한도 설정

구분 설명

일별 한도 일별 API 사용 한도
- 최대값: 200,000건(기본값)

월별 한도 월별 API 사용 한도
- 최대값: 6,000,000건(기본값)