> ## Documentation Index
> Fetch the complete documentation index at: https://docs.identifai.net/llms.txt
> Use this file to discover all available pages before exploring further.

# Classifica un audio vocale

> Come avviare la classificazione di un audio vocale

Puoi classificare un audio vocale a partire da un **file** o da un **URL**.
\
&#x20;Questa sezione spiega come effettuare la richiesta con un file. Con un URL il procedimento è simile: la differenza principale è l'[endpoint](https://docs.identifai.net/it/api-reference/classification/submit-speech-from-url.md) 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](https://docs.identifai.net/it/api-reference/classification/submit-a-speech-for-classification.md)).

```bash theme={null}
curl --request POST \
  --url https://backend.identifai.net/api/classification_audio \
  --header 'Content-Type: multipart/form-data' \
  --header 'X-Api-Key: <api-key>' \
  --form "audio=@/path/to/sample.mp3" 
```

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.

```bash theme={null}
curl --request POST \
  --url https://backend.identifai.net/api/classification_audio \
  --header 'Content-Type: multipart/form-data' \
  --header 'X-Api-Key: <api-key>' \
  --form "audio=@/path/to/sample.mp3" \
  --form audio_timestamps=00:00:03.000,00:00:21.500
```

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

> [!NOTE]
>
> 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`.

> [!TIP]
>
> Puoi anche [classificare un audio vocale da URL](https://docs.identifai.net/it/api-reference/classification/submit-speech-from-url.md)!

### 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](https://docs.identifai.net/it/api-reference/classification/get-classification-result-speech.md)).

```bash theme={null}
curl --request GET \
  --url https://backend.identifai.net/api/classification_audio/{identifier} \
  --header 'X-Api-Key: <api-key>'
```

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.

> [!NOTE]
>
> 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

> [card] [Classifica un'immagine](https://docs.identifai.net/it/classification/classify-image.md)
>
> Scopri come avviare la classificazione di un'immagine e capire se è autentica o generata artificialmente

> [card] [Classifica un video](https://docs.identifai.net/it/classification/classify-video.md)
>
> Scopri come avviare la classificazione di un video e capire se è autentico o generato artificialmente


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.