Gemini 3.1 Flash Tts Preview
Model ucapan Google untuk membacakan teks dengan pengaturan gaya narasi dan tag audio ekspresif.
Tentang model
Deskripsi ini mencakup kemampuan model. Masukan, keluaran, dan opsi yang tersedia di Ailoot tercantum di bawah untuk metode yang dipilih.
Gemini 3.1 Flash TTS Preview mengubah teks menjadi ucapan. Tujuannya adalah sintesis suara yang terdengar alami dengan pengaturan narasi melalui instruksi teks. Cara pengucapan dapat ditentukan bersama instruksi ucapan, sedangkan tag audio ekspresif membantu menyampaikan gaya yang diinginkan.
Teks menjadi audio
Masukan model ini adalah teks, sedangkan keluarannya rekaman audio. Batas masukan adalah 8 192 token, sedangkan keluaran 16 384 token. Model dirancang untuk sintesis ucapan dari teks yang telah disiapkan; model bukan model biasa untuk jawaban teks atau transkripsi rekaman yang diberikan.
Tersedia sintesis satu suara dan percakapan dengan beberapa pembicara. Pengaturan pengucapan didasarkan pada instruksi: karakter pembacaan dan ekspresi giliran bicara dapat dijelaskan. Untuk tugas ucapan berulang, produsen menyebutkan generasi batch.
Format hasil dan spesialisasi
Format mentah jawaban biasa adalah PCM tanpa header WAV. Ini merupakan karakteristik penting versi pratinjau khusus ini: byte yang dikembalikan tidak dapat otomatis dianggap sebagai berkas WAV yang siap digunakan.
Kartu model tidak mencantumkan penyimpanan konteks dalam cache, eksekusi kode, pencarian berkas, pemanggilan fungsi, grounding berbasis penelusuran, Google Maps, pembuatan gambar, jawaban teks terstruktur, Thinking, atau pembacaan isi alamat web. Sintesis ucapan merupakan tugas keluaran khususnya; kemampuan model teks tidak berlaku baginya secara otomatis.
Versi pratinjau
gemini-3.1-flash-tts-preview termasuk versi ucapan pratinjau sebelumnya. Cara mengendalikan suara dan format audionya perlu dipertimbangkan secara terpisah dari model TTS yang muncul kemudian. Versi ini tidak menyatakan pembuatan karakter suara baru atau peniruan suara dari contoh; jumlah bahasa yang didukung secara tepat tidak dicantumkan dalam kartunya.
Kemampuan yang dijelaskan berlaku bagi model itu sendiri. Cara pengiriman teks, pengaturan pembicara, dan perolehan berkas audio ditentukan oleh metode ucapan yang didukung.
Ailoot · Sintesis ucapan POST /v1/audio/speech gemini-3.1-flash-tts-preview
gemini-3.1-flash-tts-previewMulai
Model ucapan Google untuk membacakan teks dengan pengaturan gaya narasi dan tag audio ekspresif.
- Masukan yang diterima
- Teks
- Hasil
- speech
Tersedia di Ailoot · masukan & metode
Ailoot · Sintesis ucapan POST /v1/audio/speech
- Masukan
text- Keluaran
speech- Format keluaran
- byte audio asli atau tautan aset JSON
| Kolom | Jenis | Persyaratan | Nilai & batasan | Bawaan |
|---|---|---|---|---|
Kolommodel | Jenisstring | PersyaratanWajib | Nilai & batasan gemini-3.1-flash-tts-preview | Bawaan— |
Kolominput | Jenisstring | PersyaratanWajib | Nilai & batasan Panjang minimum: 1 | Bawaan— |
Kolomvoice | Jenisstring | PersyaratanOpsional | Nilai & batasan Kore | BawaanKore |
Kolomresponse_format | Jenisstring | PersyaratanOpsional | Nilai & batasan , wav, json | Bawaan |
Kolomstream_format | Jenisstring | PersyaratanOpsional | Nilai & batasan audio | Bawaan— |
Kombinasi bahan masukan
text_to_speech · Wajib: input
Parameter metode dan siklus hidup
| Parameter | Kontrak |
|---|---|
Parametermaterial_types | Kontraktext |
Parameterrequired | Kontraknull |
Parameteroptional_controls | Kontraknull |
Siklus hidup: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · task_id aktual yang dikembalikan atau catatan pustaka media
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Struktur metode dan ID bersifat eksak; kemampuan pemasok terpisah dari penerimaan permintaan.
Paket
Tarif metode Ailoot
POST /v1/audio/speech- Masukan
- US$0,001 / 1K
- Keluaran
- US$0,02 / 1K
Ailoot mencadangkan perkiraan dana sebelum permintaan. Setelah hasil diterima, tagihan akhir diselesaikan berdasarkan penggunaan yang terukur. Penyelesaian tagihan streaming menggunakan catatan penggunaan akhir. Cara kerja cadangan dan penyelesaian tagihan →
Contoh permintaan
Ailoot · Sintesis ucapan
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.1-flash-tts-preview", "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
Terima dan simpan hasil
Ailoot · Sintesis ucapan
byte audio asli atau tautan aset JSON
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
Simpan semua hasil yang selesai
Simpan setiap respons lengkap, berkas, dan bagian konten yang dikembalikan.
Satu keluaran secara bawaan berupa byte audio native dengan Content-Type aktual; response_format=json atau beberapa keluaran mengembalikan semua tautan yang dimiliki. Konversi sesuai permintaan ke MP3/Opus/AAC/FLAC/PCM dan keluaran SSE tidak tersedia.
Jika respons asli perlu diperiksa
Simpan operation_id/X-Client-Request-ID asli untuk rekonsiliasi tanpa pengiriman ulang; tidak ada rute polling khusus audio.
Kolom respons
| Kolom | Jenis |
|---|---|
Kolombinary native audio | Jenisbytes |
Kolommodel | Jenisstring |
Kolomresponse_id | Jenisstring |
Kolomactual_count | Jenisinteger |
Kolomdata[] | Jenisowned audio asset link |
Kesalahan dan langkah berikutnya
| Respons | Kondisi | Langkah berikutnya |
|---|---|---|
Respons400 · invalid_request_error | KondisiBidang wajib, representasi materi, atau nilai parameter tidak valid | Langkah berikutnyaPerbaiki bidang yang ditunjukkan sebelum permintaan pembuatan baru. |
Responsserver_error | KondisiRespons yang dikembalikan menyatakan bahwa operasi atau hasil perlu diperiksa | Langkah berikutnyaSimpan ID operasi/tugas asli yang dikembalikan, header permintaan, dan respons; lanjutkan pembacaan yang didukung untuk operasi asli tersebut. Jangan kirim ulang permintaan pembuatan. |
Alias
Alias model
Ailoot gemini-3.1-flash-tts-preview
Alias jalur metode
Gunakan jalur metode yang ditampilkan di atas.
ID pemanggil terkait
FAQ · Gemini 3.1 Flash Tts Preview
- Input dan hasil apa yang tersedia?
POST /v1/audio/speech·gemini-3.1-flash-tts-preview:text→speech- Kolom apa yang digunakan permintaan?
POST /v1/audio/speech·gemini-3.1-flash-tts-preview:model,input,voice,response_format,stream_format