API-Fehlerliste für Anfragen

Diese Seite bietet einen umfassenden Überblick über die Ausnahmemeldungen, die vom Dienst zurückgegeben werden können. Diese Ausnahmemeldungen sind nach Art der Anfrage oder Operation kategorisiert und bieten detaillierte Einblicke in potenzielle Probleme, die bei der Nutzung des Dienstes auftreten können, wie z. B. nicht geskriptete Anfragen, geskriptete Anfragen sowie spezifische Fehler bei der Authentifizierung oder Audioverarbeitung.

Jeder Fehler ist aufgeführt mit:

• Name: Der Name der Ausnahme.
• Message: Die detaillierte Fehlermeldung, die vom System zurückgegeben wird.
• Parameters: Alle zusätzlichen Informationen oder Kontextangaben, die für den Fehler erforderlich sind.
• Description: Eine kurze Erläuterung, wann und warum der Fehler auftritt.

Verwenden Sie diese Liste als Referenz, um potenzielle Probleme bei der Interaktion mit der API zu verstehen, zu debuggen und effektiv zu behandeln.

Nicht geskriptete Anfragen​

Nicht geskriptete Anfragen umfassen Echtzeit- oder asynchrone Operationen, bei denen die API Eingaben dynamisch verarbeitet, ohne auf vordefinierte Skripte oder Workflows zurückzugreifen. Diese Anfragen werden häufig für Szenarien wie Live-Audioverarbeitung, Ad-hoc-ASR-Aufgaben (automatische Spracherkennung) oder andere dynamische Interaktionen verwendet.

ASR-Ausnahmen​

Exception

Message

Parameters

Description

ASRInterProcessException

exception in ASR: {error}

error (str): Details des Fehlers.

Wird ausgelöst, wenn im ASR-System eine Interprozessausnahme auftritt.

ASRSocketTimeout

ASR timeout

None

Wird ausgelöst, wenn das ASR-System bei der Verarbeitung eine Zeitüberschreitung aufweist.

ASRConnectionFailed

ASR Connection Failed

None

Wird ausgelöst, wenn die Verbindung zum ASR-System fehlschlägt.

Audio-Ausnahmen​

Exception

Message

Parameters

Description

FailedToReadAudioFromURL

Failed to read audio from the URL

None

Wird ausgelöst, wenn der Server die Audiodaten von der angegebenen URL nicht lesen kann.

FailedToParseAudioHeader

Failed to parse audio header

None

Wird ausgelöst, wenn der Audio-Header nicht geparst werden kann.

InvalidAudioFormat

Only 16 kHz mono WAV, FLAC or OGG-Opus audio allowed

None

Wird ausgelöst, wenn das angegebene Audioformat ungültig ist.

FailedToConvertAudio

The server failed to parse your {audio_format} audio

audio_format (str): Das Audioformat, bei dem die Konvertierung fehlgeschlagen ist.

Wird ausgelöst, wenn der Server das angegebene Audioformat nicht konvertieren kann.

FailedToDecodeAudioFromBytes

Failed to decode audio

None

Wird ausgelöst, wenn der Server Audiodaten aus Bytes nicht dekodieren kann.

MissingAudioParam

Missing audio param!

None

Wird ausgelöst, wenn der erforderliche Parameter audio fehlt.

AudioTooBigForSync

Audio is too big for sync mode, please change to async mode

stream_dir (str): Verzeichnis oder Speicherort des Audio-Streams.

Wird ausgelöst, wenn die bereitgestellten Audiodaten für die synchrone Verarbeitung zu groß sind.

FailedToUseAudio

An unexpected error occurred while processing the audio. Please check if the audio is valid and it's not corrupted.

None

Wird ausgelöst, wenn bei der Verarbeitung der Audiodaten ein unerwarteter Fehler auftritt.

Authentifizierungsausnahmen​

Exception

Message

Parameters

Description

NoTokenProvided

No session token provided

None

Wird ausgelöst, wenn kein Sitzungstoken angegeben wird.

InvalidSessionToken

Invalid session token: {token}

token (str): Das ungültige Sitzungstoken.

Wird ausgelöst, wenn ein ungültiges Sitzungstoken angegeben wird.

UserDoesNotExist

Could not find {user_type} ID

user_type (str): Der Typ der Benutzer-ID.

Wird ausgelöst, wenn der angegebene Benutzer nicht existiert.

ClientIsNotActive

Client with {user_id} is not active

user_id (str): Die Benutzer-ID.

Wird ausgelöst, wenn der angegebene Client nicht aktiv ist.

ClientDoesNotHaveAccess

User {user_id} does not have access for this API

user_id (str): Die Benutzer-ID.

Wird ausgelöst, wenn der angegebene Client keinen Zugriff auf die API hat.

ClientHasNoMoreMinutes

User has no remaining minutes

None

Wird ausgelöst, wenn der Benutzer keine verbleibenden Minuten für die API-Nutzung hat.

Geskriptete Anfragen​

Geskriptete Anfragen umfassen vordefinierte Workflows oder Operationen, die einer bestimmten Abfolge oder einem Skript folgen. Diese Anfragen werden häufig in Szenarien verwendet, bei denen Eingabe und erwartete Ausgabe klar definiert sind, beispielsweise bei der Audioverarbeitung auf Basis eines vordefinierten Skripts, der Ausführung automatisierter Aufgaben oder der Verarbeitung strukturierter Workflows.

Audio-Ausnahmen​

Exception

Message

Parameters

Description

MissingAudioParam

Missing audio param!

None

Wird ausgelöst, wenn der erforderliche Parameter audio fehlt.

FailedToReadAudioFromURL

Failed to read audio from the URL

None

Wird ausgelöst, wenn der Server die Audiodaten von der angegebenen URL nicht lesen kann.

FailedToConvertAudio

The server failed to parse your {audio_format} audio

audio_format (str): Das Audioformat, bei dem die Konvertierung fehlgeschlagen ist.

Wird ausgelöst, wenn der Server das angegebene Audioformat nicht konvertieren kann.

FailedToUseAudio

An unexpected error occurred while processing the audio. Please check if the audio is valid and it's not corrupted.

None

Wird ausgelöst, wenn bei der Verarbeitung der Audiodaten ein unerwarteter Fehler auftritt.

Authentifizierungsausnahmen​

Exception

Message

Parameters

Description

NoTokenProvided

No session token provided

None

Wird ausgelöst, wenn kein Sitzungstoken angegeben wird.

ClientIsNotActive

Client with {user_id} is not active

user_id (str): Die Benutzer-ID.

Wird ausgelöst, wenn der angegebene Client nicht aktiv ist.

ClientDoesNotHaveAccess

User {user_id} does not have access for this API

user_id (str): Die Benutzer-ID.

Wird ausgelöst, wenn der angegebene Client keinen Zugriff auf die API hat.

UserDoesNotExist

Could not find {user_type} ID

user_type (str): Der Typ der Benutzer-ID.

Wird ausgelöst, wenn der angegebene Benutzer nicht existiert.

InvalidHeaderParameter

A valid authorization header is required

None

Wird ausgelöst, wenn der Autorisierungs-Header ungültig oder nicht vorhanden ist.