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	Erforderliche Abfrageparameter in der Upload-URL-Anfrage fehlen	Wird zurückgegeben, wenn erforderliche Abfrageparameter in der Upload-URL-Anfrage 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 nach der Normalisierung alle angegebenen Eingabeschlüssel leer oder ungültig sind.
400	input_duration_requirement_error	Die Gesamtdauer der Eingaben 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 Gesamtdauer der Eingaben 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 erlaubte 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 erlaubte Limit von 400 überschreitet.
400	invalid_request_error	Ungültiger video_category. Erlaubte 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. Erlaubte 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, 0 oder negativ ist.
400	invalid_request_error	Konnte keine positive Eingabedauer aus den input_keys-Metadaten bestimmen	Wird zurückgegeben, wenn die API keine gültige Dauer für die hochgeladenen Eingaben bestimmen kann.
400	invalid_request_error	music_volume muss eine Zahl zwischen 0 und 100 sein	Wird zurückgegeben, wenn `music_volume` angegeben ist, aber keine gültige Zahl zwischen 0 und 100 ist.
400	invalid_request_error	original_audio_volume muss eine Zahl zwischen 0 und 100 sein	Wird zurückgegeben, wenn `original_audio_volume` angegeben ist, aber keine gültige Zahl zwischen 0 und 100 ist.
400	invalid_request_error	Ungültiger music_category. Erlaubte Werte: corporate, romantic, sports, kids_and_comedy, ambient_and_nature, horror_and_suspense, documentary, trending_vlogs	Wird zurückgegeben, wenn `music_category` angegeben ist, aber nicht zu einer der unterstützten Musik-Kategorien passt.
401	authentication_error	Fehlender API-Schlüssel	Wird zurückgegeben, wenn der `x-api-key`-Header nicht bereitgestellt wird.
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 Guthaben, um diesen Job zu verarbeiten	Wird zurückgegeben, wenn das Konto nicht über genügend Guthaben 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 für den Endpunkt zulässige Anfragerate überschreitet. Das aktuelle Limit beträgt 60 Anfragen pro Minute. Die Ratenbegrenzung wird in erster Linie pro API-Schlüssel über den x-api-key-Header angewendet und fällt auf die Client-IP-Adresse zurück, wenn kein API-Schlüssel vorhanden ist. Clients, die dieses Limit erreichen, sollten die Anfragerate reduzieren und nach dem Zurücksetzen des Rate-Limit-Fensters erneut versuchen.
429	rate_limit_error	Sie haben bereits 10 laufende oder in der Warteschlange befindliche Jobs, was das erlaubte Maximum ist. Bitte warten Sie, bis einige Jobs abgeschlossen sind, bevor Sie einen weiteren einreichen.	Wird zurückgegeben, wenn der Benutzer bereits die maximal zulässige Anzahl an laufenden Jobs hat, sowohl laufende Jobs auf Servern als auch wartende Jobs in der Warteschlange. Das aktuelle Limit beträgt insgesamt 10 laufende oder in der Warteschlange befindliche Jobs pro Benutzer. Die Eigentümerschaft wird bestimmt, indem jede job_id auf ausgelasteten Servern und in der Warteschlange wieder mit der user_email des Jobs abgeglichen wird. Clients, die dieses Limit erreichen, sollten warten, bis ein oder mehrere vorhandene Jobs abgeschlossen sind, bevor sie einen weiteren Job erstellen oder rendern.
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 Status-, Render- oder Highlight-Reel-Endpunkten.
500	server_error	Generierung der Upload-URL fehlgeschlagen	Wird zurückgegeben, wenn der Server keine signierte Upload-URL generieren kann.