google입력: 120,000 cr/100만 토큰, 출력: 2,400,000 cr/100만 토큰

Gemini 2.5 Flash TTS

Google Gemini 2.5 Flash 기반 음성 합성(TTS). 30종 음색과 90개 이상 언어를 지원하며, 자연스러운 스타일 제어가 가능합니다. Vertex AI 직접 연동(GCP 크레딧).

엔드포인트

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-flash-tts"를 사용합니다.	-
`input`*	string	* 필수	합성할 텍스트. (별칭 text 도 허용)	-
`voice`	string	선택	음색. Kore, Zephyr, Puck, Charon, Fenrir, Leda, Orus, Aoede 등 30종 중에서 선택합니다.	`Kore`

응답 필드

이름	타입	필수	설명	기본값
`(body)`*	binary	* 필수	합성된 오디오 바이너리를 그대로 반환합니다(Content-Type은 response_format 에 따르며, mp3→audio/mpeg, wav→audio/wav). 파일로 저장해 재생하세요.	-
`X-Input-Tokens`	number (header)	선택	과금에 사용된 입력(텍스트) 토큰 수.	-
`X-Output-Tokens`	number (header)	선택	과금에 사용된 출력(오디오) 토큰 수.	-

코드 예제

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-flash-tts",
    "input": "안녕하세요, 빌링AI 음성 합성입니다.",
    "voice": "Kore"
  }' \
  --output speech.wav

참고 사항

•응답 본문은 합성된 오디오 바이너리입니다. 파일로 저장해 재생하세요.
•지원 기능: 음성 합성(TTS), 텍스트-음성 변환, 30종 음색, 다국어 음성, 스타일 제어