Hoppa till navigering

Vi introducerar Music v2

Music v2 är nu tillgängligt via ElevenLabs API. Ange model_id till music_v2 i Generera musik, Streama musik, Generera musik med detaljer och Ladda upp musik för att använda den nya modellen. Music v2 introducerar chunk-baserade kompositionsplaner som byggs av segmenten GenerationChunk och AudioRefChunk, vilket ger dig mer detaljerad kontroll över struktur, tempo och arrangemang än det promptbaserade flödet music_v1.

Använd kompositionsplaner för music_v2 i genererings- och uppladdningsförfrågningar, eller generera först en plan via endpointen för kompositionsplaner. Förfrågnings- och svarsbrödtexter accepterar antingen v1- eller v2-planformat, så att du kan migrera endpoint för endpoint. MusicPrompt är fortfarande endast tillgängligt för music_v1.

  • Tidsstämplar vid uppladdning: Ladda upp musik accepterar valfria with_timestamps; svar kan innehålla words_timestamps.

ElevenAgents

  • Kör konversationsutvärdering: Lade till endpointen Kör konversationsutvärdering (POST /v1/convai/conversations/{conversation_id}/analysis/evaluations/run) för att köra om ett enskilt utvärderingskriterium mot en avslutad konversation med RunConversationEvaluationsRequest.
  • Beteende vid workflow-start: Workflow-noder för åsidosättningsagenter lägger till valfria entry_behavior (generate_immediately, wait_for_user, auto) för att styra om underagenten talar först eller väntar på användarindata.
  • Systemverktyg för att avsluta procedur: Lade till systemverktygskonfigurationen end_procedure med matchande felstatusar. Verktyget start_procedure lägger till already_active i sina felstatusar.
  • TTS-åsidosättanden vid överföring: AgentTransfer, fristående agentnoder i workflow och lyckade verktygsresultat från transfer_to_agent lägger till valfria preserve_client_tts_overrides (boolean) för att behålla TTS-åsidosättanden på klientsidan efter en överföring.
  • Enum för interaktionsbudget: InteractionBudget tar bort async och lägger till 5_minutes, 10_minutes och 1_hour. Uppdatera konfigurationer eller SDK-enumeringar som fortfarande refererar till async.
  • Val av modell för anpassade skyddsräcken: Konfigurationen för anpassade skyddsräcken lägger till valfria model med Gemini-, Claude- och GPT-varianter. Konfigurationen för skyddsräcken lägger också till valfria history_message_count (heltal).
  • Filter för telefonnummerlista: Lista telefonnummer lägger till valfria frågeparametrarna provider, agent_id och branch_id för att filtrera importerade nummer.
  • Filtrering av WhatsApp-konton: Lista WhatsApp-konton lägger till den valfria frågeparametern agent_id för att filtrera konton efter tilldelad agent.
  • Tidsintervallfilter för ämnen: Hämta agentens konversationsämnen lägger till valfria frågeparametrarna from_unix_secs och to_unix_secs för att begränsa resultat för ämnesidentifiering.
  • SIP-codec-konfiguration: Begärande- och svarsmodeller för utgående SIP-trunk lägger till valfria enabled_codecs (MediaCodec-enum).
  • Typer för minnesverktyg: Lade till schemana LoadableMemoryEntry och LoadMemoryEntryToolErrorStatus för felhantering i minnesverktyg.
  • Batchgränser för agenttester: Begärandescheman för att koppla, köra och skicka in agenttester på nytt höjer maximalt antal kopplade tester från 1000 till 5000.
  • Stöd för fonemtaggar: Agentens TTS-inställningar lägger till valfria enable_phoneme_tags (boolean) för valfri V3-hantering av SSML-fonem.
  • Åsidosättanden för utelämning i arrayschema: JSON-schemaegenskaper för arrayer lägger till valfria is_omitted (ömsesidigt uteslutande med andra värdekällor). ConstantSchemaOverride kan använda konstanta arrayvärden.
  • Felkontext vid överföring: Felpayloads för överföring till nummer kan innehålla valfria agent_message (sträng).

Arbetsytor

  • Uppdateringar av API-nycklar för tjänstekonton: Uppdatera API-nyckel för tjänstekonto kräver inte längre en begärandetext. Redigeringsfält har stöd för partiella uppdateringar via no_update och nullable name, inklusive permissions och character_limit.
  • Tidszonsindelning av användning: Förfrågningar om arbetsytans användning per produkt över tid lägger till valfria time_zone (IANA-tidszonsträng) med förtydligade regler för interval_seconds-intervall.
  • Källfilter för historik: Filtren source för historiklistor och -detaljer lägger till Flows.

ElevenCreative Studio

  • Projektröstreferenser: Projektmodeller, kapitel-TTS-noder, röstlistor och röststatistik övergår till project_voice_ref_id som det kanoniska röstfältet. Tidigare fält voice_id finns kvar i svar som föråldrade, skrivskyddade speglingar för kompatibilitet.

Speech to Text

  • Diarisering med röstbibliotek: Konvertera tal till text lägger till valfria use_speaker_library (boolean, standard false) för diariserad batchtranskribering.

Röster

  • Sortering av delade röster: Frågeparametern sort i Lista delade röster får en explicit enum, standardvärdet created_date och en uppdaterad beskrivning.

SDK-versioner

JavaScript SDK

  • v2.53.0 - Återgenererad från det senaste OpenAPI-schemat med stöd för att köra om konversationsutvärderingar, unioner för kompositionsplaner i music v2, workflow-entry_behavior, listfilter för telefonnummer och WhatsApp, parametrar för tidsintervall för ämnen, uppdateringar av aviseringsschema, studiofält för project_voice_ref_id och utökade batchgränser för agenttester.

Python SDK

  • v2.53.0 - Återgenererad från det senaste OpenAPI-schemat med stöd för att köra om konversationsutvärderingar, kompositionsplaner för music v2, workflow-startbeteende och verktyg för att avsluta procedurer, telekomfilterparametrar, modeller för partiella uppdateringar av aviseringar och tjänstekonton samt röstreferensfält för studio.

Paket

iOS SDK

  • v3.2.1 - Lade till stöd för datahemvist i Singapore och aktiverade singlePeerConnection för WebRTC-sessioner.

API

Nya endpoints

ElevenAgents

  • Kör konversationsutvärdering - POST /v1/convai/conversations/{conversation_id}/analysis/evaluations/run
    • Begärandetexten använder RunConversationEvaluationsRequest för att köra om ett enskilt utvärderingskriterium

Uppdaterade endpoints

ElevenAgents

Musik

Speech to Text

  • Konvertera tal till text - POST /v1/speech-to-text
    • Lade till valfri frågeparameter use_speaker_library (boolean, standard false)

Röster

  • Lista delade röster - GET /v1/shared-voices
    • Frågeparametern sort använder nu en explicit enum med standardvärdet created_date

Schemaändringar

ElevenAgents

  • Workflow-noder för åsidosättningsagenter
    • Lade till valfri entry_behavior-enum (generate_immediately, wait_for_user, auto)
  • Systemverktyg
    • Lade till verktygskonfigurationen end_procedure och felstatusar
  • Överförings- och interaktionsscheman
    • Lade till valfria preserve_client_tts_overrides för överföringar och verktygsresultat för överföring
    • InteractionBudget tar bort async; lägger till 5_minutes, 10_minutes, 1_hour
  • Skyddsräcken och TTS
    • Anpassade skyddsräcken lägger till valfria model och history_message_count
    • Agentens TTS-inställningar lägger till valfria enable_phoneme_tags
  • Telekommunikation
    • SIP-trunkmodeller lägger till valfria enabled_codecs (MediaCodec-enum)
  • Minnes- och kodverktyg
    • Lade till LoadableMemoryEntry och LoadMemoryEntryToolErrorStatus
  • Agenttestning
    • Höjde gränserna för kopplade tester från 1000 till 5000 för kör- och återsändningsförfrågningar
  • JSON-schemaegenskaper för verktyg
    • Arrayegenskaper lägger till valfria is_omitted

Arbetsytor

  • Tjänstekonton
    • PATCH för API-nycklar har stöd för partiella uppdateringar med no_update-sentinels
  • Användning och historik
    • Användning per produkt över tid lägger till valfria time_zone
    • Historikfilter för source lägger till Flows

Musik

  • Kompositionsplaner
    • Lade till chunk-baserade CompositionPlan, GenerationChunk och AudioRefChunk för music_v2
    • Förfrågnings- och svarsbrödtexter accepterar anyOf v1- eller v2-planformat

ElevenCreative Studio

  • Projektröstmodeller
    • Lade till project_voice_ref_id som kanonisk röstreferens
    • Föråldrade skrivskyddade speglingar av voice_id behålls i svar