Introductie van Music v2
Music v2 is nu beschikbaar via de ElevenLabs API. Stel model_id in op music_v2 bij Muziek genereren, Muziek streamen, Gedetailleerd muziek genereren en Muziek uploaden om het nieuwe model te gebruiken. Music v2 introduceert op chunks gebaseerde compositieplannen die zijn opgebouwd uit segmenten GenerationChunk en AudioRefChunk, waardoor je meer controle hebt over structuur, tempo en arrangement dan met de promptgebaseerde flow van music_v1.
Gebruik compositieplannen van music_v2 in generatie- en uploadrequests, of genereer eerst een plan via het endpoint voor compositieplannen. Request- en responsebodies accepteren plannen in zowel v1- als v2-vorm, zodat je endpoint voor endpoint kunt migreren. MusicPrompt blijft alleen beschikbaar voor music_v1.
- Tijdstempels bij uploads: Muziek uploaden accepteert optioneel
with_timestamps; antwoorden kunnenwords_timestampsbevatten.
ElevenAgents
- Gespreksevaluatie uitvoeren: Endpoint Gespreksevaluatie uitvoeren toegevoegd (
POST /v1/convai/conversations/{conversation_id}/analysis/evaluations/run) om metRunConversationEvaluationsRequestéén evaluatiecriterium opnieuw uit te voeren voor een voltooid gesprek. - Gedrag bij workflowinvoer: Workflownodes voor override-agents voegen optioneel
entry_behaviortoe (generate_immediately,wait_for_user,auto) om te bepalen of de subagent als eerste spreekt of wacht op gebruikersinvoer. - Systeemtool voor procedure beëindigen: Configuratie voor de systeemtool
end_proceduretoegevoegd met bijbehorende foutstatussen. De toolstart_procedurevoegtalready_activetoe aan de foutstatussen. - TTS-overschrijvingen bij overdracht:
AgentTransfer, zelfstandige agentnodes in workflows en geslaagde toolresultaten vantransfer_to_agentvoegen optioneelpreserve_client_tts_overridestoe (boolean) om TTS-overschrijvingen aan de clientzijde na een overdracht te behouden. - Enum voor interactiebudget:
InteractionBudgetverwijdertasyncen voegt5_minutes,10_minutesen1_hourtoe. Werk configuraties of SDK-enums bij die nog naarasyncverwijzen. - Aangepaste selectie van guardrailmodel: De configuratie voor aangepaste guardrails voegt optioneel
modeltoe met varianten van Gemini, Claude en GPT. De guardrailconfiguratie voegt ook optioneelhistory_message_counttoe (integer). - Filters voor telefoonnummerlijst: Telefoonnummers weergeven voegt de optionele queryparameters
provider,agent_idenbranch_idtoe om geïmporteerde nummers te filteren. - WhatsApp-accountfiltering: WhatsApp-accounts weergeven voegt de optionele queryparameter
agent_idtoe om accounts op toegewezen agent te filteren. - Filters voor onderwerpstijdbereik: Gespreksonderwerpen van agent ophalen voegt de optionele queryparameters
from_unix_secsento_unix_secstoe om resultaten voor onderwerpdetectie te begrenzen. - Configuratie van SIP-codec: Request- en responsemodellen voor uitgaande SIP-trunks voegen optioneel
enabled_codecstoe (enumMediaCodec). - Typen voor memorytools: Schemas
LoadableMemoryEntryenLoadMemoryEntryToolErrorStatustoegevoegd voor foutafhandeling van memorytools. - Batchlimieten voor agenttests: Requestschemas voor het koppelen, uitvoeren en opnieuw indienen van agenttests verhogen het maximumaantal gekoppelde tests van 1000 naar 5000.
- Ondersteuning voor foneemtags: TTS-instellingen voor agents voegen optioneel
enable_phoneme_tagstoe (boolean) voor optionele verwerking van V3-SSML-fonemen. - Overschrijvingen voor het weglaten van arrayschema’s: JSON-schemaproperties voor arrays voegen optioneel
is_omittedtoe (wederzijds uitsluitend met andere waardebronnen).ConstantSchemaOverridekan constante arraywaarden gebruiken. - Foutcontext bij overdracht: Foutpayloads voor overdracht naar een nummer kunnen optioneel
agent_messagebevatten (string).
Workspaces
- Updates voor API-sleutels van serviceaccounts: API-sleutel van serviceaccount bijwerken vereist niet langer een requestbody. Bewerkvelden ondersteunen gedeeltelijke updates via
no_updateen nullablename, waaronderpermissionsencharacter_limit. - Tijdzonegroepering voor gebruik: Requests voor workspacegebruik per product in de tijd voegen optioneel
time_zonetoe (IANA-tijdzonestring) met verduidelijkte regels voor buckets vaninterval_seconds. - Filter voor geschiedenisbron: Filters
sourcevoor geschiedenislijsten en -details voegenFlowstoe.
ElevenCreative Studio
- Stemreferenties voor projecten: Projectmodellen, hoofdstuk-TTS-nodes, stemlijsten en stemstatistieken gebruiken
project_voice_ref_idals het canonieke stemveld. Voormalige veldenvoice_idblijven als verouderde, alleen-lezen spiegels behouden in antwoorden voor compatibiliteit.
Speech to Text
- Diarisatie met sprekersbibliotheek: Spraak naar tekst converteren voegt optioneel
use_speaker_librarytoe (boolean, standaardfalse) voor diarizatie van batchtranscripties.
Stemmen
- Sortering van gedeelde stemmen: De queryparameter
sortvan Gedeelde stemmen weergeven krijgt een expliciete enum, de standaardwaardecreated_dateen een bijgewerkte beschrijving.
SDK-releases
JavaScript SDK
- v2.53.0 - Opnieuw gegenereerd op basis van het nieuwste OpenAPI-schema met ondersteuning voor het opnieuw uitvoeren van gespreksevaluaties, unions voor compositieplannen van music v2, workflow-
entry_behavior, filters voor telefoonnummer- en WhatsApp-lijsten, parameters voor onderwerpstijdbereik, updates voor waarschuwingsschema’s, studio-veldenproject_voice_ref_iden uitgebreidere batchlimieten voor agenttests.
Python SDK
- v2.53.0 - Opnieuw gegenereerd op basis van het nieuwste OpenAPI-schema met ondersteuning voor het opnieuw uitvoeren van gespreksevaluaties, compositieplannen van music v2, workflowinvoergedrag en tools voor procedures beëindigen, telecommunicatiefilterparameters, modellen voor waarschuwingen en gedeeltelijke updates van serviceaccounts en stemreferentievelden voor Studio.
Pakketten
- @elevenlabs/client@1.11.0 - Subpathexport
@elevenlabs/client/internal/unitytoegevoegd voor de Unity SDK WebGL-bridge, metMediaDeviceInput,MediaDeviceOutput, hulpfuncties voor het koppelen van verbindingen en typen voor de WebRTC-adapter. - @elevenlabs/client@1.11.1, @elevenlabs/react@1.6.7, @elevenlabs/react-native@1.2.7, @elevenlabs/convai-widget-core@0.14.2 en @elevenlabs/convai-widget-embed@0.14.2 - Dependencies afgestemd op
@elevenlabs/client@1.11.1en@elevenlabs/types@0.14.1. - @elevenlabs/types@0.14.1 -
"license": "MIT"toegevoegd aanpackage.jsonvoor compatibiliteit met license-checker.
iOS SDK
- v3.2.1 - Ondersteuning voor dataresidentie in Singapore toegevoegd en
singlePeerConnectioningeschakeld voor WebRTC-sessies.
API
API-wijzigingen bekijken
Nieuwe endpoints
ElevenAgents
- Gespreksevaluatie uitvoeren -
POST /v1/convai/conversations/{conversation_id}/analysis/evaluations/run- Requestbody gebruikt
RunConversationEvaluationsRequestom één evaluatiecriterium opnieuw uit te voeren
- Requestbody gebruikt
Bijgewerkte endpoints
ElevenAgents
- Telefoonnummers weergeven -
GET /v1/convai/phone-numbers- Optionele queryparameters
provider,agent_idenbranch_idtoegevoegd
- Optionele queryparameters
- Gespreksonderwerpen van agent ophalen -
GET /v1/convai/agents/{agent_id}/topics- Optionele queryparameters
from_unix_secsento_unix_secstoegevoegd
- Optionele queryparameters
- WhatsApp-accounts weergeven -
GET /v1/convai/whatsapp-accounts- Optionele queryparameter
agent_idtoegevoegd
- Optionele queryparameter
Music
- Muziek genereren, Gedetailleerd muziek genereren, Muziek streamen en Muziek uploaden
music_v2toegevoegd aan ondersteunde waarden voormodel_id- Upload voegt optioneel
with_timestampstoe; antwoorden kunnenwords_timestampsbevatten
Speech to Text
- Spraak naar tekst converteren -
POST /v1/speech-to-text- Optionele queryparameter
use_speaker_librarytoegevoegd (boolean, standaardfalse)
- Optionele queryparameter
Stemmen
- Gedeelde stemmen weergeven -
GET /v1/shared-voices- Queryparameter
sortgebruikt nu een expliciete enum metcreated_dateals standaardwaarde
- Queryparameter
Schemawijzigingen
ElevenAgents
- Workflownodes voor override-agents
- Optionele enum
entry_behaviortoegevoegd (generate_immediately,wait_for_user,auto)
- Optionele enum
- Systeemtools
- Toolconfiguratie en foutstatussen voor
end_proceduretoegevoegd
- Toolconfiguratie en foutstatussen voor
- Overdrachts- en interactieschema’s
- Optioneel
preserve_client_tts_overridestoegevoegd aan overdrachten en resultaten van overdrachtstools InteractionBudgetverwijdertasync; voegt5_minutes,10_minutes,1_hourtoe
- Optioneel
- Guardrails en TTS
- Aangepaste guardrails voegen optioneel
modelenhistory_message_counttoe - TTS-instellingen voor agents voegen optioneel
enable_phoneme_tagstoe
- Aangepaste guardrails voegen optioneel
- Telecommunicatie
- SIP-trunkmodellen voegen optioneel
enabled_codecstoe (enumMediaCodec)
- SIP-trunkmodellen voegen optioneel
- Memory- en codetools
LoadableMemoryEntryenLoadMemoryEntryToolErrorStatustoegevoegd
- Agenttests
- Limieten voor gekoppelde tests verhoogd van 1000 naar 5000 voor requests voor uitvoeren en opnieuw indienen
- JSON-schemaproperties voor tools
- Arrayproperties voegen optioneel
is_omittedtoe
- Arrayproperties voegen optioneel
Workspaces
- Serviceaccounts
- PATCH voor API-sleutels ondersteunt gedeeltelijke updates met sentinels
no_update
- PATCH voor API-sleutels ondersteunt gedeeltelijke updates met sentinels
- Gebruik en geschiedenis
- Gebruik per product in de tijd voegt optioneel
time_zonetoe - Filters
sourcevoor geschiedenis voegenFlowstoe
- Gebruik per product in de tijd voegt optioneel
Music
- Compositieplannen
- Op chunks gebaseerde
CompositionPlan,GenerationChunkenAudioRefChunktoegevoegd voormusic_v2 - Request- en responsebodies accepteren
anyOf-plannen in v1- of v2-vorm
- Op chunks gebaseerde
ElevenCreative Studio
- Projectstemmodellen
project_voice_ref_idtoegevoegd als canonieke stemreferentie- Verouderde alleen-lezen spiegels
voice_idblijven behouden in antwoorden