Gemini 3.1 Flash Tts Preview
Google-Sprachsynthesemodell zur Textvertonung mit steuerbarer Erzählweise und ausdrucksstarken Audio-Tags.
Über das Modell
Diese Beschreibung erläutert die Fähigkeiten des Modells. Die über Ailoot verfügbaren Eingaben, Ausgaben und Optionen sind unten für die ausgewählte Methode aufgeführt.
Gemini 3.1 Flash TTS Preview wandelt Text in Sprache um. Es dient natürlich klingender Vertonung mit einer durch Textanweisungen gesteuerten Erzählweise. Die Aussprachegestaltung kann zusammen mit Sprachanweisungen vorgegeben werden; ausdrucksstarke Audio-Tags helfen, die gewünschte Darbietung zu vermitteln.
Text wird zu Audio
Die Eingabe dieses Modells ist Text, die Ausgabe eine Audioaufnahme. Die maximale Eingabe umfasst 8 192 Tokens, die maximale Ausgabe 16 384 Tokens. Das Modell ist für Sprachsynthese aus vorbereitetem Text ausgelegt; es ist weder ein gewöhnliches Modell für Textantworten noch für die Transkription einer übermittelten Aufnahme.
Vorgesehen sind Vertonung mit einer Stimme und Dialoge mit mehreren Sprechern. Die Aussprache wird durch Anweisungen gesteuert: Leseweise und Ausdruck der Beiträge lassen sich beschreiben. Für wiederholte Sprachaufgaben nennt der Hersteller Batch-Generierung.
Ergebnisformat und Spezialisierung
Das ursprüngliche Format einer gewöhnlichen Antwort ist PCM ohne WAV-Header. Das ist eine wichtige Eigenschaft dieser konkreten Preview-Version: Die zurückgegebenen Bytes dürfen nicht automatisch als fertige WAV-Datei behandelt werden.
Die Modellkarte weist keine Unterstützung für Kontext-Caching, Codeausführung, Dateisuche, Funktionsaufrufe, Untermauerung durch Suchergebnisse, Google Maps, Bildgenerierung, strukturierte Textantworten, Thinking oder das Lesen von Webadressinhalten aus. Sprachsynthese ist die spezialisierte Ausgabeaufgabe; die Fähigkeiten von Textmodellen gelten nicht automatisch auch für dieses Modell.
Preview-Version
gemini-3.1-flash-tts-preview gehört zu den früheren Sprach-Preview-Versionen. Seine Verfahren zur Stimmensteuerung und sein Audioformat müssen getrennt von späteren TTS-Modellen betrachtet werden. Die Erstellung eines neuen Stimmprofils und die Nachbildung einer Stimme anhand einer Probe sind für diese Version nicht angegeben; die genaue Anzahl unterstützter Sprachen wird in der Karte nicht genannt.
Die beschriebenen Fähigkeiten betreffen das Modell selbst. Wie Text und Sprechereinstellungen übermittelt und Audiodateien empfangen werden, hängt von der unterstützten Sprachmethode ab.
Ailoot · Sprachausgabe POST /v1/audio/speech gemini-3.1-flash-tts-preview
gemini-3.1-flash-tts-previewStart
Google-Sprachsynthesemodell zur Textvertonung mit steuerbarer Erzählweise und ausdrucksstarken Audio-Tags.
- Zulässige Eingaben
- Text
- Ergebnisse
- speech
In Ailoot verfügbar · Eingaben und Methoden
Ailoot · Sprachausgabe POST /v1/audio/speech
- Eingabetypen
text- Ausgabetypen
speech- Ausgabeformat
- Native Audiobytes oder JSON-Asset-Links
| Feld | Typ | Anforderung | Werte und Limits | Standard |
|---|---|---|---|---|
Feldmodel | Typstring | AnforderungErforderlich | Werte und Limits gemini-3.1-flash-tts-preview | Standard— |
Feldinput | Typstring | AnforderungErforderlich | Werte und Limits Mindestlänge: 1 | Standard— |
Feldvoice | Typstring | AnforderungOptional | Werte und Limits Kore | StandardKore |
Feldresponse_format | Typstring | AnforderungOptional | Werte und Limits , wav, json | Standard |
Feldstream_format | Typstring | AnforderungOptional | Werte und Limits audio | Standard— |
Kombinationen von Eingabematerialien
text_to_speech · Erforderlich: input
Methodenparameter und Lebenszyklus
| Parameter | Vertrag |
|---|---|
Parametermaterial_types | Vertragtext |
Parameterrequired | Vertragnull |
Parameteroptional_controls | Vertragnull |
Lebenszyklus: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · die tatsächlich zurückgegebene task_id oder ein Eintrag in der Medienbibliothek
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Methodenstrukturen und IDs sind exakt; die Fähigkeiten des Anbieters sind von der Zulassung einer Anfrage zu unterscheiden.
Tarife
Ailoot-Methodentarife
POST /v1/audio/speech- Eingabe
- 0,001 $ / 1K
- Ausgabe
- 0,02 $ / 1K
Ailoot reserviert vor einer Anfrage einen geschätzten Betrag. Nach dem Ergebnis rechnet Ailoot die endgültige Gebühr anhand des gemessenen Verbrauchs ab. Bei Streaming erfolgt die Abrechnung anhand des abschließenden Verbrauchsdatensatzes. So funktionieren Reservierung und Abrechnung →
Beispielanfragen
Ailoot · Sprachausgabe
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
Ergebnisse abrufen und speichern
Ailoot · Sprachausgabe
Native Audiobytes oder JSON-Asset-Links
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
Alle fertiggestellten Ergebnisse aufbewahren
Bewahren Sie jede vollständig zurückgegebene Antwort, Datei und jeden Inhaltsteil auf.
Bei einer einzelnen Ausgabe werden standardmäßig native Audiobytes mit dem tatsächlichen Content-Type zurückgegeben; response_format=json oder mehrere Ausgaben liefern alle Links der Ihnen zugeordneten Assets. Keine angeforderte Konvertierung in MP3/Opus/AAC/FLAC/PCM und kein SSE.
Wenn die ursprüngliche Antwort geprüft werden muss
Die ursprüngliche operation_id/X-Client-Request-ID für den Abgleich ohne erneute Einreichung aufbewahren; es gibt keine eigene Route zur Abfrage des Audiostatus.
Antwortfelder
| Feld | Typ |
|---|---|
Feldbinary native audio | Typbytes |
Feldmodel | Typstring |
Feldresponse_id | Typstring |
Feldactual_count | Typinteger |
Felddata[] | Typowned audio asset link |
Fehler und nächste Schritte
| Antwort | Bedingung | Nächster Schritt |
|---|---|---|
Antwort400 · invalid_request_error | BedingungPflichtfelder, Darstellung des Eingabematerials oder Parameterwert ungültig | Nächster SchrittDie angegebenen Felder vor einer neuen Erstellungsanfrage korrigieren. |
Antwortserver_error | BedingungDie zurückgegebene Antwort gibt an, dass der Vorgang oder das Ergebnis eine Prüfung erfordert | Nächster SchrittDie ursprünglich zurückgegebene Vorgangs-/Aufgaben-ID, die Anfrageheader und die Antwort aufbewahren; mit unterstützten Leseaufrufen für diesen ursprünglichen Vorgang fortfahren. Die Erstellungsanfrage nicht erneut senden. |
Aliasnamen
Modellaliasnamen
Ailoot gemini-3.1-flash-tts-preview
Aliasnamen für Methodenpfade
Verwenden Sie die oben angezeigten Methodenpfade.
Zugehörige Aufrufer-IDs
FAQ · Gemini 3.1 Flash Tts Preview
- Welche Eingaben und Ergebnisse sind verfügbar?
POST /v1/audio/speech·gemini-3.1-flash-tts-preview:text→speech- Welche Felder verwendet die Anfrage?
POST /v1/audio/speech·gemini-3.1-flash-tts-preview:model,input,voice,response_format,stream_format