Gemini TTS API
음성, 억양, 말하기 스타일, 속도를 화자별로 설정할 수 있는 다중 화자 대화용 Gemini TTS API를 RunAPI에서 사용하세요.
curl -X POST https://runapi.ai/api/v1/gemini_tts/text_to_speech \
-H "Authorization: Bearer $RUNAPI_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gemini-3.1-flash-tts",
"text": "차분한 영국인 진행자와 활기찬 미국인 게스트가 등장하는 2인 팟캐스트 오프닝을 만들어 주세요."
}'
import { GeminiTtsClient } from "@runapi.ai/gemini-tts";
const client = new GeminiTtsClient();
const result = await client.textToSpeech.run({
model: "gemini-3.1-flash-tts",
text: "차분한 영국인 진행자와 활기찬 미국인 게스트가 등장하는 2인 팟캐스트 오프닝을 만들어 주세요.",
});
require "runapi/gemini_tts"
client = RunApi::GeminiTts::Client.new
result = client.text_to_speech.run(
model: "gemini-3.1-flash-tts",
text: "차분한 영국인 진행자와 활기찬 미국인 게스트가 등장하는 2인 팟캐스트 오프닝을 만들어 주세요."
)
npx skills add runapi-ai/gemini-tts -g
# Claude Code
claude mcp add runapi -s user -- npx -y @runapi.ai/mcp
# Codex
codex plugin install runapi-mcp@agents
# Cursor / Windsurf / VS Code
npx @runapi.ai/mcp init cursor
Gemini TTS는 정해진 순서의 대화를 음성으로 변환하면서 화자별 음성 설정을 따로 유지합니다. 요청에는 장면, 전반적인 말하기 지침, 샘플링 온도도 지정할 수 있습니다.
- 품질과 지연 시간 목표에 맞춘 모델 변형
- 통합 API key
- Model skill에 docs, schema, 설정 메모 포함
- 실패한 생성은 과금되지 않습니다
변형
앱 개발을 위해 Gemini TTS skill 설치
모델 docs, schema, 가격 메모, 설정 단계를 코딩 워크스페이스로 불러옵니다.
# Install the model skill for app development workflows
npx skills add runapi-ai/gemini-tts -g
Install the Gemini TTS skill for this app: 1. Add runapi-ai/gemini-tts with the skills installer. 2. Load SKILL.md in this workspace. 3. Use its docs, schemas, pricing notes, and setup steps when adding model features. 4. Confirm the install path when done.
이 model skill로 구현하는 방법
모델 선택
출력 유형, 품질 기준, 지연 시간 목표에 맞는 모델과 변형을 고릅니다.
한 번 인증
모든 지원 모델에 RunAPI key를 사용합니다.
skill 설치
기능을 구현하기 전에 코딩 워크스페이스에 model skill을 추가합니다.
결과 받기
task ID로 조회하거나 생성 완료 시 callback을 처리합니다.
Gemini TTS의 위치
Gemini TTS는 RunAPI의 Google 카탈로그에 속하며, 일관된 API, SDK, CLI 인터페이스 하나로 Gemini 2.5 Pro TTS와 Gemini 3.1 Flash TTS를 제공합니다.
RunAPI로 Gemini TTS을 쓰는 이유
하나의 API key
모델과 제공사를 넘나들며 같은 인증 정보를 사용합니다.
Skill-ready
model skill에 schema, 설정 메모, 가격 컨텍스트, 모델 ID가 포함됩니다.
예측 가능한 과금
호출 전에 사용량 기반 가격을 확인할 수 있습니다.
자주 묻는 질문
사용 가능한 Gemini TTS 모델은 무엇인가요?
RunAPI는 Gemini 2.5 Pro TTS와 Gemini 3.1 Flash TTS를 동일한 텍스트 음성 변환(TTS) 엔드포인트와 요청 형식으로 지원합니다.
여러 화자를 구성하려면 어떻게 해야 하나요?
참여자마다 고유한 `Speaker N` 식별자로 화자 설정을 추가한 다음, 각 발화를 해당 식별자 중 하나에 지정하세요.
화자마다 무엇을 제어할 수 있나요?
화자마다 음성, 억양, 말하기 스타일, 속도를 지정할 수 있고, 세부 음성 지침이 필요하면 오디오 프로필도 선택적으로 사용할 수 있습니다.
장면과 샘플 컨텍스트는 요청에 어떤 영향을 주나요?
장면은 녹음 환경을 설명하고, 샘플 컨텍스트는 대화 전반의 어조와 말하기 지침을 정합니다.
완성된 오디오 결과는 어떤 방식으로 반환되나요?
작업을 조회하거나 완료된 뒤 콜백으로 결과를 받으세요. 응답의 `audios` 목록에 생성된 파일 URL이 포함됩니다.
이 모델은 어떻게 호출하나요?
model skill을 설치하고 RunAPI key와 함께 설정 메모를 따르세요.
실패한 생성도 비용이 드나요?
실패한 생성은 과금되지 않습니다
애플리케이션에서 호출할 수 있나요?
네. 코딩 워크스페이스에 model skill을 설치하고 모델 기능을 추가할 때 사용하세요.