Venice API

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

오류 응답 형식

대부분의 오류는 사람이 읽을 수 있는 메시지가 포함된 error 필드를 반환합니다:

{
  "error": "Invalid request parameters"
}

일부 엔드포인트는 엔드포인트별 추가 필드를 포함합니다. 예를 들어 비디오 검열 오류에는 크레딧이 환불되었는지가 포함될 수 있습니다:

{
  "error": "Your generation was blocked due to the model provider's content policies. Credits have been refunded.",
  "credits_refunded": true
}

유효성 검사 오류에는 필드 수준의 유효성 검사 정보가 포함된 details 및 issues 필드가 포함될 수 있습니다:

{
  "error": "Invalid request parameters",
  "details": {
    "_errors": [],
    "field": {
      "_errors": ["Field is required"]
    }
  },
  "issues": []
}

일부 OpenAI 호환 엔드포인트는 컨텍스트 길이 오류와 같은 특정 경우에 OpenAI 스타일의 오류 객체를 반환할 수 있습니다:

{
  "error": {
    "message": "Your request exceeds the model's maximum context. Please reduce your prompt or completion length.",
    "type": "invalid_request_error",
    "param": "messages",
    "code": "context_length_exceeded"
  }
}

오류 코드

Error Code	HTTP Status	Message	Log Level
`AUTHENTICATION_FAILED`	401	Authentication failed	-
`AUTHENTICATION_FAILED_INACTIVE_KEY`	401	Authentication failed - Pro subscription is inactive. Please upgrade your subscription to continue using the API	-
`X402_INVALID_SIGN_IN`	401	Invalid Sign-in-with-x signature	-
`PRO_ONLY_MODEL`	401	This model is only available to Pro users	-
`INSUFFICIENT_BALANCE`	402	Insufficient USD or Diem balance to complete request. Visit https://venice.ai/settings/api to add credits.	-
`API_KEY_DIEM_SPEND_LIMIT_EXCEEDED`	402	API key DIEM spend limit exceeded. Your account may still have DIEM balance, but this API key has reached its configured DIEM spending limit.	-
`API_KEY_USD_SPEND_LIMIT_EXCEEDED`	402	API key USD spend limit exceeded. Your account may still have USD balance, but this API key has reached its configured USD spending limit.	-
`UNAUTHORIZED`	403	Unauthorized access	-
`API_ACCESS_DISABLED`	403	API access has been disabled for this account. Please contact support@venice.ai	-
`X402_WALLET_MISMATCH`	403	You can only access resources for your own wallet	-
`INVALID_REQUEST`	400	Invalid request parameters	-
`INVALID_MODEL`	400	Invalid model specified	-
`REQUEST_ID_NOT_FOUND`	400	Request ID is invalid.	-
`INVALID_AUDIO_FORMAT`	400	Invalid audio format. Supported formats are WAV and MP3.	-
`INVALID_VIDEO_FORMAT`	400	Invalid video format. Supported formats include MP4, MOV, WebM, MKV, AVI, and others.	-
`CORRUPTED_IMAGE`	400	The image file is corrupted or unreadable	-
`IMAGE_TOO_SMALL`	400	Image dimensions are too small	-
`TOO_MANY_TOKENS`	400	Your request exceeds the model’s maximum context. Please reduce your prompt or completion length.	-
`CHARACTER_NOT_FOUND`	404	No character could be found from the provided character_slug	-
`MODEL_NOT_FOUND`	404	Specified model not found	-
`MEDIA_NOT_FOUND`	404	Media could not be found. Request may may be invalid, expired, or deleted.	-
`PAYLOAD_TOO_LARGE`	413	The request payload is too large. Please reduce the size of your request.	-
`INVALID_CONTENT_TYPE`	415	Invalid request content-type	-
`VIDEO_DURATION_TOO_LONG`	422	Video duration exceeds the maximum allowed.	-
`VIDEO_DURATION_TOO_SHORT`	422	Video duration is too short.	-
`IMAGE_TOO_LARGE`	422	Image dimensions exceed the maximum allowed.	-
`CONTENT_POLICY_VIOLATION`	422	Your prompt violates the content policy of Venice.ai or the model provider	-
`ASR_UPSTREAM_VALIDATION_FAILED`	422	The audio could not be processed for transcription. Common causes: zero-length, silent, corrupt, or unsupported-language audio. Please verify the file and retry.	warn
`RATE_LIMIT_EXCEEDED`	429	Rate limit exceeded	-
`MODEL_OVERLOADED`	429	The model is currently overloaded. Please try again later.	-
`INFERENCE_FAILED`	500	Inference processing failed	error
`UPSCALE_FAILED`	500	Image upscaling failed	error
`IMAGE_EDIT_ERROR`	500	Image edit failed	error
`UNKNOWN_ERROR`	500	An unknown error occurred	error
`TEE_ATTESTATION_FAILED`	502	TEE attestation request failed. The Trusted Execution Environment provider may be temporarily unavailable.	error
`TEE_SIGNATURE_FAILED`	502	TEE signature request failed. The Trusted Execution Environment provider may be temporarily unavailable.	error
`ASR_UPSTREAM_FAILED`	502	Audio transcription failed due to a temporary upstream error. Please retry.	warn
`MODEL_OFFLINE`	503	The model is temporarily offline. Please try again later.	-
`MODEL_AT_CAPACITY`	503	The model is at capacity. Please try again later.	-
`REQUEST_TIMEOUT`	504	The request took too long to complete and was timed-out. For long-running inference requests, use the streaming API by setting `stream=true` in your request.	-

​오류 응답 형식

​오류 코드

오류 응답 형식

오류 코드