Skip to navigation
ElevenAPIVoice Design

Een stem remixen.

Remix een bestaande stem via een prompt. Deze methode retourneert een lijst met stemvoorbeelden. Elk voorbeeld heeft een generated_voice_id en een sample van de stem als base64-gecodeerde mp3-audio. Gebruik de generated_voice_id van het gewenste voorbeeld met het endpoint /v1/text-to-voice om een stem te maken.

Path parameters

voice_idstringRequired

Te gebruiken stem-ID. Je kunt https://api.elevenlabs.io/v1/voices gebruiken om alle beschikbare stemmen weer te geven.

Headers

xi-api-keystringOptional

Query parameters

output_formatenumOptional

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.
voice_descriptionstringRequired5-1000 characters
Beschrijving van de wijzigingen die je in de stem wilt aanbrengen.
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.

seedinteger or nullOptional0-2147483647
Willekeurig getal dat de stemgeneratie aanstuurt. Dezelfde seed met dezelfde invoer produceert dezelfde stem.
guidance_scaledoubleOptional0-100Defaults to 2
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.
stream_previewsbooleanOptionalDefaults to false

Bepaalt of de Text to Voice-voorbeelden in het antwoord moeten worden opgenomen. Als dit waar is, worden alleen de gegenereerde ID’s geretourneerd. Deze kunnen vervolgens worden gestreamd via het endpoint /v1/text-to-voice/:generated_voice_id/stream.

remixing_session_idstring or nullOptional

De remixsessie-id.

remixing_session_iteration_idstring or nullOptional
De id van de iteratie van de remixsessie waaraan deze generaties moeten worden gekoppeld. Als deze niet is opgegeven, wordt een nieuwe iteratie gemaakt.
prompt_strengthdouble or nullOptional0-1

Bepaalt de balans tussen prompt en referentieaudio bij het genereren van stemvoorbeelden. 0 betekent vrijwel geen invloed van de prompt, 1 betekent vrijwel geen invloed van referentieaudio. Alleen ondersteund bij gebruik van het model eleven_ttv_v3.

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