Introductie van SFX v3 voor ontwikkelaars

Vandaag brengen we SFX v3 uit, ons nieuwste model voor geluidseffecten in de Sound Effects API. Het volgt prompts met meerdere instructies nauwkeuriger dan SFX v2 en verwerkt zang en muziek beter. Om het te proberen, stel je model_id in op eleven_text_to_sound_v3 op het POST-/v1/sound-generation-endpoint.

Model-ID

Werk eenvoudig de model-ID bij om het nieuwe model te gebruiken:

from elevenlabs import ElevenLabs

elevenlabs = ElevenLabs()

audio = elevenlabs.text_to_sound_effects.convert(
    text="Football crowd cheering, hearing a ball drop, crowd booing",
    model_id="eleven_text_to_sound_v3",
)

Het model bepaalt de lengte van het geluidseffect op basis van de prompt. Als je specifieke timing nodig hebt, stel je duration_seconds in op de gewenste duur.

Als de output afwijkt van wat je hebt gevraagd, verhoog je prompt_influence boven de standaardwaarde van 0.3. Hogere waarden volgen de prompt nauwkeuriger en verschillen minder tussen generaties. De queryparameter output_format stelt de codec en sample rate in, zoals mp3_44100_128 of pcm_48000.

Looping werkt momenteel alleen met eleven_text_to_sound_v2. Als je dit nodig hebt voor je request, blijf dan het v2-model gebruiken met loop: true.

Prompts schrijven

SFX v3 is uitstekend in geluidseffecten uit meerdere delen. Om het beste uit het model te halen, is de volgorde van de prompts belangrijk. Geef gebeurtenissen weer in de volgorde waarin ze moeten plaatsvinden, bijvoorbeeld: "Voetstappen op grind, daarna gaat een metalen deur open." Voor één geluid werkt een korte, concrete prompt het best.

Ook de formulering is belangrijk. Een van onze testers ontdekte dat "een stel dat in het Frans ruziet" veel beter werkte dan "een stel dat in het Frans vecht". Probeer verschillende formuleringen van dezelfde gebeurtenis voordat je er een kiest.

Test beide modellen

SFX v3 is een stapsgewijze update. Het is minder waarschijnlijk dat hoge frequenties, zoals gongs, klokken en fluitketels, worden afgeknipt, en volgens ons engineeringteam klinkt het over het algemeen natuurlijker.

Omdat beide modellen op hetzelfde endpoint draaien, is een A/B-test goedkoop. Voer je meestgebruikte prompts uit met zowel v2 als v3 om de resultaten te vergelijken voordat je overstapt.

Probeer SFX v3

Bekijk de API-referentie voor Create sound effect voor de volledige lijst met parameters en verstuur vervolgens je eerste v3-request. Wil je je geluidseffecten liever horen voordat je code schrijft? Je vindt ze ook in het tabblad Sound Effects, Flows en Studio in ElevenCreative.