tts-1
TTS-1 wandelt vorbereiteten Text mit auswählbaren Stimmen, Wiedergabegeschwindigkeit und Ausgabeformaten in gesprochenes Audio um. OpenAI optimiert diese Modellversion für latenzärmere Spracherzeugung; sie eignet sich für schnelle Vorleseantworten, kurze Erzähltexte und die gestreamte Ausgabe eines bereits geschriebenen Skripts.
Ü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.
TTS-1 ist das auf Geschwindigkeit optimierte Text-to-Speech-Modell von OpenAI. Es empfängt die zu sprechenden Wörter und erzeugt Audio, statt einer Transkription oder einer schriftlichen Antwort. Zu den Herstellerbeispielen gehören das Vorlesen geschriebener Artikel, die Erzeugung von Sprachausgabe in mehreren Sprachen und die Wiedergabe von Audio während seines Eintreffens. TTS-1 ist gegenüber TTS-1 HD die latenzärmere Wahl; das HD-Modell betont die Ausgabequalität. Die praktische Entscheidung lautet daher, ob schnelle Wiedergabe oder das Profil für hochwertigere Erzählaufnahmen für die Aufgabe wichtiger ist.
Der Workflow zur Spracherzeugung basiert auf Modell, Eingabetext und ausgewählter Stimme. Die OpenAI-Referenz begrenzt die Texteingabe auf 4.096 Zeichen; das ist eine Zeichengrenze, kein Token-Kontextfenster. Bereiten Sie das tatsächliche Skript vor der Synthese vor: Schreiben Sie die Sätze, die der Hörer hören soll, klären Sie Abkürzungen und legen Sie fest, wie Namen, Mengenangaben und Überschriften gesprochen werden sollen. Gliedern Sie einen langen Artikel in eigenständig verständliche Passagen, statt ein langes Dokument als eine einzige Sprachanfrage zu behandeln.
Die aktuelle modellspezifische Stimmenliste von OpenAI für TTS-1 lautet alloy, ash, coral, echo, fable, onyx, nova, sage und shimmer. Dies sind voreingestellte Stimmen; sie sind nicht der vollständige Stimmensatz jedes neueren Sprachmodells. Die Stimmen sind für Englisch optimiert; mehrsprachige Ausgabe wird durch Bereitstellung der Eingabe in der zu sprechenden Sprache unterstützt. Wählen Sie eine Stimme anhand einer repräsentativen Passage mit demselben Wortschatz und Tempo wie im fertigen Skript. Behalten Sie diese Wahl über zusammengehörige Clips hinweg bei, wenn Kontinuität wichtig ist.
Audio kann in Abschnitten gestreamt werden, sodass die Wiedergabe beginnt, bevor die gesamte Datei fertig erzeugt wurde. Dies ist Streaming von aus Text erzeugter Sprachausgabe, kein wechselseitiges gesprochenes Gespräch. Die dokumentierten Ausgabeformate sind MP3, Opus, AAC, FLAC, WAV und PCM; MP3 ist die Standardeinstellung. MP3 und AAC bieten komprimiertes Audio, Opus eignet sich für Streaming und Kommunikation, FLAC ist verlustfrei. WAV vermeidet die Dekodierung komprimierten Audios; rohes PCM enthält vorzeichenbehaftete 16-Bit-Samples mit 24 kHz in Little-Endian-Reihenfolge ohne Dateiheader. OpenAI empfiehlt WAV oder PCM, wenn die Antwortzeit Vorrang hat.
Die Referenzdokumentation zur Sprachausgabe bietet eine Geschwindigkeitseinstellung von 0.25 bis 4.0 mit 1.0 als Standard. Das zusätzliche Feld für natürlichsprachliche Anweisungen funktioniert mit TTS-1 nicht, und ereignisbasierte SSE-Ausgabe wird für dieses Modell nicht unterstützt. Seine dokumentierten Steuerungsmöglichkeiten sind Skript, Stimme, Geschwindigkeit und Audioformat; Steuerelemente neuerer Modelle für Akzent, Emotion oder Flüstern sollten dieser Modellversion nicht zugeordnet werden. Wählen Sie bei der Vorbereitung eines Clips eine Geschwindigkeit, die der Verständlichkeit dient, und prüfen Sie anschließend die wiedergegebenen Wörter und Pausen, statt anzunehmen, dass die Zeichenzahl des Skripts eine genaue Dauer festlegt.
Der Sprachleitfaden umfasst Englisch, Russisch, Ukrainisch, Französisch, Deutsch, Spanisch, Portugiesisch, Italienisch, Arabisch, Chinesisch, Japanisch, Koreanisch, Hindi, Kasachisch und viele weitere Sprachen. Die Sprachausgabe folgt der Sprache des bereitgestellten Textes. Ein mehrsprachiges Erzählbriefing beginnt deshalb mit dem übersetzten Skript und dem vorgesehenen Publikum; Text-to-Speech ist ein Wiedergabeschritt, keine Anweisung zum Übersetzen oder Umschreiben. Bereiten Sie für eine praktische Ansage die genaue Aussage und Namen vor. Machen Sie bei Lerntexten Abschnittsgrenzen und Definitionen in den vorzulesenden Wörtern deutlich.
Ein fertiges Ergebnis kann eine kurze gesprochene Anweisung, eine erzählte Passage oder ein Audiosegment für einen größeren Schnitt sein. Prüfen Sie Aussprache, Vollständigkeit, Tempo und das gewählte Format anhand der tatsächlichen Ausgabe. Bewahren Sie das Skript zusammen mit dem Audio auf, damit spätere Korrekturen auf die betroffene Passage begrenzt werden können. Die OpenAI-Richtlinien verlangen, Hörern klar mitzuteilen, dass die Stimme KI-generiert ist. Dieser Hinweis gehört zum Hörerlebnis; er verwandelt TTS-1 weder in eine Aufnahme einer menschlichen Stimme noch ergänzt er das Modell um Steuerelemente zum Stimmenklonen.
Ailoot Ultra · Sprachausgabe POST /v1/audio/speech openai/tts-1
openai/tts-1Einstieg
TTS-1 wandelt vorbereiteten Text mit auswählbaren Stimmen, Wiedergabegeschwindigkeit und Ausgabeformaten in gesprochenes Audio um. OpenAI optimiert diese Modellversion für latenzärmere Spracherzeugung; sie eignet sich für schnelle Vorleseantworten, kurze Erzähltexte und die gestreamte Ausgabe eines bereits geschriebenen Skripts.
- 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 openai/tts-1 | Standard— |
Feldinput | Typstring | AnforderungErforderlich | Werte und Limits Mindestlänge: 1 Maximale Länge: 4 096 Einheit: Unicode-Zeichen | Standard— |
Feldvoice | Typstring | AnforderungErforderlich | Werte und Limits alloy | Standard— |
Kombinationen von Eingabematerialien
text_to_speech · Erforderlich: input
Methodenparameter und Lebenszyklus
| Parameter | Vertrag |
|---|---|
Parametercontent_type | Vertragapplication/json |
Parameterrequired | Vertragmodel, input, voice |
Parametervoice_ids | Vertragalloy |
Parametermax_input_characters | Vertrag4096 |
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 | Abrechnungsmenge | Abrechnungseinheit | Gebühr |
|---|---|---|---|---|---|
| KonfigurationBasistarife für Tokens | TarifstaffelGrundtarif | Abrechenbare Menge— | Abrechnungsmenge— | 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. | Abrechnungsmenge— | Abrechnungseinheitpro 1K Eingabezeichen | Gebühr Eingabe · Eingabezeichen $0.03 pro 1K Eingabezeichen |
| KonfigurationJe Anfrage | Tarifstaffel— | Abrechenbare Menge— | Abrechnungsmengeeine Anfrage | Abrechnungseinheit— | Gebühr Eingabe $0 pro Anfrage |
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}"
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "openai/tts-1", "input": "Good afternoon! This is a short voice take.", "voice": "alloy"}')
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 openai/tts-1
Aliasnamen für Methodenpfade
Verwenden Sie die oben angezeigten Methodenpfade.
Zugehörige Aufrufer-IDs
FAQ · tts-1
- Welche Eingaben und Ergebnisse sind verfügbar?
POST /v1/audio/speech·openai/tts-1:text→audio- Welche Felder verwendet die Anfrage?
POST /v1/audio/speech·openai/tts-1:model,input,voice- Welche Grenzen gelten?
POST /v1/audio/speech·openai/tts-1:input.maximum_length:4096