Fehlercodes

Wenn ein Fehler auftritt, gibt die Venice API einen HTTP-Statuscode und eine beschreibende Nachricht zurück. Einige Fehler enthalten zusätzliche Felder, wie z. B. Erstattungsstatus, vorgeschlagene Wiederholungsmodelle, Validierungsdetails oder Request-IDs.

Fehlerantwortformat

Die meisten Fehler geben ein error-Feld mit einer menschenlesbaren Nachricht zurück:

{
  "error": "Invalid request parameters"
}

Einige Endpoints enthalten zusätzliche Felder, die spezifisch für den Endpoint sind. Beispielsweise können Video-Moderationsfehler enthalten, ob Credits erstattet wurden:

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

Validierungsfehler können details- und issues-Felder mit feldbezogenen Validierungsinformationen enthalten:

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

Einige OpenAI-kompatible Endpoints geben für bestimmte Fälle möglicherweise OpenAI-artige Fehlerobjekte zurück, z. B. bei Fehlern wegen Kontextlänge:

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

Fehlende Anmeldedaten

Eine Anfrage ohne Anmeldedaten gibt 402 Payment Required zurück, nicht 401. Jede kostenpflichtige Route akzeptiert auch die x402-Wallet-Authentifizierung, daher ist die Antwort eine Zahlungsaufforderung: Sie enthält einen PAYMENT-REQUIRED-Header und einen Body, der beide Authentifizierungswege beschreibt.

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

Wenn du einen API-Schlüssel verwenden wolltest, prüfe, ob der Header Authorization: Bearer gesetzt ist. Ein vorhandener, aber ungültiger Schlüssel gibt 401 zurück.

Fehler im Anfrageformat

Diese Fehler entstehen beim Lesen des Request-Bodys, bevor eine endpunktspezifische Validierung ausgeführt wird.

HTTP-Status	Message	Ursache
400	`'Content-Type' must be 'application/json'`	Ein `POST`-, `PUT`- oder `PATCH`-Body, der ohne `Content-Type: application/json` gesendet wurde. Endpunkte, die Datei-Uploads entgegennehmen, akzeptieren auch `multipart/form-data`
400	`Invalid JSON request`	Der Body ist kein gültiges JSON
400	`Invalid multipart request: malformed part header`	Ein `multipart/form-data`-Body, der nicht geparst werden kann
413	`Request body exceeds the maximum allowed size.`	Der Request-Body ist zu groß
415	`Request encoding is not supported`	Ein `Content-Encoding` oder Zeichensatz, den die API nicht dekodieren kann

Ein falscher Content-Type gibt 400 zurück, nicht 415. Antworten mit 413 wegen Größenüberschreitung enthalten außerdem ein code-Feld:

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

Die Fehlermeldungen in der Spalte “Message” werden von der API in englischer Sprache zurückgegeben und sind hier unverändert wiedergegeben.

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 [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. Wird nur von `/image/multi-edit` zurückgegeben	-
`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.	-

Weitere Fehler

Die obige Tabelle ist nicht vollständig. Manche Fehler werden ohne einen aufgeführten Code zurückgegeben, und Meldungen können je nach Modell und Endpunkt variieren. Verzweige daher anhand des HTTP-Status und nicht anhand des Meldungstexts. Fehler, die dir begegnen können und nicht in der Tabelle stehen:

HTTP-Status	Wann er auftritt
400	Eine Bildeingabe in einer Chat- oder Responses-Anfrage hat ein nicht unterstütztes Format
400	Die angeforderte Stimme ist für das Text-to-Speech-Modell nicht verfügbar
403	Die Anfrage stammt von einer IP-Adresse, die nicht auf der Allowlist des API-Schlüssels steht
403	Das angeforderte Modell ist durch die Datenschutzeinstellung des API-Schlüssels nicht erlaubt
403	Der Zugriff auf das angeforderte Modell ist eingeschränkt. Wende dich an [email protected]
409	Ein Video-, Musik- oder Voice-Changer-Ergebnis wird noch hochgeladen, wenn du es abrufst. Versuche es in Kürze erneut
410	Der Endpunkt wurde eingestellt
422	Audio ist zu lang oder zu kurz (Voice Cloning, Voice Changer und Audio-Jobs)
422	Das Eingabebild einer Videoanfrage hat ein Seitenverhältnis außerhalb des Bereichs, den das Modell akzeptiert
422	Die Eingabe einer Videoanfrage wurde von der Inhaltsmoderation blockiert
500	Die Video- oder Voice-Changer-Generierung ist fehlgeschlagen
502	Die Sprachsynthese ist upstream fehlgeschlagen, oder ein generiertes Video konnte nicht abgerufen werden. Wiederhole die Anfrage

​Fehlerantwortformat

​Fehlende Anmeldedaten

​Fehler im Anfrageformat

​Fehlercodes

​Weitere Fehler

Fehlerantwortformat

Fehlende Anmeldedaten

Fehler im Anfrageformat

Fehlercodes

Weitere Fehler