Gemini 3.1 Flash Tts Preview
Een spraakmodel van Google om tekst uit te spreken, met sturing van de vertelstijl en expressieve audiotags.
Over het model
Deze beschrijving gaat over de mogelijkheden van het model. De via Ailoot beschikbare invoer, uitvoer en opties staan hieronder voor de geselecteerde methode.
Gemini 3.1 Flash TTS Preview zet tekst om in spraak. Het is bedoeld voor natuurlijk klinkende gesproken tekst, waarbij de vertelling via tekstinstructies wordt gestuurd. De manier van uitspreken kan samen met de spraakinstructies worden opgegeven, terwijl expressieve audiotags helpen de gewenste voordracht over te brengen.
Tekst wordt audio
De invoer van dit model is tekst en de uitvoer een audio-opname. De maximale invoeromvang is 8 192 tokens en de uitvoer 16 384 tokens. Het is ontworpen voor spraaksynthese op basis van voorbereide tekst; het is geen gewoon model voor een tekstantwoord of voor het transcriberen van een aangeleverde opname.
Uitspraak met één stem en dialogen met meerdere sprekers zijn voorzien. De uitspraak wordt met instructies gestuurd: het karakter van de lezing en de expressiviteit van uitspraken kunnen worden beschreven. Voor terugkerende spraaktaken noemt de fabrikant batchgeneratie.
Resultaatformaat en specialisatie
Het ruwe formaat van een gewoon antwoord is PCM zonder WAV-header. Dit is een belangrijke eigenschap van juist deze voorlopige versie: de teruggegeven bytes mogen niet automatisch als een kant-en-klaar WAV-bestand worden beschouwd.
De modelkaart vermeldt geen contextcaching, code-uitvoering, zoeken in bestanden, functieaanroepen, onderbouwing via zoekresultaten, Google Maps, beeldgeneratie, gestructureerde tekstantwoorden, Thinking of het lezen van de inhoud van webadressen. Spraaksynthese is de gespecialiseerde uitvoertaak; de mogelijkheden van tekstmodellen worden er niet op overgedragen.
Een voorlopige versie
gemini-3.1-flash-tts-preview behoort tot eerdere voorlopige spraakversies. De manieren om de stem te sturen en het audioformaat moeten afzonderlijk van latere TTS-modellen worden bekeken. Deze versie vermeldt niet het creëren van een nieuwe stemidentiteit of het reproduceren van een stem uit een voorbeeld; het exacte aantal ondersteunde talen staat niet op de kaart.
De beschreven mogelijkheden betreffen het model zelf. De precieze manier om tekst en sprekerinstellingen aan te leveren en het audiobestand te ontvangen, hangt af van de ondersteunde spraakmethode.
Ailoot · Spraakgeneratie POST /v1/audio/speech gemini-3.1-flash-tts-preview
gemini-3.1-flash-tts-previewAan de slag
Een spraakmodel van Google om tekst uit te spreken, met sturing van de vertelstijl en expressieve audiotags.
- Toegestane invoer
- Tekst
- Resultaten
- speech
Beschikbaar in Ailoot · invoer en methoden
Ailoot · Spraakgeneratie POST /v1/audio/speech
- Invoertypen
text- Uitvoertypen
speech- Uitvoerformaat
- native audiobytes of JSON-assetlinks
| Veld | Type | Vereiste | Waarden en limieten | Standaard |
|---|---|---|---|---|
Veldmodel | Typestring | VereisteVereist | Waarden en limieten gemini-3.1-flash-tts-preview | Standaard— |
Veldinput | Typestring | VereisteVereist | Waarden en limieten Minimumlengte: 1 | Standaard— |
Veldvoice | Typestring | VereisteOptioneel | Waarden en limieten Kore | StandaardKore |
Veldresponse_format | Typestring | VereisteOptioneel | Waarden en limieten , wav, json | Standaard |
Veldstream_format | Typestring | VereisteOptioneel | Waarden en limieten audio | Standaard— |
Combinaties van invoermaterialen
text_to_speech · Vereist: input
Methodeparameters en levenscyclus
| Parameter | Contract |
|---|---|
Parametermaterial_types | Contracttext |
Parameterrequired | Contractnull |
Parameteroptional_controls | Contractnull |
Levenscyclus: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · de daadwerkelijk geretourneerde task_id of het record in de mediabibliotheek
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
De methodestructuren en ID’s zijn exact; de mogelijkheden van de leverancier staan los van toelating.
Tarieven
Ailoot-methodetarieven
POST /v1/audio/speech- Invoer
- US$ 0,001 / 1K
- Uitvoer
- US$ 0,02 / 1K
Ailoot reserveert vóór een verzoek een geschat bedrag. Na het resultaat worden de uiteindelijke kosten afgerekend op basis van het gemeten verbruik. Bij streaming gebeurt de afrekening op basis van de definitieve verbruiksregistratie. Zo werken reservering en afrekening →
Voorbeeldverzoeken
Ailoot · Spraakgeneratie
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
Resultaten ophalen en opslaan
Ailoot · Spraakgeneratie
native audiobytes of JSON-assetlinks
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
Alle voltooide resultaten bewaren
Bewaar elk volledig teruggegeven antwoord, bestand en inhoudsonderdeel.
Eén uitvoerbestand gebruikt standaard native audiobytes met de daadwerkelijke Content-Type; response_format=json of meerdere uitvoerbestanden retourneert alle links die u bezit. Er is geen conversie op verzoek naar MP3/Opus/AAC/FLAC/PCM en geen SSE.
Als het oorspronkelijke antwoord moet worden gecontroleerd
Bewaar de oorspronkelijke operation_id/X-Client-Request-ID voor reconciliatie zonder opnieuw in te dienen; er is geen aparte route om de audiostatus op te vragen.
Antwoordvelden
| Veld | Type |
|---|---|
Veldbinary native audio | Typebytes |
Veldmodel | Typestring |
Veldresponse_id | Typestring |
Veldactual_count | Typeinteger |
Velddata[] | Typeowned audio asset link |
Fouten en vervolgstappen
| Antwoord | Voorwaarde | Volgende stap |
|---|---|---|
Antwoord400 · invalid_request_error | VoorwaardeVerplichte velden, de materiaalrepresentatie of een parameterwaarde zijn ongeldig | Volgende stapCorrigeer de aangegeven velden vóór een nieuwe aanmaakaanvraag. |
Antwoordserver_error | VoorwaardeHet geretourneerde antwoord geeft aan dat de bewerking of het resultaat moet worden gecontroleerd | Volgende stapBewaar de oorspronkelijk geretourneerde bewerkings-/taak-ID, de aanvraagheaders en het antwoord; blijf de ondersteunde leesacties voor die oorspronkelijke bewerking uitvoeren. Dien de aanmaakaanvraag niet opnieuw in. |
Aliasnamen
Modelaliasnamen
Ailoot gemini-3.1-flash-tts-preview
Aliasnamen voor methodepaden
Gebruik de hierboven getoonde methodepaden.
Gerelateerde aanroeper-ID’s
FAQ · Gemini 3.1 Flash Tts Preview
- Welke invoer en resultaten zijn beschikbaar?
POST /v1/audio/speech·gemini-3.1-flash-tts-preview:text→speech- Welke velden gebruikt het verzoek?
POST /v1/audio/speech·gemini-3.1-flash-tts-preview:model,input,voice,response_format,stream_format