Gemini 2.5 Pro 음성 합성 API — 보이스 30종, WAV 출력

Name: Gemini 2.5 Pro TTS API
SKU: google/gemini-2.5-pro-tts/text-to-speech
Price: 0.0007 USD
Availability: InStock

Gemini 2.5 Pro TTS 소개

Gemini 2.5 Pro text-to-speech는 대본을 30가지 목소리 중 하나로 읽어 24 kHz 모노 WAV로 돌려줍니다. 억양·스타일·속도는 평이한 말로 지시하고 [sighs] 같은 괄호 큐를 연기하며 대화는 목소리 2개까지 쓸 수 있습니다.

POST /jobs/createTask에서 모델 이름을 google/gemini-2.5-pro-tts/text-to-speech(으)로 지정하면 호출할 수 있습니다. 0.07크레딧/초부터(US$0.0007). 새 계정에는 30크레딧이 지급되니 Playground에서 먼저 무료로 써 보세요.

요청 파라미터

파라미터	필수	설명
`pace`	아니요	Rhythm of the reading. Omit it to keep the voice's own rhythm. natural · rapid_fire · the_drift · staccato
`text`	아니요	The words to be spoken, exactly as written. Cues in square brackets such as [sighs] are performed rather than read aloud.
`scene`	아니요	Where and to whom the words are spoken. Shapes the delivery and is not spoken.
`style`	아니요	미리 준비된 스타일이나 장르. whisper · empathetic · vocal_smile · newscaster · promo_hype · deadpan
`accent`	아니요	English accent used for the reading. neutral · american_general · american_valley · american_south · british_rp · british_brixton · transatlantic · australian · 기본값: neutral
`dialogue`	아니요	A scripted conversation, used instead of text: each line names a speaker from speakers.
`speakers`	아니요	The cast for dialogue: one or two voices, each with a name the lines refer to.
`voice_id`	아니요	사용 가능한 목소리 중에서 고릅니다. Achernar · Achird · Algenib · Algieba · Alnilam · Aoede · Autonoe · Callirrhoe · Charon · Despina · Enceladus · Erinome · Fenrir · Gacrux · Iapetus · Kore · Laomedeia · Leda · Orus · Puck · Pulcherrima · Rasalgethi · Sadachbia · Sadaltager · Schedar · Sulafat · Umbriel · Vindemiatrix · Zephyr · Zubenelgenubi · 기본값: Kore
`temperature`	아니요	Variation between takes; higher is less predictable. ≥ 0 · ≤ 2
`instructions`	아니요	How to read the text: pace, mood, distance from the microphone, who is listening. Shapes the delivery and is not spoken.

가격

가격은 웹사이트에서 쓰는 것과 같은 크레딧으로 표시됩니다(1크레딧 = $0.01). 작업이 접수될 때 먼저 보류되고, 끝나면 실제 요금으로 정산되며, 실패한 작업은 환불됩니다.

옵션	크레딧 /초	≈ USD
기본	0.07	US$0.0007

실행 전에 정확한 금액을 알고 싶다면 같은 본문을 POST /jobs/quote로 보내세요.

API 빠른 시작

Gemini 2.5 Pro TTS API를 3단계로 호출하기

API 키 만들기. PopNow에 로그인해 API 콘솔에서 키를 만드세요. 키는 sk-popnow-(으)로 시작하며 웹사이트와 같은 크레딧을 씁니다.
요청 보내기. POST /jobs/createTask에 model은 google/gemini-2.5-pro-tts/text-to-speech, input은 파라미터 표에 맞춰 보내세요. 응답으로 작업 ID가 바로 돌아옵니다.
결과 받기. 작업 ID로 GET /jobs/recordInfo를 폴링하거나 callBackUrl을 넘기면 결과를 그 주소로 보내 드립니다. 작업이 성공하면 출력 링크에서 내려받으세요.

# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $IDEMPOTENCY_KEY" \
  -d '{
  "model": "google/gemini-2.5-pro-tts/text-to-speech",
  "input": {
    "text": "Welcome back. Your files finished rendering a minute ago and are ready to download.",
    "voice_id": "Kore",
    "accent": "neutral"
  }
}'

# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

프롬프트와 링크는 직접 쓰는 것으로 바꾸세요. 응답, 폴링, 콜백 참고 자료는 API 탭에 있어요.

Gemini 2.5 Pro TTS API 질문

Gemini 2.5 Pro TTS API 요금은 얼마인가요?

Gemini 2.5 Pro TTS 가격은 0.07크레딧(US$0.0007) /초입니다. 크레딧은 웹사이트와 같으며(1크레딧 = $0.01), 새 계정에는 30크레딧이 무료로 제공되고, 실패한 작업은 환불됩니다.

API에서 Gemini 2.5 Pro TTS의 모델 이름은 무엇인가요?

POST /jobs/createTask의 model 필드에 텍스트 음성 변환: google/gemini-2.5-pro-tts/text-to-speech을(를) 넣으세요.

목소리 느낌은 어떻게 조절하나요?

voice_id로 목소리를, style로 whisper나 deadpan 같은 전체 말투를, accent로 영어 억양을, pace로 리듬을 고릅니다. instructions와 scene에는 분위기, 말하는 대상, 장소처럼 읽는 방식과 상황을 한두 문장으로 적습니다. 이 메모는 낭독에 반영되며 읽히지 않습니다. temperature로 테이크 간 변화 정도를 정합니다.