Gemini 3.8 Flash Tts
목소리를 조절하며 표현력 있는 음성, 오디오북, 대화를 만드는 Google 음성 모델로, 130개 언어를 지원합니다.
모델 소개
이 설명은 모델의 기능을 다룹니다. Ailoot에서 사용할 수 있는 입력, 출력 및 옵션은 아래에 선택한 메서드별로 표시됩니다.
Gemini 3.8 Flash TTS는 표현력 있는 음성 제작과 긴 이야기 읽기를 위한 모델입니다. Google은 오디오북, 여러 화자의 대화, 긴 구간에서의 목소리 안정성을 강조합니다. 음성 제어는 지역별 억양과 방언을 포함한 감정 표현, 리듬, 발음을 다룹니다.
목소리와 언어
모델은 러시아어를 포함한 130개 언어를 지원한다고 명시되어 있습니다. 기본 목소리 30개, 확장 라이브러리, 설명 기반 목소리 생성, 음성 샘플 기반 목소리 재현을 사용할 수 있습니다. 이러한 기능으로 개별 자료에 맞는 음색과 표현의 성격을 선택할 수 있습니다.
대화의 발화는 화자와 연결됩니다. 여러 화자가 있는 하나의 요청에서는 기본 목소리를 최대 두 개 사용할 수 있습니다. 설명이나 샘플로 만든 목소리는 발화를 별도로 합성합니다. 이런 목소리가 있다는 사실이 다중 음성 요청에 추가 기본 목소리로 포함된다는 뜻은 아닙니다.
텍스트와 표현 제어
입력은 텍스트, 출력은 오디오입니다. 제한은 8 192 입력 토큰과 16 384 출력 토큰입니다. 텍스트는 실제로 읽을 발화로 해석하며, 스타일 설명과 선택한 화자는 별도로 지정합니다. 이를 통해 들려야 할 단어와 읽는 방식에 대한 지시를 구분할 수 있습니다.
스타일에는 감정, 속도, 음량, 운율이 포함됩니다. 웃음, 한숨, 멈춤 같은 짧은 이벤트는 발화 안의 특수 오디오 태그로 지정합니다. 이런 태그는 표현을 제어하는 용도이며 일반적인 읽기 대상 단어가 아닙니다.
오디오 형식과 기능
일반 생성에서는 기본으로 WAV를 반환합니다. 스트리밍의 기본 형식은 헤더 없는 PCM입니다. 기본 설정은 24kHz, 단일 채널, 16비트입니다. PCM, mu-law, A-law도 제공합니다. 컨텍스트 캐싱과 배치 처리를 지원합니다. 구체적인 파일 형식과 사용 가능한 설정은 선택한 음성 호출 방식에 따라 달라집니다.
모델은 음성 생성에 특화되어 있습니다. 함수 호출, 코드 실행, 파일 검색, 검색 기반 그라운딩, Google Maps, 이미지 생성, 구조화된 텍스트 응답, Thinking, 웹 주소의 내용은 지원하지 않습니다. 안정적인 목소리와 조절 가능한 표현력은 모델이 제시한 방향이며, 모든 발화의 완벽한 발음을 약속하는 것은 아닙니다.
Ailoot · 음성 합성 POST /v1/audio/speech gemini-3.8-flash-tts
gemini-3.8-flash-tts시작하기
목소리를 조절하며 표현력 있는 음성, 오디오북, 대화를 만드는 Google 음성 모델로, 130개 언어를 지원합니다.
- 허용 입력
- 텍스트
- 결과
- 오디오
Ailoot에서 사용 가능 · 입력 및 메서드
Ailoot · 음성 합성 POST /v1/audio/speech
- 입력
text- 출력
audio- 컨텍스트
- 8,192 tokens
- 최대 출력
- 16,384 tokens
- 출력 형식
- 네이티브 오디오 바이트 또는 JSON 자산 링크
| 필드 | 유형 | 요건 | 값과 한도 | 기본값 |
|---|---|---|---|---|
필드model | 유형string | 요건필수 | 값과 한도 gemini-3.8-flash-tts | 기본값— |
필드input | 유형string | 요건필수 | 값과 한도 최소 길이: 1 | 기본값— |
필드voice | 유형string | 요건선택 사항 | 값과 한도 Achernar, Achird, Algenib, Algieba, Alnilam, Aoede, Arlo, Autonoe, Bodi, Brio, Callirrhoe, Charon, Cleo, Cruz, Daro, Despina, Elio, Enceladus, Enya, Enzo, Erinome, Fenrir, Finn, Fola, Gacrux, Gero, Hali, Iapetus, Jett, Jori, Kira, Knox, Koda, Kore, Laomedeia, Leda, Lora, Ludo, Lumi, Mako, Milo, Neno, Nika, Nyla, Olin, Orus, Puck, Pulcherrima, Rami, Rasalgethi, Riko, Rina, Sadachbia, Sadaltager, Sami, Schedar, Sola, Sulafat, Tari, Tavi, Tova, Umbriel, Varo, Veda, Vindemiatrix, Zali, Zeno, Zephyr, Zubenelgenubi, Zuri | 기본값Kore |
필드response_format | 유형string | 요건선택 사항 | 값과 한도 , wav, json | 기본값 |
필드stream_format | 유형string | 요건선택 사항 | 값과 한도 audio | 기본값— |
입력 자료 조합
text_to_speech · 필수: input
메서드 매개변수와 수명 주기
| 매개변수 | 명세 |
|---|---|
매개변수material_types | 명세text |
매개변수required | 명세null |
매개변수optional_controls | 명세null |
수명 주기: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · 실제로 반환된 task_id 또는 미디어 라이브러리 기록
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
메서드 형식과 ID는 정확합니다. 공급자의 기능 지원과 요청 수락은 별개입니다.
요금
Ailoot 메서드 요금
POST /v1/audio/speech- 입력
- US$0.0005 / 1K
- 출력
- US$0.009 / 1K
- 캐시 읽기
- US$0.000125 / 1K
Ailoot는 요청 전에 예상 금액을 미리 확보합니다. 결과를 받은 뒤 측정된 사용량을 기준으로 최종 요금을 정산합니다. 스트리밍 정산에는 최종 사용량 기록을 사용합니다. 금액 확보와 정산 방식 →
요청 예제
Ailoot · 음성 합성
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_TEXT_FILE:?Set your actual UTF-8 narration script}"
export AILOOT_TEXT_FILE
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "gemini-3.8-flash-tts", "input": ""}')
f=Path(os.environ["AILOOT_TEXT_FILE"])
if not f.is_file():raise SystemExit("Choose your actual UTF-8 source material")
text=f.read_text(encoding="utf-8")
if not text.strip():raise SystemExit("Source material must contain text")
p["input"]=text
Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/audio/speech \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o speech.wav
결과 수신 및 저장
Ailoot · 음성 합성
네이티브 오디오 바이트 또는 JSON 자산 링크
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
완료된 결과 모두 보관
반환된 완전한 응답, 파일, 콘텐츠 부분을 모두 보관하세요.
단일 출력은 기본적으로 실제 Content-Type의 네이티브 오디오 바이트를 반환합니다. response_format=json이거나 출력이 여러 개이면 소유한 모든 링크를 반환합니다. 요청한 MP3/Opus/AAC/FLAC/PCM 변환이나 SSE는 제공하지 않습니다.
원래 응답을 확인해야 할 경우
다시 제출하지 말고 정산 대조를 위해 최초 operation_id/X-Client-Request-ID를 보관하세요. 전용 오디오 폴링 라우트는 없습니다.
응답 필드
| 필드 | 유형 |
|---|---|
필드binary native audio | 유형bytes |
필드model | 유형string |
필드response_id | 유형string |
필드actual_count | 유형integer |
필드data[] | 유형owned audio asset link |
오류와 다음 단계
| 응답 | 조건 | 다음 단계 |
|---|---|---|
응답400 · invalid_request_error | 조건필수 필드, 자료 표현 방식 또는 파라미터 값이 올바르지 않음 | 다음 단계새 생성 요청 전에 표시된 필드를 수정하세요. |
응답server_error | 조건반환된 응답에 작업 또는 결과 확인이 필요하다고 표시되어 있습니다 | 다음 단계최초로 반환된 작업/태스크 ID, 요청 헤더와 응답을 보관하고, 지원되는 조회 방식으로 해당 최초 작업을 계속 조회하세요. 생성 요청을 다시 제출하지 마세요. |
별칭
모델 별칭
Ailoot gemini-3.8-flash-tts
메서드 경로 별칭
위에 표시된 메서드 경로를 사용하세요.
관련 호출용 ID
FAQ · Gemini 3.8 Flash Tts
- 어떤 입력과 결과를 사용할 수 있나요?
POST /v1/audio/speech·gemini-3.8-flash-tts:text→audio- 요청은 어떤 필드를 사용하나요?
POST /v1/audio/speech·gemini-3.8-flash-tts:model,input,voice,response_format,stream_format- 어떤 제한이 적용되나요?
POST /v1/audio/speech·gemini-3.8-flash-tts:ctx:8192;max_out:16384