Skip to navigation

Voice Design

Deprecated
Maak een stem vanuit een tekstprompt.

Headers

xi-api-keystringOptional

Query parameters

output_formatenumOptional
Het uitvoerformaat van de gegenereerde audio.

Request

This endpoint expects an object.
voice_descriptionstringRequired20-1000 characters
Beschrijving voor de gemaakte stem.
textstring or nullOptional100-1000 characters

Te genereren tekst; de tekstlengte moet tussen 100 en 1000 liggen.

auto_generate_textbooleanOptionalDefaults to false
Of er automatisch een tekst moet worden gegenereerd die geschikt is voor de stembeschrijving.
loudnessdoubleOptional-1-1Defaults to 0.5

Bepaalt het volumeniveau van de gegenereerde stem. -1 is het zachtst, 1 het hardst en 0 komt overeen met ongeveer -24 LUFS.

qualitydoubleOptional-1-1Defaults to 0.9
Hogere kwaliteit resulteert in betere stemoutput, maar minder variatie.
seedinteger or nullOptional0-2147483647
Willekeurig getal dat de stemgeneratie aanstuurt. Dezelfde seed met dezelfde invoer produceert dezelfde stem.
guidance_scaledoubleOptional0-100Defaults to 5
Bepaalt hoe nauw de AI de prompt volgt. Lagere waarden geven de AI meer ruimte om creatief te zijn, terwijl hogere waarden de AI dwingen zich sterker aan de prompt te houden. Hoge waarden kunnen ervoor zorgen dat de stem kunstmatig of robotachtig klinkt. We raden aan langere, gedetailleerdere prompts te gebruiken bij een lagere Guidance Scale.
should_enhancebooleanOptionalDefaults to false
Of de stembeschrijving met AI moet worden verbeterd om meer details toe te voegen en de kwaliteit van stemgeneratie te verbeteren. Wanneer ingeschakeld, breidt het systeem eenvoudige prompts automatisch uit tot uitgebreidere stembeschrijvingen. Standaard is False.

Response

Geslaagde response
previewslist of objects
De previews van de gegenereerde stemmen.
textstring
De tekst die wordt gebruikt om de stemmen te beluisteren.

Errors

409
Conflict Error
422
Unprocessable Entity Error