tts-1
TTS-1 zet voorbereide tekst om in gesproken audio met selecteerbare stemmen, afspeelsnelheid en uitvoerformaten. OpenAI optimaliseert deze versie voor spraakgeneratie met lagere latentie, als praktische keuze voor snelle voorleesreacties, korte vertelteksten en gestreamde levering van een al geschreven script.
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.
TTS-1 is het tekst-naar-spraakmodel van OpenAI dat is geoptimaliseerd voor snelheid. Het ontvangt de uit te spreken woorden en produceert audio, in plaats van een transcriptie of geschreven antwoord. Voorbeelden van de fabrikant omvatten het voorlezen van geschreven artikelen, het produceren van spraak in meerdere talen en het afspelen van audio zodra die binnenkomt. TTS-1 is de keuze met lagere latentie ten opzichte van TTS-1 HD; het HD-model legt de nadruk op uitvoerkwaliteit. De bruikbare afweging is daarom of snel afspelen of het profiel voor vertelopnamen van hogere kwaliteit belangrijker is voor de taak.
De workflow voor spraakgeneratie draait om het model, de invoertekst en de geselecteerde stem. De referentie van OpenAI beperkt de tekstinvoer tot 4.096 tekens: een tekenlimiet en geen contextvenster in tokens. Bereid het concrete script vóór de synthese voor: schrijf de zinnen die de luisteraar moet horen, werk afkortingen uit en bepaal hoe namen, hoeveelheden en koppen moeten worden uitgesproken. Verdeel een lang artikel in zelfstandig begrijpelijke passages in plaats van een lang document als één spraakverzoek te behandelen.
De huidige modelspecifieke stemmenlijst van OpenAI voor TTS-1 bestaat uit alloy, ash, coral, echo, fable, onyx, nova, sage en shimmer. Dit zijn vooraf ingestelde stemmen; ze vormen niet de volledige stemmenset van elk nieuwer spraakmodel. De stemmen zijn geoptimaliseerd voor Engels, terwijl meertalige spraak wordt ondersteund door de invoer in de uit te spreken taal aan te leveren. Kies een stem aan de hand van een representatieve passage met dezelfde woordenschat en hetzelfde tempo als het definitieve script. Houd die keuze consistent in verwante clips wanneer continuïteit belangrijk is.
Audio kan in delen worden gestreamd zodat het afspelen begint voordat het hele bestand is gegenereerd. Dit is streaming van spraak die uit tekst is gemaakt, geen tweerichtingsgesprek met spraak. De gedocumenteerde uitvoerformaten zijn MP3, Opus, AAC, FLAC, WAV en PCM, met MP3 als standaard. MP3 en AAC bieden gecomprimeerde audio; Opus is geschikt voor streaming en communicatie; FLAC is verliesvrij. WAV vermijdt het decoderen van gecomprimeerde audio en onbewerkte PCM bevat 24 kHz-samples van 16 bits met teken in little-endian-volgorde, zonder bestandsheader. OpenAI beveelt WAV of PCM aan wanneer reactietijd vooropstaat.
De spraakreferentie biedt een snelheidsinstelling van 0.25 tot 4.0, met 1.0 als standaard. Het aanvullende veld voor instructies in natuurlijke taal werkt niet met TTS-1 en SSE-uitvoer met gebeurtenissen wordt voor dit model niet ondersteund. De gedocumenteerde regelaars zijn script, stem, snelheid en audioformaat; regelaars voor accent, emotie of fluisteren van nieuwere modellen horen niet bij deze versie. Kies bij het voorbereiden van een clip een snelheid die de verstaanbaarheid dient en controleer daarna de uitgesproken woorden en pauzes, in plaats van aan te nemen dat het aantal tekens van het script een exacte duur vastlegt.
De taalgids omvat Engels, Russisch, Oekraïens, Frans, Duits, Spaans, Portugees, Italiaans, Arabisch, Chinees, Japans, Koreaans, Hindi, Kazachs en vele andere talen. De spraak volgt de taal van de aangeleverde tekst. Een briefing voor meertalige vertelteksten begint daarom met het vertaalde script en het beoogde publiek; tekst-naar-spraak is een weergavestap en geen opdracht om de tekst te vertalen of te herschrijven. Bereid voor een praktische aankondiging de exacte boodschap en namen voor. Maak bij educatieve vertelteksten de grenzen tussen onderdelen en definities duidelijk in de woorden die worden voorgelezen.
Een voltooid resultaat kan een korte gesproken instructie, een voorgelezen passage of een audiosegment voor een grotere montage zijn. Controleer uitspraak, volledigheid, tempo en het gekozen formaat aan de hand van de daadwerkelijke uitvoer. Bewaar het script bij de audio zodat latere correcties tot de betreffende passage kunnen worden beperkt. De richtlijnen van OpenAI vereisen dat luisteraars duidelijk wordt verteld dat de stem door AI is gegenereerd. Die melding hoort bij de luisterervaring; ze verandert TTS-1 niet in een opname van een menselijke stem en voegt geen stemkloonregelaars aan het model toe.
Ailoot Ultra · Spraakgeneratie POST /v1/audio/speech openai/tts-1
openai/tts-1Aan de slag
TTS-1 zet voorbereide tekst om in gesproken audio met selecteerbare stemmen, afspeelsnelheid en uitvoerformaten. OpenAI optimaliseert deze versie voor spraakgeneratie met lagere latentie, als praktische keuze voor snelle voorleesreacties, korte vertelteksten en gestreamde levering van een al geschreven script.
- Toegestane invoer
- Tekst
- Resultaten
- Audio
Beschikbaar in Ailoot · invoer en methoden
Ailoot Ultra · Spraakgeneratie POST /v1/audio/speech
- Invoertypen
text- Uitvoertypen
audio- Uitvoerformaat
- mp3
| Veld | Type | Vereiste | Waarden en limieten | Standaard |
|---|---|---|---|---|
Veldmodel | Typestring | VereisteVereist | Waarden en limieten openai/tts-1 | Standaard— |
Veldinput | Typestring | VereisteVereist | Waarden en limieten Minimumlengte: 1 Maximumlengte: 4.096 Eenheid: Unicode-tekens | Standaard— |
Veldvoice | Typestring | VereisteVereist | Waarden en limieten alloy | Standaard— |
Combinaties van invoermaterialen
text_to_speech · Vereist: input
Methodeparameters en levenscyclus
| Parameter | Contract |
|---|---|
Parametercontent_type | Contractapplication/json |
Parameterrequired | Contractmodel, input, voice |
Parametervoice_ids | Contractalloy |
Parametermax_input_characters | Contract4096 |
Parameterother_options | Contractfalse |
Parameterinput | Contractexacte UTF-8-tekst; aantal Unicode-tekens zonder normalisatie |
Parametermaterial_types | Contracttext |
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}
Selecteer de exacte stem uit dit modelprofiel.
Invoertekens en audioseconden zijn verschillende meeteenheden.
Tarieven
Tariefverwijzingen voegen geen verzoekopties toe. Ondersteunde parameters staan bij de geselecteerde methode.
- Snelle modus
- Niet opgegeven Wanneer de snelle modus is geselecteerd
- Flexmodus
- Niet opgegeven Wanneer de modus flex is geselecteerd
- Maximale redeneerinspanning
- Niet opgegeven Wanneer bij maximale redeneerinspanning de default-aanpassing wordt gebruikt
Ailoot-tarieven
Prijzen per configuratie
Koppel elke kostenpost aan de getoonde voorwaarden. Gebruik één tarief voor elke groep alternatieve configuraties.
| Configuratie | Tariefstaffel | Factureerbare hoeveelheid | Gefactureerde hoeveelheid | Rekeneenheid | Kosten |
|---|---|---|---|---|---|
| ConfiguratieBasistarieven voor tokens | TariefstaffelBasistarief | Factureerbare hoeveelheid— | Gefactureerde hoeveelheid— | Rekeneenheid— | Kosten Invoer · Invoertokens — / 1K tokens Uitvoer · Uitvoertokens — / 1K tokens Invoer · Cache lezen — / 1K tokens Invoer · Cache schrijven — / 1K tokens Invoer · Cache schrijven, 1 uur — / 1K tokens |
| ConfiguratieUltra | Tariefstaffel— | Factureerbare hoeveelheidElk Unicode-codepunt telt als één teken, inclusief Han-tekens. | Gefactureerde hoeveelheid— | Rekeneenheidper 1K invoertekens | Kosten Invoer · invoerteken $0.03 per 1K invoertekens |
| ConfiguratiePer verzoek | Tariefstaffel— | Factureerbare hoeveelheid— | Gefactureerde hoeveelheidéén verzoek | Rekeneenheid— | Kosten Invoer $0 per verzoek |
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 Ultra · Spraakgeneratie
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
Resultaten ophalen en opslaan
Ailoot Ultra · Spraakgeneratie
mp3
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
Lezen van andere inhoud
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 voltooide resultaten bewaren
Bewaar elk volledig teruggegeven antwoord, bestand en inhoudsonderdeel.
Bewaar het volledige binaire resultaat en de headers. Als JSON/meerdere uitvoerresultaten worden geretourneerd, bewaar dan elk data-item en haal elk bestand op via de daadwerkelijk geretourneerde ondertekende asset-URL.
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 audio | Typebytes |
Veldresponse headers | Typeheaders |
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 Ultra openai/tts-1
Aliasnamen voor methodepaden
Gebruik de hierboven getoonde methodepaden.
Gerelateerde aanroeper-ID’s
FAQ · tts-1
- Welke invoer en resultaten zijn beschikbaar?
POST /v1/audio/speech·openai/tts-1:text→audio- Welke velden gebruikt het verzoek?
POST /v1/audio/speech·openai/tts-1:model,input,voice- Welke limieten gelden?
POST /v1/audio/speech·openai/tts-1:input.maximum_length:4096