> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.
### Introductie van Music v2
Music v2 is nu beschikbaar via de ElevenLabs API. Stel `model_id` in op `music_v2` bij [Muziek genereren](/docs/nl/api-reference/music/compose), [Muziek streamen](/docs/nl/api-reference/music/stream), [Gedetailleerd muziek genereren](/docs/nl/api-reference/music/compose-detailed) en [Muziek uploaden](/docs/nl/api-reference/music/upload) 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`.
Genereer binnen enkele minuten je eerste track met de Music API.
Bouw op chunks gebaseerde compositieplannen voor gestructureerde tracks met meerdere secties.
Componeer, stream en upload muziek met `music_v2` via de REST API.
- **Tijdstempels bij uploads**: [Muziek uploaden](/docs/nl/api-reference/music/upload) accepteert optioneel `with_timestamps`; antwoorden kunnen `words_timestamps` bevatten.
### ElevenAgents
- **Gespreksevaluatie uitvoeren**: Endpoint [Gespreksevaluatie uitvoeren](/docs/nl/api-reference/conversations/analysis/run-evaluation) toegevoegd (`POST /v1/convai/conversations/{conversation_id}/analysis/evaluations/run`) om met `RunConversationEvaluationsRequest` één evaluatiecriterium opnieuw uit te voeren voor een voltooid gesprek.
- **Gedrag bij workflowinvoer**: Workflownodes voor override-agents voegen optioneel `entry_behavior` toe (`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_procedure` toegevoegd met bijbehorende foutstatussen. De tool `start_procedure` voegt `already_active` toe aan de foutstatussen.
- **TTS-overschrijvingen bij overdracht**: `AgentTransfer`, zelfstandige agentnodes in workflows en geslaagde toolresultaten van `transfer_to_agent` voegen optioneel `preserve_client_tts_overrides` toe (boolean) om TTS-overschrijvingen aan de clientzijde na een overdracht te behouden.
- **Enum voor interactiebudget**: `InteractionBudget` verwijdert `async` en voegt `5_minutes`, `10_minutes` en `1_hour` toe. Werk configuraties of SDK-enums bij die nog naar `async` verwijzen.
- **Aangepaste selectie van guardrailmodel**: De configuratie voor aangepaste guardrails voegt optioneel `model` toe met varianten van Gemini, Claude en GPT. De guardrailconfiguratie voegt ook optioneel `history_message_count` toe (integer).
- **Filters voor telefoonnummerlijst**: [Telefoonnummers weergeven](/docs/nl/api-reference/phone-numbers/list) voegt de optionele queryparameters `provider`, `agent_id` en `branch_id` toe om geïmporteerde nummers te filteren.
- **WhatsApp-accountfiltering**: [WhatsApp-accounts weergeven](/docs/nl/api-reference/whats-app/accounts/list) voegt de optionele queryparameter `agent_id` toe om accounts op toegewezen agent te filteren.
- **Filters voor onderwerpstijdbereik**: [Gespreksonderwerpen van agent ophalen](/docs/nl/api-reference/conversations/topics/get) voegt de optionele queryparameters `from_unix_secs` en `to_unix_secs` toe om resultaten voor onderwerpdetectie te begrenzen.
- **Configuratie van SIP-codec**: Request- en responsemodellen voor uitgaande SIP-trunks voegen optioneel `enabled_codecs` toe (enum `MediaCodec`).
- **Typen voor memorytools**: Schemas `LoadableMemoryEntry` en `LoadMemoryEntryToolErrorStatus` toegevoegd 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_tags` toe (boolean) voor optionele verwerking van V3-SSML-fonemen.
- **Overschrijvingen voor het weglaten van arrayschema's**: JSON-schemaproperties voor arrays voegen optioneel `is_omitted` toe (wederzijds uitsluitend met andere waardebronnen). `ConstantSchemaOverride` kan constante arraywaarden gebruiken.
- **Foutcontext bij overdracht**: Foutpayloads voor overdracht naar een nummer kunnen optioneel `agent_message` bevatten (string).
### Workspaces
- **Updates voor API-sleutels van serviceaccounts**: [API-sleutel van serviceaccount bijwerken](/docs/nl/api-reference/service-accounts/api-keys/update) vereist niet langer een requestbody. Bewerkvelden ondersteunen gedeeltelijke updates via `no_update` en nullable `name`, waaronder `permissions` en `character_limit`.
- **Tijdzonegroepering voor gebruik**: Requests voor workspacegebruik per product in de tijd voegen optioneel `time_zone` toe (IANA-tijdzonestring) met verduidelijkte regels voor buckets van `interval_seconds`.
- **Filter voor geschiedenisbron**: Filters `source` voor geschiedenislijsten en -details voegen `Flows` toe.
### ElevenCreative Studio
- **Stemreferenties voor projecten**: Projectmodellen, hoofdstuk-TTS-nodes, stemlijsten en stemstatistieken gebruiken `project_voice_ref_id` als het canonieke stemveld. Voormalige velden `voice_id` blijven als verouderde, alleen-lezen spiegels behouden in antwoorden voor compatibiliteit.
### Speech to Text
- **Diarisatie met sprekersbibliotheek**: [Spraak naar tekst converteren](/docs/nl/api-reference/speech-to-text/convert) voegt optioneel `use_speaker_library` toe (boolean, standaard `false`) voor diarizatie van batchtranscripties.
### Stemmen
- **Sortering van gedeelde stemmen**: De queryparameter `sort` van [Gedeelde stemmen weergeven](/docs/nl/api-reference/voices/voice-library/get-shared) krijgt een expliciete enum, de standaardwaarde `created_date` en een bijgewerkte beschrijving.
### SDK-releases
#### JavaScript SDK
- [v2.53.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/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-velden `project_voice_ref_id` en uitgebreidere batchlimieten voor agenttests.
#### Python SDK
- [v2.53.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/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](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.11.0) - Subpathexport `@elevenlabs/client/internal/unity` toegevoegd voor de Unity SDK WebGL-bridge, met `MediaDeviceInput`, `MediaDeviceOutput`, hulpfuncties voor het koppelen van verbindingen en typen voor de WebRTC-adapter.
- [@elevenlabs/client@1.11.1](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.11.1), [@elevenlabs/react@1.6.7](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact%401.6.7), [@elevenlabs/react-native@1.2.7](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Freact-native%401.2.7), [@elevenlabs/convai-widget-core@0.14.2](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.14.2) en [@elevenlabs/convai-widget-embed@0.14.2](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.14.2) - Dependencies afgestemd op `@elevenlabs/client@1.11.1` en `@elevenlabs/types@0.14.1`.
- [@elevenlabs/types@0.14.1](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Ftypes%400.14.1) - `"license": "MIT"` toegevoegd aan `package.json` voor compatibiliteit met license-checker.
#### iOS SDK
- [v3.2.1](https://github.com/elevenlabs/elevenlabs-swift-sdk/releases/tag/v3.2.1) - Ondersteuning voor dataresidentie in Singapore toegevoegd en `singlePeerConnection` ingeschakeld voor WebRTC-sessies.
### API
## Nieuwe endpoints
### ElevenAgents
- [Gespreksevaluatie uitvoeren](/docs/nl/api-reference/conversations/analysis/run-evaluation) - `POST /v1/convai/conversations/{conversation_id}/analysis/evaluations/run`
- Requestbody gebruikt `RunConversationEvaluationsRequest` om één evaluatiecriterium opnieuw uit te voeren
## Bijgewerkte endpoints
### ElevenAgents
- [Telefoonnummers weergeven](/docs/nl/api-reference/phone-numbers/list) - `GET /v1/convai/phone-numbers`
- Optionele queryparameters `provider`, `agent_id` en `branch_id` toegevoegd
- [Gespreksonderwerpen van agent ophalen](/docs/nl/api-reference/conversations/topics/get) - `GET /v1/convai/agents/{agent_id}/topics`
- Optionele queryparameters `from_unix_secs` en `to_unix_secs` toegevoegd
- [WhatsApp-accounts weergeven](/docs/nl/api-reference/whats-app/accounts/list) - `GET /v1/convai/whatsapp-accounts`
- Optionele queryparameter `agent_id` toegevoegd
### Music
- [Muziek genereren](/docs/nl/api-reference/music/compose), [Gedetailleerd muziek genereren](/docs/nl/api-reference/music/compose-detailed), [Muziek streamen](/docs/nl/api-reference/music/stream) en [Muziek uploaden](/docs/nl/api-reference/music/upload)
- `music_v2` toegevoegd aan ondersteunde waarden voor `model_id`
- Upload voegt optioneel `with_timestamps` toe; antwoorden kunnen `words_timestamps` bevatten
### Speech to Text
- [Spraak naar tekst converteren](/docs/nl/api-reference/speech-to-text/convert) - `POST /v1/speech-to-text`
- Optionele queryparameter `use_speaker_library` toegevoegd (boolean, standaard `false`)
### Stemmen
- [Gedeelde stemmen weergeven](/docs/nl/api-reference/voices/voice-library/get-shared) - `GET /v1/shared-voices`
- Queryparameter `sort` gebruikt nu een expliciete enum met `created_date` als standaardwaarde
## Schemawijzigingen
### ElevenAgents
- Workflownodes voor override-agents
- Optionele enum `entry_behavior` toegevoegd (`generate_immediately`, `wait_for_user`, `auto`)
- Systeemtools
- Toolconfiguratie en foutstatussen voor `end_procedure` toegevoegd
- Overdrachts- en interactieschema's
- Optioneel `preserve_client_tts_overrides` toegevoegd aan overdrachten en resultaten van overdrachtstools
- `InteractionBudget` verwijdert `async`; voegt `5_minutes`, `10_minutes`, `1_hour` toe
- Guardrails en TTS
- Aangepaste guardrails voegen optioneel `model` en `history_message_count` toe
- TTS-instellingen voor agents voegen optioneel `enable_phoneme_tags` toe
- Telecommunicatie
- SIP-trunkmodellen voegen optioneel `enabled_codecs` toe (enum `MediaCodec`)
- Memory- en codetools
- `LoadableMemoryEntry` en `LoadMemoryEntryToolErrorStatus` toegevoegd
- 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_omitted` toe
### Workspaces
- Serviceaccounts
- PATCH voor API-sleutels ondersteunt gedeeltelijke updates met sentinels `no_update`
- Gebruik en geschiedenis
- Gebruik per product in de tijd voegt optioneel `time_zone` toe
- Filters `source` voor geschiedenis voegen `Flows` toe
### Music
- Compositieplannen
- Op chunks gebaseerde `CompositionPlan`, `GenerationChunk` en `AudioRefChunk` toegevoegd voor `music_v2`
- Request- en responsebodies accepteren `anyOf`-plannen in v1- of v2-vorm
### ElevenCreative Studio
- Projectstemmodellen
- `project_voice_ref_id` toegevoegd als canonieke stemreferentie
- Verouderde alleen-lezen spiegels `voice_id` blijven behouden in antwoorden