SpaceXAI: Grok Voice TTS 1.0
Grok Text to Speech wandelt geschriebenen Text mit auswählbaren Stimmen, Sprechhinweisen im Text und mehreren Ausgabecodecs in ausdrucksstarkes Audio um. Die dokumentierte Herstellerfamilie unterstützt vollständige und gestreamte Sprachausgabe sowie optionale Zeitangaben auf Zeichenebene.
Ü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.
Grok Text to Speech ist die Text-zu-Audio-Funktion der Grok-Stimmenfamilie. Der Hersteller dokumentiert ausdrucksstarke integrierte Sprecher, Stimmhinweise im Text und Ausgabeformate für Medienwiedergabe oder Telefonaudio. Die Eingabe ist das zu sprechende Transkript zusammen mit der Stimmen- und Sprachwahl. Die entstehende Aufnahme enthält Sprache aus diesem Transkript; Spracherkennung und dialogorientierte Speech-to-Speech-Modelle haben separate Aufgaben.
Stimme, Sprache und gesprochener Text
Der Herstellerkatalog gibt jeder Stimme ein Sprechprofil. Ara ist warm und freundlich, Eve lebhaft mit britischem Akzent, und Rex wird als klar und selbstbewusst beschrieben. Stimme und Sprache sind in der dokumentierten Familie unabhängig: Integrierte Sprecher können jede unterstützte Sprachoption verwenden. Der Leitfaden nennt zwanzig Sprachcodeoptionen einschließlich regionaler Varianten und unterstützt außerdem die automatische Erkennung der Sprache. Neben integrierten Sprechern dokumentiert der Hersteller wiederverwendbare benutzerdefinierte Stimmen, die aus einer Referenzaufnahme erstellt und für vollständige oder gestreamte Synthese über voice_id ausgewählt werden. Referenzaudio darf bis zu 120 Sekunden lang sein; empfohlen werden 90–120 Sekunden saubere Sprache eines einzelnen Sprechers, um Sprechweise und Intonation zu erfassen. Halten Sie Referenz, erstelltes Stimmenprofil und erzeugte Aufnahme als separate Artefakte und stimmen Sie die Darbietung der Referenz auf das vorgesehene Skript ab.
Bereiten Sie den endgültigen gesprochenen Wortlaut vor und bewahren Sie die vorgesehene Sprache von Namen und zitierten Passagen. Für eine gesprochene Anleitung ist eine nützliche Zeile: „Wählen Sie ein Thema, hören Sie sich die kurze Einführung an und öffnen Sie den Abschnitt, den Sie erkunden möchten.“ Benötigt ein Markenname oder Fachbegriff eine bestimmte Lesung, können die Ersetzungsfunktionen des Herstellers eine angepasste Schreibweise oder IPA-Aussprache bereitstellen, ohne den angezeigten Quelltext zu ändern. Eine separate Textnormalisierungsoption überführt geschriebene Zahlen, Abkürzungen und Symbole in ihre gesprochene Form.
Hinweise zur Sprechweise
Tags im Text platzieren ein Ereignis an einer bestimmten Stelle, etwa eine Pause, ein Lachen, einen Seufzer oder einen Atemzug. Umschließende Tags wenden eine Sprechweise auf eine vollständige Formulierung an, beispielsweise Flüstern, Betonung oder eine langsamere Passage. Setzen Sie den Hinweis dort, wo die Bedeutung ihn erfordert, und halten Sie die Wörter lesbar. Der Leitfaden empfiehlt Stilbereiche für vollständige Formulierungen und Satzzeichen statt einer Ansammlung unzusammenhängender Tags.
Bereiten Sie für eine ausdrucksstarke Figurenzeile den gesprochenen Satz und den Wechsel der Darbietung gemeinsam vor. Bewahren Sie bei einer Erklärung einen klaren Rhythmus, der dem Hörer hilft, den Schritten zu folgen. Der dokumentierte Sprechgeschwindigkeitsbereich reicht von 0.7 bis 1.5; 1.0 steht für normales Sprechen. Eine Geschwindigkeitswahl ändert das Sprechtempo, nicht die Wörter, die die Anwendung vermitteln soll.
Audio und Zeitangaben
Der Hersteller dokumentiert Ausgaben in MP3, WAV, rohem PCM, mu-law und A-law. Die unterstützten Abtastraten reichen von 8 kHz bis 48 kHz, mit konkret aufgeführten Raten dazwischen. Seine MP3-Standardkonfiguration ist 24 kHz bei 128 kbit/s. Verwenden Sie eine Audiodarstellung, die das vorgesehene Wiedergabegerät, der Bearbeitungsschritt oder der Telefoniepfad verarbeiten kann.
Optionale Zeichenzeitangaben verknüpfen die zurückgegebene Zeichenfolge mit Start- und Endzeiten. Ohne Ausspracheersetzungen entspricht diese Folge der Eingabe; Ersetzungen können sie in den gesprochenen Text ändern. Die Zeitangaben können eine Mitleseanzeige, Hervorhebungen oder die Ausrichtung auf eine visuelle Darbietung unterstützen. Im Workflow mit vollständiger Antwort ändert die Anforderung von Zeitangaben die Ausgabe in ein umschließendes Objekt mit kodiertem Audio und Zeitdaten. Behandeln Sie Zeitangaben und Audio als zusammengehöriges Ergebnis, insbesondere wenn Textnormalisierung ein geschriebenes Symbol in mehrere gesprochene Wörter erweitert.
Vollständige oder gestreamte Generierung
Der Hersteller bietet einen Weg für vollständige Anfragen und bidirektionales Streaming, bei dem Textfragmente eintreffen und Audioabschnitte während der Generierung der Äußerung zurückgegeben werden. Er dokumentiert eine Grenze von 60.000 Zeichen für eine vollständige Anfrage und für ein einzelnes gestreamtes Textfragment. Das Abschließen oder Verwerfen einer Äußerung hat im Streaming-Workflow eine ausdrückliche Funktion.
Wählen Sie für längere Erzähltexte zusammenhängende Passagengrenzen und bewahren Sie das Skript bei jedem Ergebnis auf. Unterscheiden Sie bei interaktiver Wiedergabe zwischen zur Synthese gesendetem Text und Audio, das der Hörer bereits gehört hat. Das nützliche Ergebnis ist ein gesprochenes Skript mit gezielten Sprechhinweisen, einem geeigneten Audioformat und Zeitdaten, wenn die Anwendung sie benötigt. Bewahren Sie Skript, ausgewählte Stimme, Sprechhinweise und Ausgabeeinstellungen beim Audio auf, damit spätere Überarbeitungen die vorgesehene Sprechweise erhalten.
Ailoot Ultra · Sprachausgabe POST /v1/audio/speech x-ai/grok-voice-tts-1.0
x-ai/grok-voice-tts-1.0Einstieg
Grok Text to Speech wandelt geschriebenen Text mit auswählbaren Stimmen, Sprechhinweisen im Text und mehreren Ausgabecodecs in ausdrucksstarkes Audio um. Die dokumentierte Herstellerfamilie unterstützt vollständige und gestreamte Sprachausgabe sowie optionale Zeitangaben auf Zeichenebene.
- Zulässige Eingaben
- Text
- Ergebnisse
- Audio
In Ailoot verfügbar · Eingaben und Methoden
Ailoot Ultra · Sprachausgabe POST /v1/audio/speech
- Eingabe
text- Ausgabe
audio- Ausgabeformat
- mp3
| Feld | Typ | Anforderung | Werte und Limits | Standard |
|---|---|---|---|---|
Feldmodel | Typstring | AnforderungErforderlich | Werte und Limits x-ai/grok-voice-tts-1.0 | Standard— |
Feldinput | Typstring | AnforderungErforderlich | Werte und Limits Mindestlänge: 1 Maximale Länge: 15 000 Einheit: Unicode-Zeichen | Standard— |
Feldvoice | Typstring | AnforderungErforderlich | Werte und Limits eve, ara, rex, sal, leo | Standard— |
Feldresponse_format | Typstring | AnforderungErforderlich | Werte und Limits mp3 | Standard— |
Kombinationen von Eingabematerialien
text_to_speech · Erforderlich: input
Methodenparameter und Lebenszyklus
| Parameter | Vertrag |
|---|---|
Parametercontent_type | Vertragapplication/json |
Parameterrequired | Vertragmodel, input, voice, response_format |
Parametervoice_ids | Vertrageve, ara, rex, sal, leo |
Parameterresponse_format | Vertragmp3 |
Parametermax_input_characters | Vertrag15000 |
Parameterother_options | Vertragfalse |
Parameterinput | Vertragexakter UTF-8-Text; Unicode-Zeichenzahl ohne Normalisierung |
Parametermaterial_types | Vertragtext |
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}
Wählen Sie die genaue Stimme aus diesem Modellprofil.
Eingabezeichen und Audiosekunden sind unterschiedliche Messgrößen.
Tarife
Tarifangaben erweitern die Anfrageoptionen nicht. Unterstützte Parameter stehen bei der ausgewählten Methode.
- Schnellmodus
- Nicht angegeben Wenn der Schnellmodus ausgewählt ist
- Flex-Modus
- Nicht angegeben Wenn der Modus flex ausgewählt ist
- Maximaler Denkaufwand
- Nicht angegeben Wenn beim maximalen Denkaufwand die Standardanpassung (default) verwendet wird
Ailoot-Tarife
Preise nach Konfiguration
Ordnen Sie jede Gebühr den angezeigten Bedingungen zu. Verwenden Sie für jede Gruppe alternativer Konfigurationen einen Tarif.
| Konfiguration | Tarifstaffel | Abrechenbare Menge | Abrechnungseinheit | Gebühr |
|---|---|---|---|---|
| KonfigurationBasistarife für Tokens | TarifstaffelGrundtarif | Abrechenbare Menge— | Abrechnungseinheit— | Gebühr Eingabe · Eingabetoken — / 1K Tokens Ausgabe · Ausgabetoken — / 1K Tokens Eingabe · Cache lesen — / 1K Tokens Eingabe · In Cache schreiben — / 1K Tokens Eingabe · In Cache schreiben, 1 Stunde — / 1K Tokens |
| KonfigurationUltra | Tarifstaffel— | Abrechenbare MengeJeder Unicode-Codepunkt zählt als ein Zeichen, einschließlich Han-Zeichen. | Abrechnungseinheitpro 1K Eingabezeichen | Gebühr Eingabe · Eingabezeichen $0.03 pro 1K Eingabezeichen |
Details zum Referenztarif
Referenztarifstaffeln auf Modellebene ändern weder Methodenauswahl noch Kostenvoranschläge oder Gebühren. Für die aktive Abrechnung gelten die Tarife der ausgewählten Ailoot-Methode.
SpaceXAI: Grok Voice TTS 1.0
Preise nach Konfiguration
| Konfiguration | Abrechnungsbedingungen | Gebühr |
|---|---|---|
| KonfigurationSpaceXAI: Grok Voice TTS 1.0 · Standardkonfiguration | AbrechnungsbedingungenStandardkonfiguration | Gebühr Eingabe · Eingabezeichen $ 0,00003 pro Eingabezeichen |
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 Ultra · Sprachausgabe
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_VOICE_ID:?Choose an accepted voice ID from this exact model profile}"
export AILOOT_VOICE_ID
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "x-ai/grok-voice-tts-1.0", "input": "Good afternoon! This is a short voice take."}')
voice=os.environ["AILOOT_VOICE_ID"]
allowed=json.loads('["eve", "ara", "rex", "sal", "leo"]')
if voice not in allowed: raise SystemExit("Choose an accepted voice ID from this exact model profile")
p["voice"]=voice
p["response_format"]="mp3"
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.mp3
Ergebnisse abrufen und speichern
Ailoot Ultra · Sprachausgabe
mp3
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
Abrufe anderer Inhalte
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/media/assets \
-H "Authorization: Bearer $AILOOT_API_KEY" -o media-assets.json
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_MEDIA_TASK_ID:?Set the actual ID returned by the response or media-library metadata}"
export AILOOT_MEDIA_TASK_ID
resource_id=$(python3 -c 'import os,urllib.parse;print(urllib.parse.quote(os.environ["AILOOT_MEDIA_TASK_ID"],safe=""))')
curl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/media/tasks/$resource_id" \
-H "Authorization: Bearer $AILOOT_API_KEY" -o media-task.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
print(json.dumps(json.loads(Path("media-task.json").read_text())))
PY_RESULT
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_ASSET_ID:?Set the actual ID returned by the response or media-library metadata}"
export AILOOT_ASSET_ID
resource_id=$(python3 -c 'import os,urllib.parse;print(urllib.parse.quote(os.environ["AILOOT_ASSET_ID"],safe=""))')
curl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/media/assets/$resource_id" \
-H "Authorization: Bearer $AILOOT_API_KEY" -o media-asset.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
print(json.dumps(json.loads(Path("media-asset.json").read_text())))
PY_RESULT
Alle fertiggestellten Ergebnisse aufbewahren
Bewahren Sie jede vollständig zurückgegebene Antwort, Datei und jeden Inhaltsteil auf.
Das vollständige Binärergebnis und die Header aufbewahren. Wenn JSON oder mehrere Ausgaben zurückgegeben werden, jedes Datenelement aufbewahren und jede tatsächlich zurückgegebene signierte Asset-URL abrufen.
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 audio | Typbytes |
Feldresponse headers | Typheaders |
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 Ultra x-ai/grok-voice-tts-1.0
Aliasnamen für Methodenpfade
Verwenden Sie die oben angezeigten Methodenpfade.
Zugehörige Aufrufer-IDs
FAQ · SpaceXAI: Grok Voice TTS 1.0
- Welche Eingaben und Ergebnisse sind verfügbar?
POST /v1/audio/speech·x-ai/grok-voice-tts-1.0:text→audio- Welche Felder verwendet die Anfrage?
POST /v1/audio/speech·x-ai/grok-voice-tts-1.0:model,input,voice,response_format- Welche Grenzen gelten?
POST /v1/audio/speech·x-ai/grok-voice-tts-1.0:input.maximum_length:15000