API de détection audio IA

1. Obtenir une URL de téléchargement pré-signée

Commencez par demander une URL pré-signée à l'API. Cette URL vous permet de télécharger en toute sécurité votre fichier audio sur le serveur de stockage.

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

Exemple de requête

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

Exemple de réponse

{
  "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. Télécharger l'audio

Utilisez la 'presigned_url' fournie pour télécharger votre audio via une requête PUT. Assurez-vous que le type de contenu correct est défini selon votre format audio.

Exemple de requête

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

Assurez-vous que le format de fichier reste cohérent pendant le processus de téléchargement. Un téléchargement réussi renverra un code de statut 200.

3. Soumettre l'audio pour détection IA

Après le téléchargement, soumettez l'audio pour détection IA en référençant le 'file_path' de l'étape précédente.

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

Exemple de requête

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
}'

Le 'FILE_PATH' fait référence au chemin obtenu de la réponse dans l'étape initiale, 'Obtenir une URL de téléchargement pré-signée'.

Exemple de réponse

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

La réponse inclut un ID unique pour suivre le statut de détection.

"Échec de vérification utilisateur" (403)

Cause: Clé API invalide ou expirée

Solution:

1. Vérifiez que votre clé API est correcte
2. Vérifiez si votre clé API est active dans votre compte
3. Essayez de régénérer votre clé API

"Pas assez de crédits" (403)

Cause: Crédits insuffisants pour le traitement audio

Solution:

1. Vérifiez vos crédits restants en utilisant /check-user-credits
2. Achetez des crédits supplémentaires si nécessaire
3. Utilisez analyzeUpToSeconds pour analyser moins d'audio et consommer moins de crédits

"Format de fichier non supporté" (400)

Cause: Format audio non supporté ou invalide soumis

Solution:

1. Vérifiez que le format audio est supporté (MP3, WAV, M4A, FLAC, OGG, MP4)
2. Assurez-vous que le fichier n'est pas corrompu
3. Vérifiez l'en-tête Content-Type lors du téléchargement

"Fichier trop volumineux" (400)

Cause: La taille du fichier dépasse la limite de 10MB

Solution:

1. Compressez ou convertissez l'audio à moins de 10MB
2. Vérifiez la taille du fichier avant le téléchargement
3. Utilisez des formats plus efficaces comme MP3 lorsque possible

"Traitement audio trop long"

Cause: Le traitement audio a pris trop de temps ou un timeout s'est produit

Solution:

1. Essayez avec un fichier audio plus petit ou une durée plus courte
2. Utilisez analyzeUpToSeconds pour analyser uniquement les premières secondes
3. Vérifiez si le service connaît une charge élevée
4. Réessayez la requête après quelques minutes

Statut "failed" dans la réponse /query

Cause: Le traitement a échoué pour diverses raisons

Solution:

1. Vérifiez si l'audio répond aux exigences minimales (1KB - 10MB)
2. Vérifiez que l'audio est dans un format supporté
3. Vérifiez que le téléchargement s'est terminé avec succès avant de soumettre pour détection
4. Contactez le support si le problème persiste

"Échec du téléchargement audio" (403/400)

Cause: URL pré-signée invalide ou expirée, ou problèmes avec le serveur de stockage

Solution:

1. Assurez-vous d'utiliser l'URL pré-signée immédiatement après l'avoir reçue (peut expirer)
2. Vérifiez que l'en-tête Content-Type est correct pour le format audio
3. Supprimez les espaces du nom de fichier avant le téléchargement
4. Essayez de générer une nouvelle URL pré-signée si la actuelle a expiré

"URL pré-signée invalide" (400)

Cause: Nom de fichier avec espaces ou URL pré-signée expirée/corrompue

Solution:

1. Supprimez tous les espaces du nom de fichier avant de demander une URL pré-signée
2. Utilisez uniquement des caractères alphanumériques, tirets et underscores dans le nom de fichier
3. Générez une nouvelle URL pré-signée si nécessaire