When an error occurs in the API, we return a consistent error response format that includes an error code, HTTP status code, and a descriptive message. This reference lists all possible error codes that you might encounter while using our API, along with their corresponding HTTP status codes and messages.Documentation Index
Fetch the complete documentation index at: https://veniceai-experiment-guides-top-level-tab.mintlify.app/llms.txt
Use this file to discover all available pages before exploring further.
| 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. | - |
INVALID_API_KEY | 401 | Invalid API key provided | - |
INSUFFICIENT_BALANCE | 402 | Insufficient USD or Diem balance to complete request. Visit https://venice.ai/settings/api to add credits. | - |
UNAUTHORIZED | 403 | Unauthorized access | - |
INVALID_REQUEST | 400 | Invalid request parameters | - |
INVALID_MODEL | 400 | Invalid model specified | - |
CHARACTER_NOT_FOUND | 404 | No character could be found from the provided character_slug | - |
INVALID_CONTENT_TYPE | 415 | Invalid content type | - |
INVALID_FILE_SIZE | 413 | File size exceeds maximum limit | - |
INVALID_IMAGE_FORMAT | 400 | Invalid image format | - |
CORRUPTED_IMAGE | 400 | The image file is corrupted or unreadable | - |
RATE_LIMIT_EXCEEDED | 429 | Rate limit exceeded | - |
MODEL_NOT_FOUND | 404 | Specified model not found | - |
INFERENCE_FAILED | 500 | Inference processing failed | error |
UPSCALE_FAILED | 500 | Image upscaling failed | error |
UNKNOWN_ERROR | 500 | An unknown error occurred | error |