🎙️ Google Cloud Text-to-Speech 서비스키 만들기
AI 음성합성(Text-to-Speech)을 이용해 나레이션, 유튜브 음성, 오디오북을 자동 생성하려면
Google Cloud의 Text-to-Speech API를 사용할 수 있습니다.
이 기능을 사용하려면 반드시 **“서비스 계정(Service Account)”**과 **“인증 키(JSON)”**가 필요합니다.
오늘은 그 과정을 완전 초보자도 따라 할 수 있게 자세히 안내해 드릴게요.
1️⃣ Google Cloud Console 접속하기
👉 https://console.cloud.google.com
- 구글 계정으로 로그인하세요.
- 상단 검색창에 “Text-to-Speech”를 입력하고 프로젝트를 하나 생성합니다.
- 예: Text-to-Speech 또는 tts-project
- 프로젝트가 만들어지면 다음과 같은 화면이 뜹니다.
💡 팁: 한 번 만든 프로젝트는 계속 재사용할 수 있습니다.
2️⃣ IAM 및 관리자 메뉴 열기
- 왼쪽 상단의 ≡ 햄버거 메뉴(세 줄) 클릭
- 아래로 스크롤하면 “IAM 및 관리자(IAM & Admin)” 항목이 보입니다.
- 클릭해서 하위 메뉴를 펼친 뒤 “서비스 계정(Service Accounts)” 선택
보이지 않으면 “IAM”을 검색창에 직접 입력해도 됩니다.
출처 입력
AI 활용 설정
사진 설명을 입력하세요.
AI 활용 설정
사진 설명을 입력하세요.
3️⃣ 새 서비스 계정 만들기
- 화면 상단의 “+ 서비스 계정 만들기” 버튼 클릭
- 아래 항목 입력
- 서비스 계정 이름: tts-service
- 서비스 계정 ID는 자동 생성됩니다.
- “만들기 및 계속” 클릭
4️⃣ 역할(Role) 부여하기
이 계정이 Text-to-Speech API를 사용할 수 있도록 권한을 줘야 합니다.
- 역할 검색창에 “Text”를 입력합니다.
- “Text-to-Speech User” 역할을 선택
- “계속” → “완료” 클릭
✅ 이제 tts-service 계정이 생성되었습니다.
5️⃣ JSON 키 만들기 (가장 중요한 단계!)
- 방금 만든 tts-service 클릭
- 상단 탭 중 “키(Keys)” 선택
- “키 추가(Add Key)” → “새 키 만들기(Create new key)” 클릭
- 형식으로 JSON 선택 → “만들기(Create)” 클릭
- 자동으로 .json 파일이 다운로드됩니다.
이 파일이 바로 Text-to-Speech API 인증키입니다! 🔑
6️⃣ JSON 파일 준비하기
- 다운로드된 파일 이름을 service_key.json 으로 변경합니다.
- 여러분의 Python 코드가 있는 폴더(예: google_tts_auto.py 파일 옆)에 함께 둡니다.
예시 구조:
📁 내프로젝트/ ┣ 📄 google_tts_auto.py ┗ 📄 service_key.json
7️⃣ 코드 연결하기
Python 코드의 초반부에 아래 코드를 추가하세요 👇
import os os.environ["GOOGLE_APPLICATION_CREDENTIALS"] = "./service_key.json"
이렇게 하면 구글 API가 자동으로 인증키를 인식합니다.
8️⃣ API 활성화 확인
- 왼쪽 메뉴에서 “API 및 서비스 → 라이브러리” 클릭
- “Text-to-Speech API”를 검색
- “사용 설정(Enable)” 버튼을 눌러 활성화
이 단계가 빠지면 인증이 되어도 작동하지 않습니다.
출처 입력
9️⃣ 과금 설정 (무료 한도 포함)
Text-to-Speech API는 월 400만 문자까지 무료로 사용할 수 있습니다.
처음에는 결제 정보를 등록해야 하지만, 실제로 사용량이 적으면 무료로 유지됩니다.
- 결제 활성화 링크
- 무료 크레딧이 제공됩니다 (약 300달러, 90일 유효)
🏁 마무리
이제 service_key.json 파일을 이용해 Python에서
Google Text-to-Speech API를 자유롭게 활용할 수 있습니다 🎙️
✔️ 음성 파일 자동 생성
✔️ 유튜브 내레이션 자동화
✔️ 뉴스 기사 오디오 변환 등
from google.cloud import texttospeech
import os
os.environ["GOOGLE_APPLICATION_CREDENTIALS"] = "./service_key.json"
client = texttospeech.TextToSpeechClient()
input_text = texttospeech.SynthesisInput(text="안녕하세요, 구글 클라우드 음성합성입니다.")
voice = texttospeech.VoiceSelectionParams(language_code="ko-KR", name="ko-KR-Neural2-B")
audio_config = texttospeech.AudioConfig(audio_encoding=texttospeech.AudioEncoding.MP3)
response = client.synthesize_speech(
input=input_text, voice=voice, audio_config=audio_config
)
with open("output.mp3", "wb") as out:
out.write(response.audio_content)
print("✅ output.mp3 파일 생성 완료!")