요청에 대한 API 오류 목록

이 페이지는 서비스에서 반환될 수 있는 예외 메시지에 대한 포괄적인 개요를 제공합니다. 이러한 예외 메시지는 요청 또는 작업 유형에 따라 분류되며, 스크립트 없는 요청(Unscripted Requests), 스크립트 기반 요청(Scripted Requests), 특정 인증(Authentication) 또는 오디오 처리(Audio Processing) 오류 등 서비스 사용 중 발생할 수 있는 잠재적인 문제에 대한 상세한 정보를 제공합니다.

각 오류는 다음 항목과 함께 나열됩니다:

• 이름(Name): 예외의 이름.
• 메시지(Message): 시스템에서 반환되는 상세 오류 메시지.
• 매개변수(Parameters): 오류에 필요한 추가 정보 또는 컨텍스트.
• 설명(Description): 오류가 발생하는 시점과 이유에 대한 간략한 설명.

이 목록을 참조하여 API와 상호작용할 때 발생할 수 있는 잠재적인 문제를 이해하고, 디버그하며, 효과적으로 처리하세요.

스크립트 없는 요청​

스크립트 없는 요청은 API가 사전 정의된 스크립트나 워크플로에 의존하지 않고 동적으로 입력을 처리하는 실시간 또는 비동기 작업을 포함합니다. 이러한 요청은 라이브 오디오 처리, 임시 ASR(자동 음성 인식) 작업 또는 기타 동적 상호작용과 같은 시나리오에 주로 사용됩니다.

ASR 예외​

예외

메시지

매개변수

설명

ASRInterProcessException

exception in ASR: {error}

error (str): 오류의 세부 정보.

ASR 시스템에서 프로세스 간 예외가 발생했을 때 발생합니다.

ASRSocketTimeout

ASR timeout

None

ASR 시스템이 처리 중 시간 초과될 때 발생합니다.

ASRConnectionFailed

ASR Connection Failed

None

ASR 시스템에 대한 연결이 실패했을 때 발생합니다.

오디오 예외​

예외

메시지

매개변수

설명

FailedToReadAudioFromURL

Failed to read audio from the URL

None

서버가 제공된 URL에서 오디오를 읽을 수 없을 때 발생합니다.

FailedToParseAudioHeader

Failed to parse audio header

None

오디오 헤더를 파싱할 수 없을 때 발생합니다.

InvalidAudioFormat

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

None

제공된 오디오 형식이 유효하지 않을 때 발생합니다.

FailedToConvertAudio

The server failed to parse your {audio_format} audio

audio_format (str): 변환에 실패한 오디오의 형식.

서버가 제공된 오디오 형식을 변환하지 못했을 때 발생합니다.

FailedToDecodeAudioFromBytes

Failed to decode audio

None

서버가 바이트에서 오디오 데이터를 디코딩하지 못했을 때 발생합니다.

MissingAudioParam

Missing audio param!

None

필수 audio 매개변수가 누락되었을 때 발생합니다.

AudioTooBigForSync

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

stream_dir (str): 오디오 스트림의 디렉터리 또는 위치.

제공된 오디오가 동기 처리에 비해 너무 클 때 발생합니다.

FailedToUseAudio

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

None

오디오 처리 중 예기치 않은 오류가 발생했을 때 발생합니다.

인증 예외​

예외

메시지

매개변수

설명

NoTokenProvided

No session token provided

None

세션 토큰이 제공되지 않았을 때 발생합니다.

InvalidSessionToken

Invalid session token: {token}

token (str): 유효하지 않은 세션 토큰.

유효하지 않은 세션 토큰이 제공되었을 때 발생합니다.

UserDoesNotExist

Could not find {user_type} ID

user_type (str): 사용자 ID의 유형.

지정된 사용자가 존재하지 않을 때 발생합니다.

ClientIsNotActive

Client with {user_id} is not active

user_id (str): 사용자 ID.

지정된 클라이언트가 활성 상태가 아닐 때 발생합니다.

ClientDoesNotHaveAccess

User {user_id} does not have access for this API

user_id (str): 사용자 ID.

지정된 클라이언트가 API에 대한 접근 권한이 없을 때 발생합니다.

ClientHasNoMoreMinutes

User has no remaining minutes

None

사용자의 API 사용 가능 시간(분)이 남아 있지 않을 때 발생합니다.

스크립트 기반 요청​

스크립트 기반 요청은 특정 순서나 스크립트를 따르는 사전 정의된 워크플로 또는 작업을 포함합니다. 이러한 요청은 미리 정해진 스크립트를 기반으로 오디오를 처리하거나, 자동화된 작업을 실행하거나, 구조화된 워크플로를 처리하는 것과 같이 입력과 예상 출력이 명확하게 정의된 시나리오에 주로 사용됩니다.

오디오 예외​

예외

메시지

매개변수

설명

MissingAudioParam

Missing audio param!

None

필수 audio 매개변수가 누락되었을 때 발생합니다.

FailedToReadAudioFromURL

Failed to read audio from the URL

None

서버가 제공된 URL에서 오디오를 읽을 수 없을 때 발생합니다.

FailedToConvertAudio

The server failed to parse your {audio_format} audio

audio_format (str): 변환에 실패한 오디오의 형식.

서버가 제공된 오디오 형식을 변환하지 못했을 때 발생합니다.

FailedToUseAudio

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

None

오디오 처리 중 예기치 않은 오류가 발생했을 때 발생합니다.

인증 예외​

예외

메시지

매개변수

설명

NoTokenProvided

No session token provided

None

세션 토큰이 제공되지 않았을 때 발생합니다.

ClientIsNotActive

Client with {user_id} is not active

user_id (str): 사용자 ID.

지정된 클라이언트가 활성 상태가 아닐 때 발생합니다.

ClientDoesNotHaveAccess

User {user_id} does not have access for this API

user_id (str): 사용자 ID.

지정된 클라이언트가 API에 대한 접근 권한이 없을 때 발생합니다.

UserDoesNotExist

Could not find {user_type} ID

user_type (str): 사용자 ID의 유형.

지정된 사용자가 존재하지 않을 때 발생합니다.

InvalidHeaderParameter

A valid authorization header is required

None

인증 헤더가 유효하지 않거나 누락되었을 때 발생합니다.