> ## Documentation Index > Fetch the complete documentation index at: https://veniceai-mintlify-d2fddb8a.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # Error Codes > Venice API error code reference — HTTP status codes, error response format, refund status, retry guidance, and validation details for failed requests. When an error occurs, the Venice API returns an HTTP status code and a descriptive message. Some errors also include additional fields, such as refund status, suggested retry models, validation details, or request IDs. ## Error response format Most errors return an `error` field with a human-readable message: ```json theme={null} { "error": "Invalid request parameters" } ``` Some endpoints include additional fields that are specific to the endpoint. For example, video moderation errors can include whether credits were refunded: ```json theme={null} { "error": "Your generation was blocked due to the model provider's content policies. Credits have been refunded.", "credits_refunded": true } ``` Validation errors may include `details` and `issues` fields with field-level validation information: ```json theme={null} { "error": "Invalid request parameters", "details": { "_errors": [], "field": { "_errors": ["Field is required"] } }, "issues": [] } ``` Some OpenAI-compatible endpoints may return OpenAI-style error objects for specific cases, such as context length errors: ```json theme={null} { "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 codes | 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](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](mailto: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. | - |