Vai al contenuto principale
Classifica un audio vocale da URL

Autorizzazioni

X-Api-Key
string
header
obbligatorio

La tua API key.

Intestazioni

Accept
enum<string>

Tipo di contenuto della risposta. Valori supportati: application/json, text/plain.

Opzioni disponibili:
application/json,
text/plain

Corpo

multipart/form-data
file_url
string
obbligatorio

L'URL dell'audio vocale da classificare.

ref_id
string

ID di riferimento facoltativo da associare alla richiesta di classificazione.

webhook_url
string

Se indicato, il risultato della classificazione viene inviato automaticamente anche all'URL inserito. Altrimenti il risultato si ottiene tramite polling dell'endpoint relativo. Tieni presente che per usare un URL di callback del webhook devi richiedere un'abilitazione specifica, altrimenti il parametro viene ignorato. Inoltre il sistema può mettere in cache i risultati delle analisi di invii ripetuti, cioè invii dello stesso file con le stesse opzioni: in questo caso il webhook non viene chiamato e i risultati sono accessibili solo tramite polling dell'endpoint relativo.

deferred_webhook_url
string

Se indicato, l'URL viene notificato una sola volta quando i risultati differiti dell'invio sono completi (ad es. le spiegazioni testuali delle mappe XAI e della heatmap), dopo i risultati principali inviati a webhook_url. La notifica contiene l'evento submission.deferred.completed: consulta Risultati differiti per il payload. Valgono la stessa abilitazione, le stesse restrizioni di dominio e la stessa autenticazione di webhook_url. La consegna è at least once: deduplica per identifier, e tieni presente che una notifica expired può essere seguita da una seconda con l'esito reale, che la sostituisce. Se omesso o vuoto, non viene inviata alcuna notifica dei risultati differiti.

no_cache
boolean

Impostalo a true per obbligare il sistema a rielaborare l'immagine anche se è già stata inviata con le stesse opzioni. Questo può comportare costi aggiuntivi.

audio_timestamps
string

[Funzionalità del piano] Momenti specifici dell'audio vocale da analizzare. Elenco di timecode separati da virgole nel formato HH:MM:SS.mmm, misurati dall'inizio del file (ad es. 00:00:05.000,00:01:12.500). Quando è presente, invece di suddividere l'audio in segmenti lungo tutta la sua durata, il sistema analizza un breve segmento audio centrato su ogni momento indicato; i momenti abbastanza vicini da cadere nello stesso segmento vengono analizzati insieme in un unico segmento. I momenti duplicati vengono contati una sola volta. Puoi indicare fino a 30 momenti se il tuo piano tariffario ti permette di scegliere il numero di segmenti audio, altrimenti fino a 5. Viene addebitato un segmento audio per ogni momento distinto: i segmenti non prodotti (momenti raggruppati, momenti oltre la fine dell'audio) vengono rimborsati al termine dell'analisi. Se nessun momento cade all'interno dell'audio, la classificazione termina con un errore. Per usare questa opzione deve essere abilitata nel tuo piano tariffario, altrimenti il parametro viene ignorato.

Esempio:

"00:00:05.000,00:01:12.500"

Risposta

L'identificativo della classificazione. Il formato dipende dall'header Accept.

identifier
string
Esempio:

"8d64370a87b820cc1cf620338f5c898bab37439c9a405f32d9eaffc50c4f27b0"