tts-1-hd
TTS-1 HD zet geschreven tekst om in gesproken audio van hogere kwaliteit, met selecteerbare vooraf ingestelde stemmen, snelheid en zes uitvoerformaten. OpenAI positioneert HD voor de kwaliteit van vertelopnamen, in plaats van het profiel met lagere latentie van TTS-1, waardoor het nuttig is voor afgewerkte voorleesopnamen, leermateriaal en gemonteerde audiopassages.
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 HD is het tekst-naar-spraakmodel van OpenAI dat is geoptimaliseerd voor audiokwaliteit. Een voorbereid script is de invoer en gesproken audio is de uitvoer. De keuze voor HD staat los van het snelheidsgerichte profiel van TTS-1: OpenAI beschrijft TTS-1 als een model met lagere latentie maar lagere kwaliteit. HD is daarom een bruikbare keuze voor vertelteksten wanneer de uiteindelijke stemtrack belangrijker is dan zo snel mogelijk beginnen met afspelen. Een geschreven artikel, lespassage of verzorgde uitleg kan zo een gesproken bestand worden.
De kerninvoer bestaat uit het geselecteerde model, de exacte tekst en een stem. De spraakreferentie van de fabrikant beperkt het script tot 4.096 tekens per verzoek. Dat beschrijft de lengte van de geschreven invoer en is geen garantie voor de audioduur. Bereid een script voor dat bij het luisteren begrijpelijk is: schrijf dubbelzinnige afkortingen voluit, bepaal hoe hoeveelheden worden uitgesproken en houd elke passage samenhangend. Verdeel de tekst voor een langere les of een artikel op betekenisvolle grenzen en behoud de volgorde waarin de resulterende passages worden gebruikt.
De huidige OpenAI-gids vermeldt negen ingebouwde keuzes voor TTS-1 HD: alloy, ash, coral, echo, fable, onyx, nova, sage en shimmer. De stemmen zijn geoptimaliseerd voor Engels, terwijl de tekst-naar-spraakgids het genereren van spraak in meerdere talen ondersteunt door tekst in de vereiste taal aan te leveren. Een stemvergelijking is het nuttigst met hetzelfde representatieve script, inclusief de namen en vaktermen die in het definitieve materiaal voorkomen. Houd stem en snelheid consistent wanneer meerdere clips één vertelopname vormen.
MP3 is de standaarduitvoer. Opus en AAC bieden alternatieve gecomprimeerde audioformaten; FLAC biedt verliesvrije compressie; WAV biedt ongecomprimeerde audio. PCM levert onbewerkte 24 kHz-samples van 16 bits met teken in little-endian-volgorde, zonder bestandsheader. Deze keuzes dienen verschillende toepassingen: een compact bestand voor verspreiding, een streamingbestand of audio voor een montageworkflow. OpenAI beveelt WAV of PCM aan voor snellere reactietijden wanneer de extra verwerking voor decoderen van belang is. De keuze van een bestandsformaat verandert het script niet en voegt geen afzonderlijk stemregelingsmodel toe.
Spraak kan in delen worden geleverd, zodat een speler kan beginnen voordat het volledige audiobestand klaar is. Dit is tekst-naar-audiostreaming; het vormt geen bidirectioneel stemgesprek. De referentie ondersteunt een snelheidswaarde van 0.25 tot 4.0, met 1.0 als standaard. Het afzonderlijke veld voor instructies in natuurlijke taal werkt niet met TTS-1 HD en SSE-gebeurtenisuitvoer wordt voor dit model niet ondersteund. Script, vooraf ingestelde stem, snelheid en uitvoerformaat zijn de gedocumenteerde regelaars, in plaats van de interface voor accentprompts of emotieaanwijzingen van nieuwere spraakmodellen.
De taalgids noemt onder meer Russisch, Oekraïens, Engels, Frans, Duits, Spaans, Portugees, Italiaans, Chinees, Japans, Koreaans, Arabisch, Hindi en Kazachs als ondersteunde talen. Bereid het script in de doeltaal voor; synthese spreekt die tekst uit en vertaalt deze niet. Maak voor leermateriaal definities en overgangen tussen onderdelen duidelijk. Bereid voor een uitleggende audiopassage de exacte boodschap en alle namen voor die gehoord moeten worden. De optimalisatie van de stem voor Engels blijft relevant bij het beoordelen van de klank van een bepaalde taal en woordenschat.
Een praktische HD-workflow produceert een audiopassage om te beluisteren, te controleren en daarna in het definitieve materiaal op te nemen. Controleer of elke zin is uitgesproken, of namen en hoeveelheden aanvaardbaar zijn uitgesproken en of het gekozen tempo het begrip ondersteunt. Bewaar het geschreven script bij de audio zodat een correctie naar de betreffende passage kan worden herleid. OpenAI vereist een duidelijke melding dat de gegenereerde stem kunstmatig is. HD beschrijft de kwaliteitsgerichte TTS-familie; het belooft op zichzelf geen exacte timing, aangepaste sprekeridentiteit of expressieve regelaars van een ander model.
Ailoot Ultra · Spraakgeneratie POST /v1/audio/speech openai/tts-1-hd
openai/tts-1-hdAan de slag
TTS-1 HD zet geschreven tekst om in gesproken audio van hogere kwaliteit, met selecteerbare vooraf ingestelde stemmen, snelheid en zes uitvoerformaten. OpenAI positioneert HD voor de kwaliteit van vertelopnamen, in plaats van het profiel met lagere latentie van TTS-1, waardoor het nuttig is voor afgewerkte voorleesopnamen, leermateriaal en gemonteerde audiopassages.
- 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-hd | 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.06 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-hd", "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-hd
Aliasnamen voor methodepaden
Gebruik de hierboven getoonde methodepaden.
Gerelateerde aanroeper-ID’s
FAQ · tts-1-hd
- Welke invoer en resultaten zijn beschikbaar?
POST /v1/audio/speech·openai/tts-1-hd:text→audio- Welke velden gebruikt het verzoek?
POST /v1/audio/speech·openai/tts-1-hd:model,input,voice- Welke limieten gelden?
POST /v1/audio/speech·openai/tts-1-hd:input.maximum_length:4096