Naver Clova API 사용법

태그
DevelopmentTool
생성일
Feb 17, 2025
날짜
Last updated February 17, 2025

Naver Clova API 개요

notion image
Naver Clova API는 네이버 클라우드(Naver Cloud)에서 제공하는 AI 기반 음성 및 언어 처리 서비스입니다.
이 API를 사용하면 텍스트를 음성으로 변환(TTS) 하거나 음성을 텍스트(STT)로 변환, 문서를 스캔하여 텍스트 추출(OCR) 하는 기능을 구현할 수 있습니다.
이를 통해 챗봇, 스마트 스피커, 음성 비서, 자동응답 시스템 등의 서비스를 개발할 수 있습니다.
네이버 클로바 API는 사용량에 따라 비용이 발생할 수 있습니다.
자세한 요금제 및 이용 제한 사항은 네이버 클라우드 공식 홈페이지를 참고하세요.

Naver Clova API 주요 기능

  1. Clova Voice (Text-to-Speech, TTS)
      • 텍스트를 자연스러운 음성으로 변환하는 AI 기반 음성 합성 기술 제공
      • 다양한 언어 및 음성 지원 (한국어, 영어, 일본어 등)
      • 속도, 음높이, 볼륨 조절 가능
      • 다양한 스피커(목소리) 선택 가능 (예: vgoeun, nsabina, shinji 등)
      ex) 예제 활용 분야
      ✔️ 오디오북 및 팟캐스트 생성
      ✔️ AI 콜센터 및 챗봇 음성 응답
      ✔️ 다국어 지원 스마트 비서

  1. Clova Speech (Speech-to-Text, STT)
      • 음성을 텍스트로 변환하는 AI 기반 STT 기술 제공
      • 다양한 오디오 포맷 지원 (wav, mp3, m4a 등)
      • 실시간 음성 변환 및 사전 녹음된 음성 변환 가능
      • 콜센터, 회의록 자동 생성, 음성 검색 등에 활용 가능
      ex) 예제 활용 분야
      ✔️ 실시간 회의록 작성
      ✔️ 음성 검색 및 음성 명령 처리
      ✔️ 음성 기반 챗봇 시스템

  1. Clova OCR (Optical Character Recognition)
      • 이미지에서 텍스트를 추출하는 AI OCR 기술 제공
      • 문서, 간판, 명함, 손글씨 등에서 텍스트 인식 가능
      • 한국어, 영어, 일본어, 중국어 등 다국어 지원
      ex) 예제 활용 분야
      ✔️ 문서 스캔 및 디지털화
      ✔️ 차량 번호판 인식
      ✔️ AI 명함 스캐너

Naver Clova API 활용 사례

기능
활용 사례
TTS (텍스트 → 음성 변환)
AI 음성 비서, 오디오북, 자동 응답 시스템
STT (음성 → 텍스트 변환)
음성 명령어 인식, 콜센터 상담 기록 변환
OCR (문자 인식)
문서 스캔 및 텍스트 변환

Naver Clova API 키 발급 방법

Naver Clova API를 사용하려면 네이버 클라우드 플랫폼(Naver Cloud Platform)에서 API 인증 정보(Client ID & Secret)**를 발급받아야 합니다.

API 키 발급

  1. 네이버 클라우드 회원가입 및 로그인
  1. 새 프로젝트 생성
    1. notion image
  • "AI 서비스" → "CLOVA Voice / CLOVA Speech Recognition" 이동
  1. API 활성화
      • "API 사용 설정" 클릭 후 Billing(결제 정보) 등록
  1. API 인증 정보 확인
      • "마이페이지" → "인증 정보" 이동
      • Client ID & Client Secret 복사하여 저장

.env 파일에 API 키 저장하기

API 인증 정보를 .env 파일에 저장하면 보안성이 강화됩니다.
CLOVA_TTS_CLIENT_ID=YOUR_CLIENT_ID CLOVA_TTS_CLIENT_SECRET=YOUR_CLIENT_SECRET CLOVA_SPEECH_RECOGNIZER_CLIENT_ID=YOUR_CLIENT_ID CLOVA_SPEECH_RECOGNIZER_CLIENT_SECRET=YOUR_CLIENT_SECRET CLOVA_SPEAKER=vgoeun

보안 주의사항

  • API 키를 절대 공용 저장소(GitHub, GitLab 등)에 업로드하면 안 됩니다.
  • .gitignore 파일에 credentials.json.env 파일을 추가하여 보호
credentials.json .env
  • API 키는 보안 관리 도구(예: AWS Secrets Manager, Vault) 등을 사용하여 관리하는 것이 좋습니다.