KI-Audioerkennungs-API

1. Eine vorsignierte Upload-URL abrufen

Beginnen Sie damit, eine vorsignierte URL von der API anzufordern. Diese URL ermöglicht es Ihnen, Ihre Audiodatei sicher auf den Speicherserver hochzuladen.

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

Beispielanfrage

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

Beispielantwort

{
  "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. Das Audio hochladen

Verwenden Sie die bereitgestellte 'presigned_url', um Ihr Audio über eine PUT-Anfrage hochzuladen. Stellen Sie sicher, dass der richtige Inhaltstyp entsprechend Ihrem Audioformat festgelegt ist.

Beispielanfrage

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

Stellen Sie sicher, dass das Dateiformat während des Upload-Prozesses konsistent bleibt. Ein erfolgreicher Upload gibt einen Statuscode von 200 zurück.

3. Audio zur KI-Erkennung einreichen

Nach dem Hochladen reichen Sie das Audio zur KI-Erkennung ein, indem Sie auf den 'file_path' aus dem vorherigen Schritt verweisen.

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

Beispielanfrage

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

Der 'FILE_PATH' bezieht sich auf den Pfad, der aus der Antwort im ersten Schritt 'Eine vorsignierte Upload-URL abrufen' erhalten wurde.

Beispielantwort

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

Die Antwort enthält eine eindeutige ID zur Verfolgung des Erkennungsstatus.

"Benutzerüberprüfung fehlgeschlagen" (403)

Ursache: Ungültiger oder abgelaufener API-Schlüssel

Lösung:

1. Überprüfen Sie, ob Ihr API-Schlüssel korrekt ist
2. Überprüfen Sie, ob Ihr API-Schlüssel in Ihrem Konto aktiv ist
3. Versuchen Sie, Ihren API-Schlüssel neu zu generieren

"Nicht genügend Guthaben" (403)

Ursache: Unzureichendes Guthaben für die Audioverarbeitung

Lösung:

1. Überprüfen Sie Ihr verbleibendes Guthaben mit /check-user-credits
2. Kaufen Sie bei Bedarf zusätzliches Guthaben
3. Verwenden Sie analyzeUpToSeconds, um weniger Audio zu analysieren und weniger Guthaben zu verbrauchen

"Nicht unterstütztes Dateiformat" (400)

Ursache: Nicht unterstütztes oder ungültiges Audioformat eingereicht

Lösung:

1. Überprüfen Sie, ob das Audioformat unterstützt wird (MP3, WAV, M4A, FLAC, OGG, MP4)
2. Stellen Sie sicher, dass die Datei nicht beschädigt ist
3. Überprüfen Sie den Content-Type-Header beim Hochladen

"Datei zu groß" (400)

Ursache: Dateigröße überschreitet das 100MB-Limit

Lösung:

1. Komprimieren oder konvertieren Sie das Audio auf unter 100MB
2. Überprüfen Sie die Dateigröße vor dem Hochladen
3. Verwenden Sie nach Möglichkeit effizientere Formate wie MP3

"Audio-Verarbeitung hat zu lange gedauert"

Ursache: Die Audio-Verarbeitung hat zu lange gedauert oder es ist ein Timeout aufgetreten

Lösung:

1. Versuchen Sie es mit einer kleineren Audiodatei oder kürzeren Dauer
2. Verwenden Sie analyzeUpToSeconds, um nur die ersten Sekunden zu analysieren
3. Überprüfen Sie, ob der Dienst eine hohe Last erfährt
4. Wiederholen Sie die Anfrage nach einigen Minuten

Status "fehlgeschlagen" in /query-Antwort

Ursache: Die Verarbeitung ist aus verschiedenen Gründen fehlgeschlagen

Lösung:

1. Überprüfen Sie, ob das Audio die Mindestanforderungen erfüllt (1KB - 100MB)
2. Überprüfen Sie, ob das Audio in einem unterstützten Format vorliegt
3. Überprüfen Sie, ob der Upload erfolgreich abgeschlossen wurde, bevor Sie zur Erkennung einreichen
4. Kontaktieren Sie den Support, wenn das Problem weiterhin besteht

"Audio-Upload fehlgeschlagen" (403/400)

Ursache: Ungültige oder abgelaufene vorsignierte URL oder Probleme mit dem Speicherserver

Lösung:

1. Stellen Sie sicher, dass Sie die vorsignierte URL sofort nach Erhalt verwenden (kann ablaufen)
2. Überprüfen Sie, ob der Content-Type-Header für das Audioformat korrekt ist
3. Entfernen Sie Leerzeichen aus dem Dateinamen vor dem Hochladen
4. Versuchen Sie, eine neue vorsignierte URL zu generieren, wenn die aktuelle abgelaufen ist

"Ungültige vorsignierte URL" (400)

Ursache: Dateiname mit Leerzeichen oder abgelaufene/beschädigte vorsignierte URL

Lösung:

1. Entfernen Sie alle Leerzeichen aus dem Dateinamen, bevor Sie die vorsignierte URL anfordern
2. Verwenden Sie nur alphanumerische Zeichen, Bindestriche und Unterstriche im Dateinamen
3. Generieren Sie bei Bedarf eine neue vorsignierte URL