Come attivare il riconoscimento dei parlanti via API
Nel corpo JSON imposta diarize su true. Per un file, passa la stessa opzione come campo del form. La guida a diarize mostra le combinazioni ammesse con source.
Attivalo quando ti serve sapere chi parla: in un’intervista, un confronto o una puntata con ospiti. Per una nota vocale con una sola voce spesso bastano testo e timestamp. Le etichette distinguono i turni nell’audio, ma non identificano una persona, un account o una voce da autenticare.
Scegli diarize quando crei il lavoro, perché cambia il modo in cui elaboriamo la registrazione. Non è un formato da aggiungere dopo. Con source=auto passiamo allo speech-to-text; i file caricati lo usano già, quindi l’esempio non dipende dai sottotitoli di una piattaforma.
curl -X POST "https://api.transcript1.com/v1/transcriptions?wait=60" \
-H "Authorization: Bearer $TRANSCRIPT1_API_KEY" \
-F [email protected] \
-F diarize=trueCollega ogni segmento alla voce corretta
transcript.speakers elenca le etichette e ogni segmento ha il proprio campo speaker. transcript_source vale speech_to_text, perché i sottotitoli non contengono queste informazioni. Consulta lo schema della risposta per usarle nella tua app.
Ascolta la registrazione prima di associare Speaker 1 e Speaker 2 ai nomi. Conserva questa corrispondenza nella tua app o nella copia rivista. Le etichette valgono per quella trascrizione: Speaker 1 in un altro file può essere una persona diversa.
Usa speaker per presentare la conversazione e include=words se ti servono tempi più precisi. Conserva sempre inizio e fine dei segmenti in secondi per tornare all’audio durante la revisione. Il JSON qui sotto è illustrativo, non descrive una specifica registrazione caricata.
{
"status": "completed",
"transcript_source": "speech_to_text",
"transcript": {
"speakers": ["Speaker 1", "Speaker 2"],
"segments": [
{ "start": 0, "end": 3.4, "speaker": "Speaker 1", "language": "en", "text": "Good morning." },
{ "start": 3.4, "end": 7.9, "speaker": "Speaker 2", "language": "en", "text": "Thanks for having me." }
]
}
}Scegli come mostrare chi parla nei sottotitoli
format=srt aggiunge il prefisso Speaker 1: al testo; format=vtt usa un tag voce. Con format=text ricevi una riga con etichetta per segmento. Confronta i formati dei sottotitoli prima di integrarli nel player.
Controlla come il player visualizza i tag voce e come l’editor gestisce i prefissi. Un’etichetta utile per analizzare un’intervista può diventare ripetitiva nei sottotitoli. Modifica la presentazione nel file esportato o nella tua app, mantenendo la corrispondenza verificata con le etichette originali.
Voci sovrapposte, un microfono lontano o la musica possono rendere incerti parole e cambi di parlante. Riascolta i punti in cui l’etichetta cambia senza un motivo evidente. Per le prossime registrazioni, microfoni separati e turni chiari aiutano più di una correzione successiva.
WEBVTT
00:00:00.000 --> 00:00:03.400
<v Speaker 1>Good morning.
00:00:03.400 --> 00:00:07.900
<v Speaker 2>Thanks for having me.Prima di attribuire una citazione, riascoltala
Parti da uno scambio chiaro all’inizio: riconosci le voci e annota a chi corrisponde ogni etichetta. Controlla anche alcuni passaggi successivi. Se dall’audio non capisci chi parla, conserva il dubbio nella copia rivista, senza assegnare un nome solo dal contesto.
Nelle interviste di ricerca, usa lo stesso criterio di revisione per ogni sessione e tieni separate le annotazioni dal parlato. Prima di pubblicare una citazione con nome e cognome, verifica l’attribuzione ascoltando l’audio e usando il contesto che hai a disposizione.
La diarizzazione audio organizza una conversazione. Non è un sistema biometrico e non serve ad autenticare una chiamata o a stabilire che due registrazioni contengano la stessa persona. Anche un cambio di microfono può far sembrare diversa una voce; quando più persone parlano insieme, l’attribuzione può restare incerta.
| Cosa noti durante la revisione | Cosa fare |
|---|---|
| L’etichetta cambia mentre parla la stessa persona | Riascolta prima e dopo il cambio, poi correggi la tua copia se necessario. |
| Più persone parlano insieme | Controlla parole e attribuzione. Segnala i dubbi che l’audio non permette di risolvere. |
| La stessa etichetta compare in un altro file | Associa di nuovo le etichette ai partecipanti di quella registrazione. |