Fehler

Die VIDIO API verwendet ein konsistentes Fehlerschema. Verwenden Sie diese Seite, um häufige Fehlertypen, HTTP-Statuscodes und Beispielnachrichten, die von der API zurückgegeben werden, zu verstehen.

API-Zugang ist derzeit für den Studio-Plan und höher verfügbar.

Überblick

Wenn eine Anfrage fehlschlägt, gibt die VIDIO API ein error-Objekt mit einem type und message zurück. Einige Fehler können auch zusätzliche Felder enthalten, um das Versagen zu erklären.

Fehlerformat

json

{
  "error": {
    "type": "invalid_request_error",
    "message": "Job nicht gefunden"
  }
}

Fehlerreferenz

Status	Type	Message	Description
400	invalid_request_error	Fehlende erforderliche Abfrageparameter in der Anfrage zur Upload-URL	Wird zurückgegeben, wenn in der Anfrage zur Upload-URL erforderliche Abfrageparameter fehlen.
400	invalid_request_error	Fehlende job_id	Wird zurückgegeben, wenn die Render-Anfrage keine Job-ID enthält.
400	invalid_request_error	Für diesen Job sind keine Ausgaben verfügbar	Wird zurückgegeben, wenn der Job keine renderbaren Ausgaben hat.
400	invalid_request_error	input_keys muss ein nicht-leeres Array sein	Wird zurückgegeben, wenn `input_keys` fehlt oder leer ist.
400	invalid_request_error	input_keys muss mindestens einen gültigen Eingabeschlüssel enthalten	Wird zurückgegeben, wenn alle bereitgestellten Eingabeschlüssel nach der Normalisierung leer oder ungültig sind.
400	input_duration_requirement_error	Die gesamte Eingabedauer muss größer als 2 Sekunden sein	Wird zurückgegeben, wenn die kombinierte Dauer aller Eingabemedien 2 Sekunden oder weniger beträgt.
400	input_duration_requirement_error	Die gesamte Eingabedauer muss weniger als 6 Stunden betragen	Wird zurückgegeben, wenn die kombinierte Dauer aller Eingabemedien 6 Stunden oder mehr beträgt.
400	input_image_count_requirement_error	Die Anzahl der Eingabebilder darf 4000 nicht überschreiten	Wird zurückgegeben, wenn die Anzahl der Eingabebilder das maximal zulässige Limit von 4000 überschreitet.
400	input_video_count_requirement_error	Die Anzahl der Eingabevideos darf 400 nicht überschreiten	Wird zurückgegeben, wenn die Anzahl der Eingabevideos das maximal zulässige Limit von 400 überschreitet.
400	invalid_request_error	Ungültiger video_category. Zulässige Werte: podcast, ball-sports, non-ball-sports, beauty-product-demo, wedding, travel, others	Wird zurückgegeben, wenn `video_category` nicht unterstützt wird.
400	invalid_request_error	Ungültiger aspect_ratio. Zulässige Werte: square, portrait, landscape	Wird zurückgegeben, wenn `aspect_ratio` nicht unterstützt wird.
400	invalid_request_error	output_length muss eine positive Zahl sein	Wird zurückgegeben, wenn `output_length` fehlt, null oder negativ ist.
400	invalid_request_error	Die positive Eingabedauer konnte nicht aus den Metadaten von input_keys ermittelt werden	Wird zurückgegeben, wenn die API keine gültige Dauer für die hochgeladenen Eingaben ermitteln kann.
401	authentication_error	Fehlender API-Schlüssel	Wird zurückgegeben, wenn der Header `x-api-key` nicht angegeben ist.
401	authentication_error	Ungültiger API-Schlüssel	Wird zurückgegeben, wenn der bereitgestellte API-Schlüssel nicht mit einem aktiven Schlüssel übereinstimmt.
402	insufficient_balance	Sie haben nicht genügend Credits, um diesen Job zu verarbeiten	Wird zurückgegeben, wenn das Konto nicht über genügend Credits für die Verarbeitung oder das Rendern verfügt.
403	permission_error	Sie haben keine Berechtigung, auf diesen Job zuzugreifen	Wird zurückgegeben, wenn der authentifizierte Benutzer den angeforderten Job nicht besitzt.
403	permission_error	Sie haben keine Berechtigung, diesen Job zu rendern	Wird zurückgegeben, wenn der authentifizierte Benutzer den zu rendernden Job nicht besitzt.
404	invalid_request_error	Job nicht gefunden	Wird zurückgegeben, wenn der angeforderte Job nicht existiert.
404	invalid_request_error	Benutzer nicht gefunden	Wird zurückgegeben, wenn der Datensatz des authentifizierten Benutzers nicht gefunden werden kann.
429	rate_limit_error	Zu viele Anfragen	Wird zurückgegeben, wenn der Client die zulässige Anfragerate für den Endpoint überschreitet. Das aktuelle Limit liegt bei 60 Anfragen pro Minute. Die Ratenbegrenzung wird primär pro API-Schlüssel über den Header x-api-key angewendet und greift auf die Client-IP-Adresse zurück, wenn kein API-Schlüssel vorhanden ist. Clients, die dieses Limit erreichen, sollten die Anfragsfrequenz reduzieren und nach dem Zurücksetzen des Ratenbegrenzungszeitfensters erneut versuchen.
500	api_error	Authentifizierungsfehler	Wird zurückgegeben, wenn die API-Schlüssel-Authentifizierung auf dem Server unerwartet fehlschlägt.
500	api_error	Interner Serverfehler	Wird zurückgegeben bei unerwarteten serverseitigen Fehlern in den Endpunkten status, render oder highlight reel.
500	server_error	Generierung der Upload-URL fehlgeschlagen	Wird zurückgegeben, wenn der Server keine signierte Upload-URL erzeugen kann.