Modifica delle trascrizioni
Guida pratica · Presuppone che tu abbia completato la guida sullo streaming lato client o sullo streaming lato server.
Panoramica
La modifica delle trascrizioni è una funzionalità sperimentale e aggiunge un sovrapprezzo del 30% al costo base della trascrizione, fatturato per almeno 10 secondi di audio per ogni trascrizione confermata. Consulta la pagina dei prezzi API per informazioni dettagliate sui prezzi.
La trascrizione realtime può applicare un’istruzione di modifica in linguaggio naturale a ogni trascrizione confermata, ad esempio per scrivere le date pronunciate in un formato fisso o espandere abbreviazioni e acronimi. L’istruzione viene passata una volta all’apertura della connessione e ogni trascrizione confermata è seguita da un evento edited_transcript separato con il testo modificato.
Le trascrizioni parziali non vengono mai modificate. Nemmeno l’evento committed_transcript viene modificato, quindi le integrazioni esistenti continuano a funzionare quando attivi la funzionalità.
La modifica delle trascrizioni non può essere combinata con entity_detection o entity_redaction. Le connessioni
che impostano entrambi vengono rifiutate con un errore invalid_request.
Abilitare la modifica delle trascrizioni
Passa l’istruzione con l’opzione transcriptEdit durante la connessione (il parametro query transcript_edit dell’API WebSocket). L’istruzione può contenere fino a 2000 caratteri. Consulta la guida alla modifica batch delle trascrizioni per indicazioni su come scrivere le istruzioni.
In tutti gli SDK, le trascrizioni modificate arrivano tramite l’evento RealtimeEvents.EDITED_TRANSCRIPT.
Lato client
Usa @elevenlabs/client nel browser con un token monouso emesso dal tuo server, come descritto nella guida allo streaming lato client.
Lato server
Usa l’SDK ufficiale sul tuo server, come descritto nella guida allo streaming lato server. Rispetto a quella guida, cambiano solo l’opzione e l’handler dell’evento; l’invio dell’audio e la chiusura della connessione funzionano allo stesso modo.
Ricevere le trascrizioni modificate
Quando è abilitata, ogni trascrizione confermata è seguita da un evento edited_transcript che contiene il testo confermato e la relativa versione modificata:
Comportamenti da tenere presenti:
- Le modifiche vengono applicate per ogni segmento confermato. L’evento
edited_transcriptviene emesso poco dopo il corrispondente eventocommitted_transcript, poiché la modifica viene eseguita in modo asincrono. Può arrivare dopo la trascrizione parziale successiva e le modifiche di segmenti consecutivi possono arrivare fuori ordine. Usa il campotextper associare una modifica alla relativa trascrizione confermata. - Se non sono state apportate modifiche a un segmento,
edited_textè identico atext. - Se non è possibile produrre una modifica per un segmento, non viene inviato alcun evento
edited_transcript. L’eventocommitted_transcriptnon viene modificato. - I timestamp a livello di parola in
committed_transcript_with_timestampsdescrivono il testo confermato originale, non quello modificato.