Passer au contenu principal
Lorsqu’une erreur survient, l’API Venice renvoie un code d’état HTTP et un message descriptif. Certaines erreurs incluent également des champs supplémentaires, tels que le statut de remboursement, les modèles de relance suggérés, les détails de validation ou les identifiants de requête.

​
Format de la réponse d’erreur

La plupart des erreurs renvoient un champ error avec un message lisible par l’humain : 
{
  "error": "Invalid request parameters"
}
Certains endpoints incluent des champs supplémentaires spécifiques à l’endpoint. Par exemple, les erreurs de modération vidéo peuvent indiquer si les crédits ont été remboursés : 
{
  "error": "Your generation was blocked due to the model provider's content policies. Credits have been refunded.",
  "credits_refunded": true
}
Les erreurs de validation peuvent inclure des champs details et issues avec des informations de validation au niveau du champ : 
{
  "error": "Invalid request parameters",
  "details": {
    "_errors": [],
    "field": {
      "_errors": ["Field is required"]
    }
  },
  "issues": []
}
Certains endpoints compatibles OpenAI peuvent renvoyer des objets d’erreur de style OpenAI pour des cas spécifiques, comme les erreurs de longueur de contexte : 
{
  "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"
  }
}

​
Codes d’erreur

Code d’erreurStatut HTTPMessageNiveau de log
AUTHENTICATION_FAILED401Authentication failed-
AUTHENTICATION_FAILED_INACTIVE_KEY401Authentication failed - Pro subscription is inactive. Please upgrade your subscription to continue using the API-
X402_INVALID_SIGN_IN401Invalid Sign-in-with-x signature-
PRO_ONLY_MODEL401This model is only available to Pro users-
INSUFFICIENT_BALANCE402Insufficient USD or Diem balance to complete request. Visit https://venice.ai/settings/api to add credits.-
API_KEY_DIEM_SPEND_LIMIT_EXCEEDED402API 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_EXCEEDED402API key USD spend limit exceeded. Your account may still have USD balance, but this API key has reached its configured USD spending limit.-
UNAUTHORIZED403Unauthorized access-
API_ACCESS_DISABLED403API access has been disabled for this account. Please contact [email protected]-
X402_WALLET_MISMATCH403You can only access resources for your own wallet-
INVALID_REQUEST400Invalid request parameters-
INVALID_MODEL400Invalid model specified-
REQUEST_ID_NOT_FOUND400Request ID is invalid.-
INVALID_AUDIO_FORMAT400Invalid audio format. Supported formats are WAV and MP3.-
INVALID_VIDEO_FORMAT400Invalid video format. Supported formats include MP4, MOV, WebM, MKV, AVI, and others.-
CORRUPTED_IMAGE400The image file is corrupted or unreadable-
IMAGE_TOO_SMALL400Image dimensions are too small-
TOO_MANY_TOKENS400Your request exceeds the model’s maximum context. Please reduce your prompt or completion length.-
CHARACTER_NOT_FOUND404No character could be found from the provided character_slug-
MODEL_NOT_FOUND404Specified model not found-
MEDIA_NOT_FOUND404Media could not be found. Request may may be invalid, expired, or deleted.-
PAYLOAD_TOO_LARGE413The request payload is too large. Please reduce the size of your request.-
INVALID_CONTENT_TYPE415Invalid request content-type-
VIDEO_DURATION_TOO_LONG422Video duration exceeds the maximum allowed.-
VIDEO_DURATION_TOO_SHORT422Video duration is too short.-
IMAGE_TOO_LARGE422Image dimensions exceed the maximum allowed.-
CONTENT_POLICY_VIOLATION422Your prompt violates the content policy of Venice.ai or the model provider-
ASR_UPSTREAM_VALIDATION_FAILED422The 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_EXCEEDED429Rate limit exceeded-
MODEL_OVERLOADED429The model is currently overloaded. Please try again later.-
INFERENCE_FAILED500Inference processing failederror
UPSCALE_FAILED500Image upscaling failederror
IMAGE_EDIT_ERROR500Image edit failederror
UNKNOWN_ERROR500An unknown error occurrederror
TEE_ATTESTATION_FAILED502TEE attestation request failed. The Trusted Execution Environment provider may be temporarily unavailable.error
TEE_SIGNATURE_FAILED502TEE signature request failed. The Trusted Execution Environment provider may be temporarily unavailable.error
ASR_UPSTREAM_FAILED502Audio transcription failed due to a temporary upstream error. Please retry.warn
MODEL_OFFLINE503The model is temporarily offline. Please try again later.-
MODEL_AT_CAPACITY503The model is at capacity. Please try again later.-
REQUEST_TIMEOUT504The 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.-