google240,000 cr/건당

Gemini 2.5 Pro TTS

Gemini 2.5 Pro 기반의 플래그십 TTS 모델로, 최신 LLM의 자연스러운 억양과 감정 표현을 살린 고품질 음성 합성을 제공합니다. 오디오북, 대화형 에이전트, 고품질 내레이션 등 사실적인 음성이 필요한 용도에 적합합니다.

엔드포인트

POST/api/v1/audio/speech

Base URL: https://billing-ai.doublezero.kr

인증

모든 API 요청에는 Authorization 헤더에 Bearer 토큰으로 API Key를 포함해야 합니다.

Authorization: Bearer YOUR_API_KEY

요청 파라미터

이름	타입	필수	설명	기본값
`model`*	string	* 필수	사용할 모델 ID. 이 페이지에서는 "gemini-2-5-pro-tts"를 사용합니다.	-
`input`*	string	* 필수	합성할 텍스트. 최대 2,000자. (별칭 text 도 허용)	-
`voice`	string	선택	음색. 미지정 시 기본 음색(Cherry)을 사용합니다.	`Cherry`
`language_type`	string	선택	음성 언어를 강제합니다. 미지정 시 입력 텍스트에서 자동 판별합니다. 예: "Korean", "English", "Chinese"	-

응답 필드

이름	타입	필수	설명	기본값
`(body)`*	binary	* 필수	합성된 오디오 바이너리(Content-Type: audio/wav 등)를 그대로 반환합니다. 파일로 저장해 재생하세요.	-
`X-Characters-Used`	number (header)	선택	과금에 사용된 글자수(한글·한자는 1자=2로 가중).	-

코드 예제

curl -X POST https://billing-ai.doublezero.kr/api/v1/audio/speech \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-2-5-pro-tts",
    "input": "안녕하세요, 빌링AI 음성 합성입니다.",
    "voice": "Cherry"
  }' \
  --output speech.wav

참고 사항

•응답 본문은 합성된 오디오 바이너리입니다. 파일로 저장해 재생하세요.
•지원 기능: 음성 합성, 텍스트 음성 변환, 다국어 음성, 감정 표현 음성