Einführung von Music v2
Music v2 ist jetzt über die ElevenLabs API verfügbar. Setzen Sie bei Musik generieren, Musik streamen, Musik detailliert generieren und Musik hochladen model_id auf music_v2, um das neue Modell zu verwenden. Music v2 führt chunkbasierte Kompositionspläne ein, die aus Segmenten von GenerationChunk und AudioRefChunk bestehen. Sie erhalten damit mehr Kontrolle über Struktur, Tempo und Arrangement als mit dem promptbasierten Ablauf von music_v1.
Verwenden Sie music_v2-Kompositionspläne für Generierungs- und Upload-Anfragen oder generieren Sie zuerst einen Plan über den Endpunkt für Kompositionspläne. Anfrage- und Antworttexte akzeptieren entweder v1- oder v2-Planformate, sodass Sie Endpunkt für Endpunkt migrieren können. MusicPrompt bleibt nur für music_v1 verfügbar.
- Upload-Zeitstempel: Musik hochladen akzeptiert optional
with_timestamps; Antworten könnenwords_timestampsenthalten.
ElevenAgents
- Unterhaltungsevaluierung ausführen: Endpunkt Unterhaltungsevaluierung ausführen (
POST /v1/convai/conversations/{conversation_id}/analysis/evaluations/run) hinzugefügt, um mitRunConversationEvaluationsRequestein einzelnes Evaluierungskriterium für eine abgeschlossene Unterhaltung erneut auszuführen. - Verhalten beim Workflow-Einstieg: Workflow-Knoten zum Überschreiben von Agenten ergänzen optional
entry_behavior(generate_immediately,wait_for_user,auto), um zu steuern, ob der Unteragent zuerst spricht oder auf Benutzereingaben wartet. - System-Tool zum Beenden von Prozeduren: System-Tool-Konfiguration
end_proceduremit passenden Fehlerstatus hinzugefügt. Das Toolstart_procedureergänztalready_activezu seinen Fehlerstatus. - TTS-Overrides bei Transfers:
AgentTransfer, eigenständige Agentenknoten in Workflows und erfolgreiche Tool-Ergebnisse vontransfer_to_agentergänzen optionalpreserve_client_tts_overrides(Boolean), um clientseitige TTS-Overrides nach einem Transfer beizubehalten. - Enum für Interaktionsbudget:
InteractionBudgetentferntasyncund ergänzt5_minutes,10_minutesund1_hour. Aktualisieren Sie alle Konfigurationen oder SDK-Enums, die noch aufasyncverweisen. - Auswahl benutzerdefinierter Leitplankenmodelle: Die Konfiguration benutzerdefinierter Leitplanken ergänzt optional
modelmit Gemini-, Claude- und GPT-Varianten. Die Leitplankenkonfiguration ergänzt außerdem optionalhistory_message_count(Ganzzahl). - Filter für Telefonnummernlisten: Telefonnummern auflisten ergänzt die optionalen Abfrageparameter
provider,agent_idundbranch_id, um importierte Nummern zu filtern. - Filterung von WhatsApp-Konten: WhatsApp-Konten auflisten ergänzt den optionalen Abfrageparameter
agent_id, um Konten nach zugewiesenem Agenten zu filtern. - Filter für Themen-Zeiträume: Unterhaltungsthemen des Agenten abrufen ergänzt die optionalen Abfrageparameter
from_unix_secsundto_unix_secs, um Ergebnisse der Themenerkennung einzugrenzen. - SIP-Codec-Konfiguration: Anfrage- und Antwortmodelle für ausgehende SIP-Trunks ergänzen optional
enabled_codecs(EnumMediaCodec). - Typen für Memory-Tools: Schemas für
LoadableMemoryEntryundLoadMemoryEntryToolErrorStatuszur Fehlerbehandlung von Memory-Tools hinzugefügt. - Batch-Limits für Agententests: Anfrage-Schemas zum Anhängen, Ausführen und erneuten Senden von Agententests erhöhen die maximale Anzahl angehängter Tests von 1000 auf 5000.
- Unterstützung für Phonem-Tags: TTS-Einstellungen für Agenten ergänzen optional
enable_phoneme_tags(Boolean) für die optionale Verarbeitung von V3-SSML-Phonemen. - Array-Schema-Overrides zum Auslassen: JSON-Schema-Eigenschaften für Arrays ergänzen optional
is_omitted(schließt andere Wertquellen gegenseitig aus).ConstantSchemaOverridekann konstante Array-Werte verwenden. - Fehlerkontext bei Transfers: Fehler-Payloads für Transfers zu Nummern können optional
agent_message(String) enthalten.
Arbeitsbereiche
- Aktualisierungen von API-Keys für Servicekonten: API-Key für Servicekonto aktualisieren erfordert keinen Anfrageinhalt mehr. Bearbeitungsfelder unterstützen Teilaktualisierungen über
no_updateund nullablename, einschließlichpermissionsundcharacter_limit. - Zeitzonen-Bucketung für Nutzung: Anfragen zur Arbeitsbereichsnutzung nach Produkt im Zeitverlauf ergänzen optional
time_zone(IANA-Zeitzonen-String) mit präzisierten Regeln fürinterval_seconds-Buckets. - Filter für Verlaufsquellen: Die Filter
sourcefür Verlaufsliste und -details ergänzenFlows.
ElevenCreative Studio
- Projekt-Stimmreferenzen: Projektmodelle, Kapitel-TTS-Knoten, Stimmenlisten und Stimmstatistiken verwenden nun
project_voice_ref_idals kanonisches Stimmenfeld. Die bisherigen Feldervoice_idbleiben aus Kompatibilitätsgründen als veraltete, schreibgeschützte Spiegelungen in Antworten erhalten.
Speech to Text
- Diarisierung mit Stimmbibliothek: Sprache in Text umwandeln ergänzt optional
use_speaker_library(Boolean, Standardfalse) für die Diarisierung bei Batch-Transkriptionen.
Stimmen
- Sortierung geteilter Stimmen: Der Abfrageparameter
sortvon Geteilte Stimmen auflisten erhält eine explizite Enum, den Standardcreated_dateund eine aktualisierte Beschreibung.
SDK-Veröffentlichungen
JavaScript SDK
- v2.53.0 - Aus dem neuesten OpenAPI-Schema neu generiert, mit Unterstützung für die erneute Ausführung von Unterhaltungsevaluierungen, Unions für Music-v2-Kompositionspläne, Workflow-
entry_behavior, Listenfiltern für Telefonnummern und WhatsApp, Parametern für Themenzeiträume, Aktualisierungen des Alerting-Schemas, Studio-Feldern fürproject_voice_ref_idund erweiterten Batch-Limits für Agententests.
Python SDK
- v2.53.0 - Aus dem neuesten OpenAPI-Schema neu generiert, mit Unterstützung für die erneute Ausführung von Unterhaltungsevaluierungen, Music-v2-Kompositionsplänen, Workflow-Einstiegsverhalten und Tools zum Beenden von Prozeduren, Filterparametern für Telefonie, Modellen für Alerting und Teilaktualisierungen von Servicekonten sowie Studio-Stimmreferenzfeldern.
Pakete
- @elevenlabs/client@1.11.0 - Subpfad-Export
@elevenlabs/client/internal/unityfür die Unity-SDK-WebGL-Bridge hinzugefügt, mitMediaDeviceInput,MediaDeviceOutput, Hilfsfunktionen zum Anhängen von Verbindungen und WebRTC-Adaptertypen. - @elevenlabs/client@1.11.1, @elevenlabs/react@1.6.7, @elevenlabs/react-native@1.2.7, @elevenlabs/convai-widget-core@0.14.2 und @elevenlabs/convai-widget-embed@0.14.2 - Abhängigkeiten an
@elevenlabs/client@1.11.1und@elevenlabs/types@0.14.1angeglichen. - @elevenlabs/types@0.14.1 -
"license": "MIT"zupackage.jsonfür Kompatibilität mit license-checker hinzugefügt.
iOS SDK
- v3.2.1 - Unterstützung für Datenresidenz in Singapur hinzugefügt und
singlePeerConnectionfür WebRTC-Sitzungen aktiviert.
API
API-Änderungen anzeigen
Neue Endpunkte
ElevenAgents
- Unterhaltungsevaluierung ausführen -
POST /v1/convai/conversations/{conversation_id}/analysis/evaluations/run- Anfrageinhalt verwendet
RunConversationEvaluationsRequest, um ein einzelnes Evaluierungskriterium erneut auszuführen
- Anfrageinhalt verwendet
Aktualisierte Endpunkte
ElevenAgents
- Telefonnummern auflisten -
GET /v1/convai/phone-numbers- Optionale Abfrageparameter
provider,agent_idundbranch_idhinzugefügt
- Optionale Abfrageparameter
- Unterhaltungsthemen des Agenten abrufen -
GET /v1/convai/agents/{agent_id}/topics- Optionale Abfrageparameter
from_unix_secsundto_unix_secshinzugefügt
- Optionale Abfrageparameter
- WhatsApp-Konten auflisten -
GET /v1/convai/whatsapp-accounts- Optionalen Abfrageparameter
agent_idhinzugefügt
- Optionalen Abfrageparameter
Musik
- Musik generieren, Musik detailliert generieren, Musik streamen und Musik hochladen
music_v2zu den unterstütztenmodel_id-Werten hinzugefügt- Upload ergänzt optional
with_timestamps; Antworten könnenwords_timestampsenthalten
Speech to Text
- Sprache in Text umwandeln -
POST /v1/speech-to-text- Optionalen Abfrageparameter
use_speaker_libraryhinzugefügt (Boolean, Standardfalse)
- Optionalen Abfrageparameter
Stimmen
- Geteilte Stimmen auflisten -
GET /v1/shared-voices- Der Abfrageparameter
sortverwendet jetzt eine explizite Enum mit dem Standardcreated_date
- Der Abfrageparameter
Schema-Änderungen
ElevenAgents
- Workflow-Knoten zum Überschreiben von Agenten
- Optionale Enum
entry_behaviorhinzugefügt (generate_immediately,wait_for_user,auto)
- Optionale Enum
- System-Tools
- Tool-Konfiguration und Fehlerstatus für
end_procedurehinzugefügt
- Tool-Konfiguration und Fehlerstatus für
- Transfer- und Interaktionsschemas
- Optionales
preserve_client_tts_overridesfür Transfers und Ergebnisse von Transfer-Tools hinzugefügt InteractionBudgetentferntasync; ergänzt5_minutes,10_minutes,1_hour
- Optionales
- Leitplanken und TTS
- Benutzerdefinierte Leitplanken ergänzen optional
modelundhistory_message_count - TTS-Einstellungen für Agenten ergänzen optional
enable_phoneme_tags
- Benutzerdefinierte Leitplanken ergänzen optional
- Telefonie
- SIP-Trunk-Modelle ergänzen optional
enabled_codecs(EnumMediaCodec)
- SIP-Trunk-Modelle ergänzen optional
- Memory- und Code-Tools
LoadableMemoryEntryundLoadMemoryEntryToolErrorStatushinzugefügt
- Agententests
- Limits für angehängte Tests bei Anfragen zum Ausführen und erneuten Senden von 1000 auf 5000 erhöht
- JSON-Schema-Eigenschaften für Tools
- Array-Eigenschaften ergänzen optional
is_omitted
- Array-Eigenschaften ergänzen optional
Arbeitsbereiche
- Servicekonten
- API-Key-PATCH unterstützt Teilaktualisierungen mit
no_update-Sentinels
- API-Key-PATCH unterstützt Teilaktualisierungen mit
- Nutzung und Verlauf
- Nutzung nach Produkt im Zeitverlauf ergänzt optional
time_zone - Filter
sourcefür den Verlauf ergänzenFlows
- Nutzung nach Produkt im Zeitverlauf ergänzt optional
Musik
- Kompositionspläne
- Chunkbasierte
CompositionPlan,GenerationChunkundAudioRefChunkfürmusic_v2hinzugefügt - Anfrage- und Antworttexte akzeptieren
anyOf-Planformate von v1 oder v2
- Chunkbasierte
ElevenCreative Studio
- Projekt-Stimmenmodelle
project_voice_ref_idals kanonische Stimmreferenz hinzugefügt- Veraltete, schreibgeschützte Spiegelungen von
voice_idbleiben in Antworten erhalten