Codes d'erreur - Venice API Docs

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"
  }
}

Identifiants manquants

Une requête sans identifiants renvoie 402 Payment Required, et non 401. Chaque route payante accepte également l’authentification par portefeuille x402, la réponse est donc une demande de paiement : elle inclut un en-tête PAYMENT-REQUIRED et un corps décrivant les deux façons de s’authentifier.

{
  "x402Version": 2,
  "error": "Authentication required",
  "accepts": [ ... ],
  "authOptions": {
    "apiKey": {
      "header": "Authorization: Bearer YOUR_API_KEY",
      "getKey": "https://venice.ai/settings/api"
    },
    "x402Wallet": {
      "header": "SIGN-IN-WITH-X",
      "topUp": "POST /api/v1/x402/top-up"
    }
  }
}

Si vous vouliez utiliser une clé API, vérifiez que l’en-tête Authorization: Bearer est défini. Une clé présente mais invalide renvoie 401.

Erreurs de format de requête

Ces erreurs proviennent de la lecture du corps de la requête, avant toute validation propre à l’endpoint.

Statut HTTP	Message	Cause
400	`'Content-Type' must be 'application/json'`	Un corps `POST`, `PUT` ou `PATCH` envoyé sans `Content-Type: application/json`. Les endpoints qui acceptent des envois de fichiers acceptent aussi `multipart/form-data`
400	`Invalid JSON request`	Le corps n’est pas du JSON valide
400	`Invalid multipart request: malformed part header`	Un corps `multipart/form-data` qui ne peut pas être analysé
413	`Request body exceeds the maximum allowed size.`	Le corps de la requête est trop volumineux
415	`Request encoding is not supported`	Un `Content-Encoding` ou un jeu de caractères que l’API ne peut pas décoder

Un mauvais Content-Type renvoie 400, et non 415. Les réponses 413 liées à la limite de taille incluent aussi un champ code :

{
  "code": "PAYLOAD_TOO_LARGE",
  "error": "Request body exceeds the maximum allowed size."
}

Codes d’erreur

Code d’erreur	Statut HTTP	Message	Niveau de log
`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 [email protected]	-
`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 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. Renvoyé uniquement par `/image/multi-edit`	-
`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 non-streaming requests, use the streaming API by setting `stream=true`. A streaming chat completion that times out before the model’s first chunk reports the failure as an in-band SSE error frame instead.	-

Autres erreurs

Le tableau ci-dessus n’est pas exhaustif. Certaines erreurs sont renvoyées sans code répertorié, et les messages peuvent varier selon le modèle et l’endpoint : basez donc votre logique sur le statut HTTP plutôt que sur le texte du message. Erreurs que vous pouvez rencontrer et qui ne figurent pas dans le tableau :

Statut HTTP	Quand elle se produit
400	Une image en entrée dans une requête de chat ou Responses est dans un format non pris en charge
400	La voix demandée n’est pas disponible pour le modèle de synthèse vocale
403	La requête provient d’une adresse IP qui ne figure pas dans la liste d’autorisation de la clé API
403	Le modèle demandé n’est pas autorisé par le paramètre de confidentialité de la clé API
403	L’accès au modèle demandé est restreint. Contactez [email protected]
409	Un résultat de vidéo, de musique ou de changement de voix est encore en cours d’envoi lorsque vous le récupérez. Réessayez sous peu
410	L’endpoint a été retiré
422	L’audio est trop long ou trop court (clonage de voix, changement de voix et tâches audio)
422	L’image en entrée d’une requête vidéo a un rapport largeur/hauteur hors de la plage acceptée par le modèle
422	L’entrée d’une requête vidéo a été bloquée par la modération de contenu
500	La génération de vidéo ou de changement de voix a échoué
502	La synthèse vocale a échoué en amont, ou une vidéo générée n’a pas pu être récupérée. Réessayez la requête

​Format de la réponse d’erreur

​Identifiants manquants

​Erreurs de format de requête

​Codes d’erreur

​Autres erreurs

Format de la réponse d’erreur

Identifiants manquants

Erreurs de format de requête

Codes d’erreur

Autres erreurs