Skip to navigation

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 kunnen words_timestamps bevatten.

ElevenAgents

  • Gespreksevaluatie uitvoeren: Endpoint Gespreksevaluatie uitvoeren 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 voegt de optionele queryparameters provider, agent_id en branch_id toe om geïmporteerde nummers te filteren.
  • WhatsApp-accountfiltering: WhatsApp-accounts weergeven voegt de optionele queryparameter agent_id toe om accounts op toegewezen agent te filteren.
  • Filters voor onderwerpstijdbereik: Gespreksonderwerpen van agent ophalen 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 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 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 krijgt een expliciete enum, de standaardwaarde created_date en 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-velden project_voice_ref_id en 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

iOS SDK

  • v3.2.1 - Ondersteuning voor dataresidentie in Singapore toegevoegd en singlePeerConnection ingeschakeld voor WebRTC-sessies.

API

Nieuwe endpoints

ElevenAgents

  • Gespreksevaluatie uitvoeren - POST /v1/convai/conversations/{conversation_id}/analysis/evaluations/run
    • Requestbody gebruikt RunConversationEvaluationsRequest om één evaluatiecriterium opnieuw uit te voeren

Bijgewerkte endpoints

ElevenAgents

Music

Speech to Text

Stemmen

  • Gedeelde stemmen weergeven - 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