Skip to navigation

Spraak streamen

Zet tekst om in spraak met een stem naar keuze en retourneert audio als audiostream.

Path parameters

voice_idstringRequired

ID van de te gebruiken stem. Gebruik het endpoint Stemmen ophalen om alle beschikbare stemmen weer te geven.

Headers

xi-api-keystringOptional

Query parameters

enable_loggingbooleanOptionalDefaults to true

Wanneer enable_logging is ingesteld op false, wordt voor het request de modus zonder gegevensbewaring gebruikt. Hierdoor zijn geschiedenisfuncties, waaronder request stitching, niet beschikbaar voor dit request. De modus zonder gegevensbewaring is alleen beschikbaar voor Enterprise-klanten.

optimize_streaming_latencyinteger or nullOptionalDeprecated

Je kunt latentieoptimalisaties inschakelen, met enig kwaliteitsverlies als gevolg. De best mogelijke uiteindelijke latentie verschilt per model. Mogelijke waarden: 0 - standaardmodus (geen latentieoptimalisaties) 1 - normale latentieoptimalisaties (ongeveer 50% van de mogelijke latentieverbetering van optie 3) 2 - sterke latentieoptimalisaties (ongeveer 75% van de mogelijke latentieverbetering van optie 3) 3 - maximale latentieoptimalisaties 4 - maximale latentieoptimalisaties, maar ook met de tekstnormalisator uitgeschakeld voor nog meer latentieverbetering (beste latentie, maar kan bijvoorbeeld getallen en datums verkeerd uitspreken).

Standaard ingesteld op None.

output_formatenumOptionalDefaults to mp3_44100_128

Output format of the generated audio. Formatted as codec_sample_rate_bitrate. So an mp3 with 22.05kHz sample rate at 32kbs is represented as mp3_22050_32. MP3 with 192kbps bitrate requires you to be subscribed to Creator tier or above. PCM with 44.1kHz sample rate requires you to be subscribed to Pro tier or above. Note that the μ-law format (sometimes written mu-law, often approximated as u-law) is commonly used for Twilio audio inputs.

Request

This endpoint expects an object.
textstringRequired
De tekst die wordt omgezet in spraak.
model_idstringOptionalDefaults to eleven_multilingual_v2

ID van het model dat wordt gebruikt. Je kunt modellen opvragen met GET /v1/models. Het model moet Text to Speech ondersteunen; je kunt dit controleren met de eigenschap can_do_text_to_speech.

language_codestring or nullOptional

Taalcode (ISO 639-1) die wordt gebruikt om een taal af te dwingen voor het model en tekstnormalisatie. Als het model de opgegeven taalcode niet ondersteunt, wordt deze genegeerd. Deze parameter wordt niet ondersteund voor multilingual_v2-modellen.

voice_settingsobject or nullOptional
Steminstellingen die de opgeslagen instellingen voor de opgegeven stem overschrijven. Ze worden alleen toegepast op het opgegeven request.
pronunciation_dictionary_locatorslist of objects or nullOptional

Een lijst met locators voor uitspraakwoordenboeken (id, version_id) die op de tekst worden toegepast. Ze worden op volgorde toegepast. Je kunt maximaal 3 locators per request opgeven

seedinteger or nullOptional
Als dit wordt opgegeven, doet ons systeem zijn best om deterministisch te samplen, zodat herhaalde requests met dezelfde seed en parameters hetzelfde resultaat zouden moeten opleveren. Determinisme is niet gegarandeerd. Moet een geheel getal tussen 0 en 4294967295 zijn.
previous_textstring or nullOptional

De tekst die voorafging aan de tekst van de huidige request. Kan worden gebruikt om de continuïteit van de spraak te verbeteren wanneer meerdere generaties worden samengevoegd, of om de continuïteit van de spraak in de huidige generatie te beïnvloeden.

next_textstring or nullOptional

De tekst die volgt op de tekst van de huidige request. Kan worden gebruikt om de continuïteit van de spraak te verbeteren wanneer meerdere generaties worden samengevoegd, of om de continuïteit van de spraak in de huidige generatie te beïnvloeden.

previous_request_idslist of strings or nullOptional

A list of request_id of the samples that were generated before this generation. Can be used to improve the speech’s continuity when splitting up a large task into multiple requests. The results will be best when the same model is used across the generations. In case both previous_text and previous_request_ids is send, previous_text will be ignored. A maximum of 3 request_ids can be send.

next_request_idslist of strings or nullOptional

A list of request_id of the samples that come after this generation. next_request_ids is especially useful for maintaining the speech’s continuity when regenerating a sample that has had some audio quality issues. For example, if you have generated 3 speech clips, and you want to improve clip 2, passing the request id of clip 3 as a next_request_id (and that of clip 1 as a previous_request_id) will help maintain natural flow in the combined speech. The results will be best when the same model is used across the generations. In case both next_text and next_request_ids is send, next_text will be ignored. A maximum of 3 request_ids can be send.

use_pvc_as_ivcbooleanOptionalDefaults to false

Of de IVC-versie van een professionele stem moet worden gebruikt. Dit kan de expressiviteit verbeteren en latency verminderen.

apply_text_normalizationenumOptionalDefaults to auto

Deze parameter regelt tekstnormalisatie met drie modi: ‘auto’, ‘on’ en ‘off’. Wanneer deze is ingesteld op ‘auto’, bepaalt het systeem automatisch of tekstnormalisatie wordt toegepast (bijvoorbeeld het uitschrijven van getallen). Met ‘on’ wordt tekstnormalisatie altijd toegepast, terwijl deze met ‘off’ wordt overgeslagen.

Allowed values:
apply_language_text_normalizationbooleanOptionalDefaults to false

Deze parameter regelt taalafhankelijke tekstnormalisatie. Dit helpt bij de juiste uitspraak van tekst in sommige ondersteunde talen. WAARSCHUWING: deze parameter kan de latentie van de request aanzienlijk verhogen. Momenteel alleen ondersteund voor Japans.

audio_effectsobject or nullOptional

Audio-effecten die worden toegepast op de gegenereerde audio. Onbekende ID’s retourneren 404, waarbij param de naam van het veld bevat. Galm (environment_id met send_level boven 0) en een niet-nulwaarde voor pan produceren stereo-audio en worden afgewezen met 400 voor uitvoerformaten ulaw_*, alaw_* en pcm_*. Effecten veranderen de kosten van de aanvraag niet.

Response

Streaming-audiogegevens

Errors

422
Unprocessable Entity Error