API di Rilevamento Audio AI

1. Ottieni un URL di Upload Pre-signed

Inizia richiedendo un URL pre-signed dall'API. Questo URL ti permette di caricare in modo sicuro il tuo file audio sul server di archiviazione.

GET https://detect-audio.truthscan.com/get-presigned-url?file_name=example.mp3

Richiesta di Esempio

curl -X GET 'https://detect-audio.truthscan.com/get-presigned-url?file_name=example.mp3' \
--header 'apikey: YOUR API KEY GOES HERE'

Risposta di Esempio

{
  "status": "success",
  "presigned_url": "https://audio-presigned-upload.ai-assets-cdn.com?file_name=581d47c7-3ef4-42af-88d9-6dab6bf69389_20250611-121955_example.mp3...",
  "file_path": "/uploads/581d47c7-3ef4-42af-88d9-6dab6bf69389_20250901-090201_example.mp3"
}

2. Carica l'Audio

Usa il 'presigned_url' fornito per caricare il tuo audio tramite una richiesta PUT. Assicurati che il tipo di contenuto corretto sia impostato in base al tuo formato audio.

Richiesta di Esempio

curl -X PUT 'https://audio-presigned-upload.ai-assets-cdn.com?file_name=581d47c7-3ef4-42af-88d9-6dab6bf69389_20250611-121955_example.mp3...' \
  --header 'Content-Type: audio/<FILE_FORMAT - mp3, wav, m4a, flac, ogg, mp4>' \
  --header 'x-amz-acl: private' \
  --data-binary '@example.mp3' # Attachment

Assicurati che il formato del file rimanga coerente durante il processo di upload. Un upload riuscito restituirà un codice di stato 200.

3. Invia Audio per Rilevamento AI

Dopo il caricamento, invia l'audio per il rilevamento AI facendo riferimento al 'file_path' dal passaggio precedente.

POST https://detect-audio.truthscan.com/detect

Richiesta di Esempio

curl -X 'POST' \
  'https://detect-audio.truthscan.com/detect' \
  -H 'accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "key": "YOUR-API-KEY-GOES-HERE",
  "url": "<FILE_PATH>",
  "document_type": "Audio",
  "analyzeUpToSeconds": 60
}'

Il 'FILE_PATH' si riferisce al percorso ottenuto dalla risposta nel passaggio iniziale, 'Ottieni un URL di Upload Pre-signed'.

Risposta di Esempio

{
    "id": "77565038-9e3d-4e6a-8c80-e20785be5ee9",
    "status": "pending"
}

La risposta include un ID unico per tracciare lo stato del rilevamento.

"User verification failed" (403)

Causa: Chiave API non valida o scaduta

Soluzione:

1. Verifica che la tua chiave API sia corretta
2. Controlla se la tua chiave API è attiva nel tuo account
3. Prova a rigenerare la tua chiave API

"Not enough credits" (403)

Causa: Crediti insufficienti per l'elaborazione audio

Soluzione:

1. Controlla i tuoi crediti rimanenti usando /check-user-credits
2. Acquista crediti aggiuntivi se necessario
3. Usa analyzeUpToSeconds per analizzare meno audio e consumare meno crediti

"Unsupported file format" (400)

Causa: Formato audio non supportato o invalido inviato

Soluzione:

1. Verifica che il formato audio sia supportato (MP3, WAV, M4A, FLAC, OGG, MP4)
2. Assicurati che il file non sia corrotto
3. Controlla che l'header Content-Type sia corretto quando carichi

"File too large" (400)

Causa: La dimensione del file supera il limite di 100MB

Soluzione:

1. Comprimi o converti l'audio a meno di 100MB
2. Controlla la dimensione del file prima di caricare
3. Usa formati più efficienti come MP3 quando possibile

"Audio processing took too long"

Causa: L'elaborazione audio ha richiesto troppo tempo o si è verificato un timeout

Soluzione:

1. Prova con un file audio più piccolo o durata più breve
2. Usa analyzeUpToSeconds per analizzare solo i primi secondi
3. Controlla se il servizio sta sperimentando alto carico
4. Riprova la richiesta dopo alcuni minuti

Stato "failed" nella risposta /query

Causa: Elaborazione fallita per vari motivi

Soluzione:

1. Controlla se l'audio soddisfa i requisiti minimi (1KB - 100MB)
2. Verifica che l'audio sia in un formato supportato
3. Verifica che l'upload sia completato con successo prima di inviare per il rilevamento
4. Contatta il supporto se il problema persiste

"Audio upload failed" (403/400)

Causa: URL pre-signed non valido o scaduto, o problemi con il server di archiviazione

Soluzione:

1. Assicurati di usare l'URL pre-signed immediatamente dopo averlo ricevuto (può scadere)
2. Verifica che l'header Content-Type sia corretto per il formato audio
3. Rimuovi gli spazi dal nome del file prima di caricare
4. Prova a generare un nuovo URL pre-signed se quello corrente è scaduto

"Invalid pre-signed URL" (400)

Causa: Nome file con spazi o URL pre-signed scaduto/corrotto

Soluzione:

1. Rimuovi tutti gli spazi dal nome del file prima di richiedere l'URL pre-signed
2. Usa solo caratteri alfanumerici, trattini e underscore nel nome del file
3. Genera un nuovo URL pre-signed se necessario