> 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.

### Presentazione di Music v2

Music v2 è ora disponibile tramite l'API ElevenLabs. Imposta `model_id` su `music_v2` in [Genera musica](/docs/it/api-reference/music/compose), [Trasmetti musica](/docs/it/api-reference/music/stream), [Genera musica dettagliata](/docs/it/api-reference/music/compose-detailed) e [Carica musica](/docs/it/api-reference/music/upload) per usare il nuovo modello. Music v2 introduce piani di composizione basati su chunk, creati da segmenti `GenerationChunk` e `AudioRefChunk`, offrendoti un controllo più preciso su struttura, ritmo e arrangiamento rispetto al flusso `music_v1` basato su prompt.

Usa i piani di composizione `music_v2` nelle richieste di generazione e caricamento, oppure genera prima un piano tramite l'endpoint dei piani di composizione. I body delle richieste e delle risposte accettano formati di piano v1 o v2, così puoi eseguire la migrazione endpoint per endpoint. `MusicPrompt` rimane disponibile solo per `music_v1`.

<CardGroup cols={3}>
  <Card
    title="Guida rapida"
    icon="duotone code"
    href="/docs/it/eleven-api/guides/cookbooks/music"
  >
    Genera la tua prima traccia con l'API Music in pochi minuti.
  </Card>
  <Card
    title="Piani di composizione"
    icon="duotone layer-group"
    href="/docs/it/eleven-api/guides/how-to/music/composition-plans"
  >
    Crea piani di composizione basati su chunk per tracce strutturate con più sezioni.
  </Card>
  <Card
    title="Riferimento API"
    icon="duotone book"
    href="/docs/it/api-reference/music/compose"
  >
    Componi, trasmetti e carica musica con `music_v2` tramite l'API REST.
  </Card>
</CardGroup>

- **Timestamp di caricamento**: [Carica musica](/docs/it/api-reference/music/upload) accetta `with_timestamps` facoltativo; le risposte possono includere `words_timestamps`.

### ElevenAgents

- **Esegui valutazione della conversazione**: aggiunto l'endpoint [Esegui valutazione della conversazione](/docs/it/api-reference/conversations/analysis/run-evaluation) (`POST /v1/convai/conversations/{conversation_id}/analysis/evaluations/run`) per rieseguire un singolo criterio di valutazione su una conversazione completata usando `RunConversationEvaluationsRequest`.
- **Comportamento di ingresso nel workflow**: i nodi del workflow che sovrascrivono l'agente aggiungono `entry_behavior` facoltativo (`generate_immediately`, `wait_for_user`, `auto`) per controllare se il sottoagente parla per primo o attende l'input dell'utente.
- **Strumento di sistema per terminare la procedura**: aggiunta la configurazione dello strumento di sistema `end_procedure` con stati di errore corrispondenti. Lo strumento `start_procedure` aggiunge `already_active` ai propri stati di errore.
- **Override TTS per trasferimento**: `AgentTransfer`, i nodi agente autonomi del workflow e i risultati riusciti dello strumento `transfer_to_agent` aggiungono `preserve_client_tts_overrides` facoltativo (booleano) per mantenere gli override TTS lato client dopo un trasferimento.
- **Enum del budget di interazione**: `InteractionBudget` rimuove `async` e aggiunge `5_minutes`, `10_minutes` e `1_hour`. Aggiorna tutte le configurazioni o gli enum SDK che fanno ancora riferimento a `async`.
- **Selezione del modello di guardrail personalizzato**: la configurazione dei guardrail personalizzati aggiunge `model` facoltativo con varianti Gemini, Claude e GPT. La configurazione dei guardrail aggiunge anche `history_message_count` facoltativo (intero).
- **Filtri dell'elenco di numeri telefonici**: [Elenca numeri telefonici](/docs/it/api-reference/phone-numbers/list) aggiunge i parametri query facoltativi `provider`, `agent_id` e `branch_id` per filtrare i numeri importati.
- **Filtraggio degli account WhatsApp**: [Elenca account WhatsApp](/docs/it/api-reference/whats-app/accounts/list) aggiunge il parametro query facoltativo `agent_id` per filtrare gli account in base all'agente assegnato.
- **Filtri per intervallo temporale degli argomenti**: [Ottieni argomenti delle conversazioni dell'agente](/docs/it/api-reference/conversations/topics/get) aggiunge i parametri query facoltativi `from_unix_secs` e `to_unix_secs` per delimitare i risultati del rilevamento degli argomenti.
- **Configurazione dei codec SIP**: i modelli di richiesta e risposta dei trunk SIP in uscita aggiungono `enabled_codecs` facoltativo (enum `MediaCodec`).
- **Tipi di strumenti per la memoria**: aggiunti gli schemi `LoadableMemoryEntry` e `LoadMemoryEntryToolErrorStatus` per la gestione degli errori degli strumenti per la memoria.
- **Limiti per batch di test degli agenti**: gli schemi delle richieste di collegamento, esecuzione e reinvio dei test degli agenti aumentano il massimo di test collegati da 1000 a 5000.
- **Supporto dei tag fonema**: le impostazioni TTS degli agenti aggiungono `enable_phoneme_tags` facoltativo (booleano) per la gestione opzionale dei fonemi SSML V3.
- **Override di omissione dello schema degli array**: le proprietà dello schema JSON degli array aggiungono `is_omitted` facoltativo (mutuamente esclusivo con altre origini di valore). `ConstantSchemaOverride` può usare valori costanti di tipo array.
- **Contesto degli errori di trasferimento**: i payload di errore del trasferimento a un numero possono includere `agent_message` facoltativo (stringa).

### Workspace

- **Aggiornamenti delle chiavi API degli account di servizio**: [Aggiorna chiave API dell'account di servizio](/docs/it/api-reference/service-accounts/api-keys/update) non richiede più un body della richiesta. I campi modificabili supportano aggiornamenti parziali tramite `no_update` e `name` nullable, inclusi `permissions` e `character_limit`.
- **Raggruppamento per fuso orario dell'utilizzo**: le richieste di utilizzo del workspace per prodotto nel tempo aggiungono `time_zone` facoltativo (stringa di fuso orario IANA) con regole chiarite per i bucket `interval_seconds`.
- **Filtro dell'origine della cronologia**: i filtri `source` per l'elenco e i dettagli della cronologia aggiungono `Flows`.

### ElevenCreative Studio

- **Riferimenti vocali del progetto**: i modelli dei progetti, i nodi TTS dei capitoli, gli elenchi vocali e le statistiche vocali passano a `project_voice_ref_id` come campo vocale canonico. I precedenti campi `voice_id` restano nelle risposte come mirror di sola lettura deprecati per compatibilità.

### Speech to Text

- **Diarizzazione della libreria di speaker**: [Converti parlato in testo](/docs/it/api-reference/speech-to-text/convert) aggiunge `use_speaker_library` facoltativo (booleano, valore predefinito `false`) per la diarizzazione delle trascrizioni batch.

### Voci

- **Ordinamento delle voci condivise**: il parametro query `sort` di [Elenca voci condivise](/docs/it/api-reference/voices/voice-library/get-shared) ottiene un enum esplicito, il valore predefinito `created_date` e una descrizione aggiornata.

### Release SDK

#### SDK JavaScript

- [v2.53.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.53.0) - Rigenerato dallo schema OpenAPI più recente con supporto per la riesecuzione della valutazione delle conversazioni, union dei piani di composizione Music v2, `entry_behavior` del workflow, filtri per elenchi di numeri telefonici e WhatsApp, parametri per intervalli temporali degli argomenti, aggiornamenti dello schema di avviso, campi `project_voice_ref_id` di Studio e limiti ampliati per i batch di test degli agenti.

#### SDK Python

- [v2.53.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.53.0) - Rigenerato dallo schema OpenAPI più recente con supporto per la riesecuzione della valutazione delle conversazioni, piani di composizione Music v2, comportamento di ingresso del workflow e strumenti per terminare le procedure, parametri di filtro per la telefonia, modelli di aggiornamento parziale per avvisi e account di servizio e campi di riferimento vocale di Studio.

#### Pacchetti

- [@elevenlabs/client@1.11.0](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.11.0) - Aggiunta l'esportazione del sottopath `@elevenlabs/client/internal/unity` per il bridge WebGL dell'SDK Unity, che espone `MediaDeviceInput`, `MediaDeviceOutput`, helper per il collegamento delle connessioni e tipi di adattatore WebRTC.
- [@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) e [@elevenlabs/convai-widget-embed@0.14.2](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.14.2) - Allineamento delle dipendenze a `@elevenlabs/client@1.11.1` e `@elevenlabs/types@0.14.1`.
- [@elevenlabs/types@0.14.1](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Ftypes%400.14.1) - Aggiunto `"license": "MIT"` a `package.json` per la compatibilità con license-checker.

#### SDK iOS

- [v3.2.1](https://github.com/elevenlabs/elevenlabs-swift-sdk/releases/tag/v3.2.1) - Aggiunto il supporto per la residenza dei dati a Singapore e abilitato `singlePeerConnection` per le sessioni WebRTC.

### API

<Accordion title="Visualizza modifiche API">

## Nuovi endpoint

### ElevenAgents

- [Esegui valutazione della conversazione](/docs/it/api-reference/conversations/analysis/run-evaluation) - `POST /v1/convai/conversations/{conversation_id}/analysis/evaluations/run`
  - Il body della richiesta usa `RunConversationEvaluationsRequest` per rieseguire un singolo criterio di valutazione

## Endpoint aggiornati

### ElevenAgents

- [Elenca numeri telefonici](/docs/it/api-reference/phone-numbers/list) - `GET /v1/convai/phone-numbers`
  - Aggiunti i parametri query facoltativi `provider`, `agent_id` e `branch_id`
- [Ottieni argomenti delle conversazioni dell'agente](/docs/it/api-reference/conversations/topics/get) - `GET /v1/convai/agents/{agent_id}/topics`
  - Aggiunti i parametri query facoltativi `from_unix_secs` e `to_unix_secs`
- [Elenca account WhatsApp](/docs/it/api-reference/whats-app/accounts/list) - `GET /v1/convai/whatsapp-accounts`
  - Aggiunto il parametro query facoltativo `agent_id`

### Musica

- [Genera musica](/docs/it/api-reference/music/compose), [Genera musica dettagliata](/docs/it/api-reference/music/compose-detailed), [Trasmetti musica](/docs/it/api-reference/music/stream) e [Carica musica](/docs/it/api-reference/music/upload)
  - Aggiunto `music_v2` ai valori `model_id` supportati
  - Il caricamento aggiunge `with_timestamps` facoltativo; le risposte possono includere `words_timestamps`

### Speech to Text

- [Converti parlato in testo](/docs/it/api-reference/speech-to-text/convert) - `POST /v1/speech-to-text`
  - Aggiunto il parametro query facoltativo `use_speaker_library` (booleano, valore predefinito `false`)

### Voci

- [Elenca voci condivise](/docs/it/api-reference/voices/voice-library/get-shared) - `GET /v1/shared-voices`
  - Il parametro query `sort` ora usa un enum esplicito con valore predefinito `created_date`

## Modifiche agli schemi

### ElevenAgents

- Nodi del workflow che sovrascrivono l'agente
  - Aggiunto enum `entry_behavior` facoltativo (`generate_immediately`, `wait_for_user`, `auto`)
- Strumenti di sistema
  - Aggiunta configurazione dello strumento `end_procedure` e relativi stati di errore
- Schemi di trasferimento e interazione
  - Aggiunto `preserve_client_tts_overrides` facoltativo nei trasferimenti e nei risultati degli strumenti di trasferimento
  - `InteractionBudget` rimuove `async`; aggiunge `5_minutes`, `10_minutes`, `1_hour`
- Guardrail e TTS
  - I guardrail personalizzati aggiungono `model` e `history_message_count` facoltativi
  - Le impostazioni TTS degli agenti aggiungono `enable_phoneme_tags` facoltativo
- Telefonia
  - I modelli dei trunk SIP aggiungono `enabled_codecs` facoltativo (enum `MediaCodec`)
- Strumenti per memoria e codice
  - Aggiunti `LoadableMemoryEntry` e `LoadMemoryEntryToolErrorStatus`
- Test degli agenti
  - Aumentati i limiti dei test collegati da 1000 a 5000 nelle richieste di esecuzione e reinvio
- Proprietà dello schema JSON degli strumenti
  - Le proprietà degli array aggiungono `is_omitted` facoltativo

### Workspace

- Account di servizio
  - PATCH della chiave API supporta aggiornamenti parziali con sentinelle `no_update`
- Utilizzo e cronologia
  - L'utilizzo per prodotto nel tempo aggiunge `time_zone` facoltativo
  - I filtri `source` della cronologia aggiungono `Flows`

### Musica

- Piani di composizione
  - Aggiunti `CompositionPlan`, `GenerationChunk` e `AudioRefChunk` basati su chunk per `music_v2`
  - I body delle richieste e delle risposte accettano formati di piano v1 o v2 con `anyOf`

### ElevenCreative Studio

- Modelli vocali del progetto
  - Aggiunto `project_voice_ref_id` come riferimento vocale canonico
  - I mirror `voice_id` deprecati di sola lettura vengono mantenuti nelle risposte

</Accordion>