Σφάλματα

Το VIDIO API χρησιμοποιεί μια συνεπή μορφή αντικειμένου σφάλματος. Χρησιμοποιήστε αυτή τη σελίδα για να κατανοήσετε κοινούς τύπους σφαλμάτων, κωδικούς κατάστασης HTTP και παραδείγματα μηνυμάτων που επιστρέφονται από το API.

Η πρόσβαση στο API είναι αυτή τη στιγμή διαθέσιμη μόνο για σχέδια Enterprise. Ζητήστε πρόσβαση εδώ εάν δεν είστε χρήστης Enterprise αλλά ενδιαφέρεστε να χρησιμοποιήσετε το API.

Επισκόπηση

Όταν μια αίτηση αποτυγχάνει, το VIDIO API επιστρέφει ένα αντικείμενο error με ένα type και message. Ορισμένα σφάλματα μπορεί επίσης να περιλαμβάνουν επιπλέον πεδία για να βοηθήσουν στην εξήγηση της αποτυχίας.

Μορφή σφάλματος

json

{
  "error": {
    "type": "invalid_request_error",
    "message": "Η εργασία δεν βρέθηκε"
  }
}

Αναφορά σφάλματος

Status	Type	Message	Description
400	invalid_request_error	Λείπουν απαιτούμενοι παράμετροι ερωτήματος στην αίτηση URL ανέβασμα	Επιστρέφεται όταν λείπουν οι απαιτούμενες παράμετροι ερωτήματος από την αίτηση URL ανέβασμα.
400	invalid_request_error	Λείπει το job_id	Επιστρέφεται όταν η αίτηση απόδοσης δεν περιλαμβάνει ένα ID έργου.
400	invalid_request_error	Δεν υπάρχουν διαθέσιμες εξόδοι για αυτή την εργασία	Επιστρέφεται όταν η εργασία δεν έχει καμία απόδοση.
400	invalid_request_error	input_keys πρέπει να είναι έναν μη κενό πίνακα	Επιστρέφεται όταν το `input_keys` λείπει ή είναι κενό.
400	invalid_request_error	input_keys πρέπει να περιλαμβάνει τουλάχιστον ένα έγκυρο κλειδί εισόδου	Επιστρέφεται όταν όλα τα παρεχόμενα κλειδιά εισόδου είναι κενά ή μη έγκυρα μετά την κανονικοποίηση.
400	invalid_request_error	Μη έγκυρη κατηγορία βίντεο. Επιτρεπόμενες τιμές: podcast, ball-sports, non-ball-sports, beauty-product-demo, wedding, travel, others	Επιστρέφεται όταν το `video_category` δεν υποστηρίζεται.
400	invalid_request_error	Μη έγκυρη αναλογία διάστασης. Επιτρεπόμενες τιμές: square, portrait, landscape	Επιστρέφεται όταν το `aspect_ratio` δεν υποστηρίζεται.
400	invalid_request_error	output_length πρέπει να είναι ένας θετικός αριθμός	Επιστρέφεται όταν το `output_length` λείπει, είναι μηδέν ή αρνητικό.
400	invalid_request_error	Δεν ήταν δυνατός ο προσδιορισμός θετικής διάρκειας εισόδου από τα μεταδεδομένα input_keys	Επιστρέφεται όταν το API δεν μπορεί να προσδιορίσει μια έγκυρη διάρκεια για τις ανέβασμα εισόδους.
401	authentication_error	Λείπει το κλειδί API	Επιστρέφεται όταν η κεφαλίδα `x-api-key` δεν παρέχεται.
401	authentication_error	Μη έγκυρο κλειδί API	Επιστρέφεται όταν το παρεχόμενο κλειδί API δεν αντιστοιχεί σε ενεργό κλειδί.
402	insufficient_balance	Δεν έχετε αρκετούς πιστώσεις για να επεξεργαστείτε αυτή την εργασία	Επιστρέφεται όταν ο λογαριασμός δεν έχει αρκετές πιστώσεις για επεξεργασία ή απόδοση.
403	permission_error	Δεν έχετε άδεια να αποκτήσετε πρόσβαση σε αυτή την εργασία	Επιστρέφεται όταν ο αυθεντικοποιημένος χρήστης δεν κατέχει την ζητούμενη εργασία.
403	permission_error	Δεν έχετε άδεια να αποδώσετε αυτή την εργασία	Επιστρέφεται όταν ο αυθεντικοποιημένος χρήστης δεν κατέχει την εργασία που αποδίδεται.
404	invalid_request_error	Η εργασία δεν βρέθηκε	Επιστρέφεται όταν η ζητούμενη εργασία δεν υπάρχει.
404	invalid_request_error	Ο χρήστης δεν βρέθηκε	Επιστρέφεται όταν δεν μπορεί να βρεθεί η καταγραφή του αυθεντικοποιημένου χρήστη.
429	rate_limit_error	Πάρα πολλές αιτήσεις	Επιστρέφεται όταν ο πελάτης ξεπερνά τον επιτρεπόμενο ρυθμό αιτήσεων για το endpoint. Το τρέχον όριο είναι 60 αιτήσεις ανά λεπτό. Η περιορισμένη χρήση εφαρμόζεται κυρίως ανά κλειδί API χρησιμοποιώντας την κεφαλίδα x-api-key, και υποχωρεί στη διεύθυνση IP του πελάτη όταν δεν υπάρχει παρόν κλειδί API. Οι πελάτες που χτυπούν αυτό το όριο θα πρέπει να μειώσουν τη συχνότητα αιτημάτων και να δοκιμάσουν ξανά μετά την επαναφορά του παραθύρου περιορισμού.
500	api_error	Σφάλμα αυθεντικοποίησης	Επιστρέφεται όταν η αυθεντικοποίηση κλειδιού API αποτυγχάνει απροσδόκητα στον διακομιστή.
500	api_error	Εσωτερικό σφάλμα διακομιστή	Επιστρέφεται για απροσδόκητες αποτυχίες από την πλευρά του διακομιστή σε καθεστώς, απόδοση ή σημεία αναφοράς υψηλής φωτεινότητας.
500	server_error	Αποτυχία δημιουργίας URL ανέβασμα	Επιστρέφεται όταν ο διακομιστής αποτυγχάνει να δημιουργήσει μια υπογεγραμμένη URL ανέβασμα.