API de Detección de Audio Generado por IA

1. Obtener una URL de Carga Pre-firmada

Comience solicitando una URL pre-firmada de la API. Esta URL le permite cargar de forma segura su archivo de audio al servidor de almacenamiento.

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

Ejemplo de Solicitud

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

Ejemplo de Respuesta

{
  "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. Cargar el Audio

Use la 'presigned_url' proporcionada para cargar su audio mediante una solicitud PUT. Asegúrese de que el tipo de contenido correcto esté configurado según el formato de su audio.

Ejemplo de Solicitud

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

Asegúrese de que el formato del archivo permanezca consistente durante el proceso de carga. Una carga exitosa devolverá un código de estado de 200.

3. Enviar Audio para Detección de IA

Después de cargar, envíe el audio para detección de IA haciendo referencia al 'file_path' del paso anterior.

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

Ejemplo de Solicitud

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

El 'FILE_PATH' se refiere a la ruta obtenida de la respuesta en el paso inicial, 'Obtener una URL de Carga Pre-firmada'.

Ejemplo de Respuesta

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

La respuesta incluye un ID único para rastrear el estado de la detección.

"Verificación de usuario fallida" (403)

Causa: Clave de API inválida o expirada

Solución:

1. Verifique que su clave de API sea correcta
2. Verifique si su clave de API está activa en su cuenta
3. Intente regenerar su clave de API

"No hay créditos suficientes" (403)

Causa: Créditos insuficientes para procesamiento de audio

Solución:

1. Verifique sus créditos restantes usando /check-user-credits
2. Compre créditos adicionales si es necesario
3. Use analyzeUpToSeconds para analizar menos audio y consumir menos créditos

"Formato de archivo no soportado" (400)

Causa: Formato de audio no soportado o inválido enviado

Solución:

1. Verifique que el formato de audio sea soportado (MP3, WAV, M4A, FLAC, OGG, MP4)
2. Asegúrese de que el archivo no esté corrupto
3. Verifique el encabezado Content-Type al cargar

"Archivo demasiado grande" (400)

Causa: El tamaño del archivo excede el límite de 100MB

Solución:

1. Comprima o convierta el audio a menos de 100MB
2. Verifique el tamaño del archivo antes de cargar
3. Use formatos más eficientes como MP3 cuando sea posible

"El procesamiento de audio tardó demasiado tiempo"

Causa: El procesamiento del audio tardó demasiado tiempo o ocurrió un timeout

Solución:

1. Intente con un archivo de audio más pequeño o menor duración
2. Use analyzeUpToSeconds para analizar solo los primeros segundos
3. Verifique si el servicio está experimentando alta carga
4. Vuelva a intentar la solicitud después de unos minutos

Estado "fallido" en la respuesta de /query

Causa: El procesamiento falló por varias razones

Solución:

1. Verifique si el audio cumple con los requisitos mínimos (1KB - 100MB)
2. Verifique que el audio esté en un formato soportado
3. Verifique que la carga se completó exitosamente antes de enviar para detección
4. Contacte al soporte si el problema persiste

"Fallo en la carga del audio" (403/400)

Causa: URL pre-firmada inválida o expirada, o problemas con el servidor de almacenamiento

Solución:

1. Asegúrese de usar la URL pre-firmada inmediatamente después de recibirla (puede expirar)
2. Verifique que el encabezado Content-Type sea correcto para el formato de audio
3. Elimine espacios del nombre del archivo antes de cargar
4. Intente generar una nueva URL pre-firmada si la actual expiró

"URL pre-firmada inválida" (400)

Causa: Nombre de archivo con espacios o URL pre-firmada expirada/corrupta

Solución:

1. Elimine todos los espacios del nombre del archivo antes de solicitar la URL pre-firmada
2. Use solo caracteres alfanuméricos, guiones y guiones bajos en el nombre del archivo
3. Genere una nueva URL pre-firmada si es necesario