Vai al contenuto principale
Puoi classificare un audio vocale a partire da un file o da un URL.
Questa sezione spiega come effettuare la richiesta con un file. Con un URL il procedimento è simile: la differenza principale è l’endpoint da chiamare al passo 1.

Linee guida per l’invio

Data la grande variabilità dell’audio, ti consigliamo di seguire queste semplici linee guida:
  • Invia al sistema audio che contengono solo voce, perché i modelli di analisi al momento sono addestrati a riconoscere il parlato e non altri tipi di audio (come musica o rumore);
  • Per una maggiore accuratezza, ti consigliamo di inviare al sistema audio di durata adeguata, ad esempio di almeno 10 secondi e comunque non inferiore a 3 secondi;
  • I risultati più accurati si ottengono inviando al sistema audio puliti, evitando quindi rumori di fondo (rumore del traffico o rumori troppo forti, che potrebbero compromettere l’analisi).

Invia un audio vocale tramite l’API

Per classificare un audio vocale, effettua una richiesta POST a /api/classification_audio con i parametri richiesti (per i dettagli sui parametri consulta la sezione Riferimento API).
In risposta riceverai l’identificativo dell’audio classificato.

Analizza momenti specifici

Per impostazione predefinita l’audio viene suddiviso in segmenti analizzati lungo tutta la sua durata. Se solo alcuni momenti sono rilevanti, indicali in audio_timestamps: il sistema analizza un breve segmento audio centrato su ognuno di essi.
  • I timecode sono separati da virgole e nel formato HH:MM:SS.mmm (ore, minuti, secondi e millisecondi), misurati dall’inizio dell’audio. I duplicati vengono contati una sola volta.
  • I timecode abbastanza vicini da cadere nello stesso segmento vengono analizzati insieme in un unico segmento.
  • Viene addebitato un segmento audio per ogni timecode distinto; i segmenti non prodotti (timecode raggruppati, timecode oltre la fine dell’audio) vengono rimborsati al termine dell’analisi. Se nessun timecode cade all’interno dell’audio, la classificazione termina con un errore.
  • Puoi indicare fino a 30 timecode se il tuo piano tariffario ti permette di scegliere il numero di segmenti audio, altrimenti fino a 5.
I momenti specifici sono una funzionalità del piano tariffario: se il tuo piano non li include, audio_timestamps viene ignorato. I timecode non validi o in numero superiore al consentito vengono rifiutati con un errore 400.

Recupera i risultati

Usa l’identificativo ricevuto per recuperare i risultati della classificazione con una richiesta GET a /api/classification_audio/{identifier} (per i dettagli su come strutturare la richiesta consulta la sezione Riferimento API).
La risposta contiene i risultati della classificazione dell’audio in formato JSON. Nella risposta trovi un array results, con i risultati della classificazione di ogni modello usato, e un array verdicts, con i risultati di ogni euristica applicata.
La classificazione potrebbe non essere ancora terminata! Se non è ancora completa, continua a inviare la richiesta GET finché il risultato non è disponibile.

Linee guida per interpretare i risultati

Per interpretare i risultati, ti consigliamo di concentrarti su:
  • Phantom come risultato principale per il verdetto (la scelta predefinita della piattaforma);
  • Zebra II come risultato secondario per il verdetto;

Vedi anche

Classifica un'immagine

Scopri come avviare la classificazione di un’immagine e capire se è autentica o generata artificialmente

Classifica un video

Scopri come avviare la classificazione di un video e capire se è autentico o generato artificialmente