메인 콘텐츠로 건너뛰기
오류가 발생하면 Venice API는 HTTP 상태 코드와 설명 메시지를 반환합니다. 일부 오류에는 환불 상태, 권장 재시도 모델, 유효성 검사 세부 정보 또는 요청 ID와 같은 추가 필드도 포함됩니다.

오류 응답 형식

대부분의 오류는 사람이 읽을 수 있는 메시지가 포함된 error 필드를 반환합니다:
일부 엔드포인트는 엔드포인트별 추가 필드를 포함합니다. 예를 들어 비디오 검열 오류에는 크레딧이 환불되었는지가 포함될 수 있습니다:
유효성 검사 오류에는 필드 수준의 유효성 검사 정보가 포함된 details 및 issues 필드가 포함될 수 있습니다:
일부 OpenAI 호환 엔드포인트는 컨텍스트 길이 오류와 같은 특정 경우에 OpenAI 스타일의 오류 객체를 반환할 수 있습니다:

자격 증명 누락

자격 증명이 없는 요청은 401이 아니라 402 Payment Required를 반환합니다. 모든 유료 라우트는 x402 지갑 인증도 허용하므로, 응답은 결제 챌린지입니다. 응답에는 PAYMENT-REQUIRED 헤더와 두 가지 인증 방법을 설명하는 본문이 포함됩니다.
API 키를 사용하려고 했다면 Authorization: Bearer 헤더가 설정되어 있는지 확인하세요. 키가 있지만 유효하지 않으면 401을 반환합니다.

요청 형식 오류

이 오류는 엔드포인트별 유효성 검사가 실행되기 전, 요청 본문을 읽는 단계에서 발생합니다. 잘못된 Content-Type은 415가 아니라 400을 반환합니다. 크기 제한으로 인한 413 응답에는 code 필드도 포함됩니다:

오류 코드

기타 오류

위 표가 모든 오류를 망라하지는 않습니다. 일부 오류는 표에 나열된 코드 없이 반환되며, 메시지는 모델과 엔드포인트에 따라 다를 수 있으므로 메시지 텍스트가 아닌 HTTP 상태를 기준으로 분기하세요. 표에 없지만 발생할 수 있는 오류는 다음과 같습니다: