> 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 Speech Engine

ElevenLabs Speech Engine aggiunge la voce in tempo reale al tuo agente chat o LLM. ElevenLabs gestisce speech-to-text, gestione dei turni, text-to-speech e riproduzione nel browser, mentre il tuo server gestisce la logica dell'agente e trasmette il testo della risposta tramite un WebSocket di Speech Engine. Usalo quando vuoi aggiungere la voce a un runtime personalizzato anziché a una configurazione ElevenAgents completamente fornita.

<CardGroup cols={3}>
  <Card
    title="Guida rapida"
    icon="duotone code"
    href="/docs/it/eleven-api/guides/cookbooks/speech-engine"
  >
    Crea in pochi minuti un agente con funzionalità vocali usando l'SDK di Speech Engine.
  </Card>
  <Card
    title="Skill dell'agente"
    icon="duotone sparkles"
    href="https://github.com/elevenlabs/skills/blob/main/speech-engine/SKILL.md"
  >
    Indicazioni per gli assistenti di coding IA che integrano Speech Engine.
  </Card>
  <Card
    title="Riferimento API"
    icon="duotone book"
    href="/docs/it/api-reference/speech-engine/create"
  >
    Crea, aggiorna e gestisci le risorse di Speech Engine tramite l'API REST.
  </Card>
</CardGroup>

### ElevenAgents

- **Override del comportamento del testo**: Aggiunto `text_behavior_overrides`, una mappa per `ConversationInitiationSource` di oggetti `BehaviorOverride` con campi facoltativi `verbosity`, `output_format` e `interaction_budget` per il comportamento dell'agente specifico per canale.
- **Fonti di integrazione**: Aggiunti Intercom, Telegram e Freshdesk.
- **Tracce di conversazione OTLP**: [Ottieni i dettagli della conversazione](/docs/it/api-reference/conversations/get) ora accetta un parametro query `format` facoltativo. Imposta `format=otlp_traces` per restituire dati di traccia compatibili con OTLP insieme al payload standard della conversazione.
- **Override delle keyword ASR**: Aggiunti gli schemi `ASRConversationalConfigOverride` e `ASRConversationalConfigOverrideConfig` con array `keywords` facoltativi, integrati nei modelli di override client della configurazione delle conversazioni.
- **Metadati di autenticazione webhook**: Gli schemi di configurazione degli strumenti webhook ora espongono `auth_resolved_params` facoltativo (array di stringhe), che documenta i segnaposto URL risolti dalla connessione di autenticazione.

### Musica

- **Modalità di generazione**: Aggiunti `MusicGenerationMode` (`track`, `loop`, `ambience`) e un campo `generation_mode` facoltativo nei body delle richieste di prompt musicali.
- **Modello da video a musica**: [Da video a musica](/docs/it/api-reference/music/video-to-music) (`POST /v1/music/video-to-music`) ora accetta `model_id` facoltativo (stringa, valore predefinito `music_v1`).

### ElevenCreative Studio

- **Crediti di conversione**: I modelli di risposta per le statistiche di conversione di capitoli e voci ora includono `credits_needed_to_convert` facoltativo (numero intero), che indica i crediti richiesti prima della conversione.

### Workspace

- **Tipi di risorsa**: Aggiunto `studio_projects` a `WorkspaceResourceType`.

### Release SDK

#### SDK Python

- [v2.50.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.50.0) - Rigenerato l'SDK per lo schema API del 25 maggio 2026.
- [v2.49.1](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.49.1) - Aggiornate le chiamate API di Speech Engine affinché restituiscano l'oggetto risposta completo.
- [v2.49.0](https://github.com/elevenlabs/elevenlabs-python/releases/tag/v2.49.0) - Rigenerato l'SDK per lo schema API dal 18 al 25 maggio 2026, inclusi gli override del comportamento del testo di ElevenAgents, `generation_mode` per la musica e `studio_projects` per il workspace.

#### SDK JavaScript

- [v2.50.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.50.0) - Aggiunti metodi e test mancanti per l'API Music e rigenerato l'SDK per lo schema API del 25 maggio 2026.
- [v2.49.1](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.49.1) - Aggiornate le chiamate API di Speech Engine affinché restituiscano l'oggetto risposta completo.
- [v2.49.0](https://github.com/elevenlabs/elevenlabs-js/releases/tag/v2.49.0) - Rigenerato l'SDK per lo schema API dal 18 al 25 maggio 2026, inclusi gli override del comportamento del testo di ElevenAgents, `generation_mode` per la musica e `studio_projects` per il workspace.

#### Pacchetti

- [@elevenlabs/client@1.8.1](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fclient%401.8.1) - Corretto un problema per cui Safari su iOS perdeva il primo messaggio dell'agente nelle sessioni vocali WebSocket, sbloccando un `AudioContext` al primo gesto dell'utente e inizializzando il grafo di riproduzione dopo il caricamento dell'audio worklet.
- [@elevenlabs/convai-widget-core@0.12.8](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.12.8) e [@elevenlabs/convai-widget-embed@0.12.8](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.12.8) - Applicati stili ai tag di emozione e audio nelle trascrizioni vocali quando `strip_audio_tags` è disattivato e considerati `terms_html` o `terms_text` null al livello superiore come un interruttore di disattivazione per la modale di termini e condizioni.
- [@elevenlabs/convai-widget-core@0.12.7](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-core%400.12.7) e [@elevenlabs/convai-widget-embed@0.12.7](https://github.com/elevenlabs/packages/releases/tag/%40elevenlabs%2Fconvai-widget-embed%400.12.7) - Aggiornate le dipendenze del widget a `@elevenlabs/client@1.8.1`.

### API

<Accordion title="Visualizza le modifiche API">

## Endpoint e schemi aggiornati

### ElevenAgents

- [Ottieni i dettagli della conversazione](/docs/it/api-reference/conversations/get) - `GET /v1/convai/conversations/{conversation_id}`
  - Aggiunto il parametro query `format` facoltativo; `otlp_traces` restituisce dati di traccia compatibili con OTLP
- Schemi di configurazione dell'agente
  - Aggiunta la mappa `text_behavior_overrides`, indicizzata da `ConversationInitiationSource`, con valori `BehaviorOverride` (`verbosity`, `output_format`, `interaction_budget`)
- Enum `ConversationInitiationSource`
  - Aggiunti `intercom_integration`, `telegram_integration` e `freshdesk_integration`
- Schemi di override ASR
  - Aggiunti `ASRConversationalConfigOverride` e `ASRConversationalConfigOverrideConfig` con `keywords` facoltativo (array di stringhe)
- Schemi degli strumenti webhook
  - Aggiunto `auth_resolved_params` facoltativo (array di stringhe) nei modelli di configurazione webhook

### Musica

- [Da video a musica](/docs/it/api-reference/music/video-to-music) - `POST /v1/music/video-to-music`
  - Aggiunto `model_id` facoltativo (stringa, valore predefinito `music_v1`)
- Schemi delle richieste di prompt musicali
  - Aggiunto `generation_mode` facoltativo che fa riferimento a `MusicGenerationMode` (`track`, `loop`, `ambience`)

### ElevenCreative Studio

- Schemi delle statistiche di conversione di capitoli e voci
  - Aggiunto `credits_needed_to_convert` facoltativo (numero intero)

### Workspace

- Enum `WorkspaceResourceType`
  - Aggiunto `studio_projects`

</Accordion>