Σφάλματα

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

Η πρόσβαση στο API είναι επί του παρόντος διαθέσιμη για το πακέτο Studio και ανώτερα.

Επισκόπηση

Όταν μια αίτηση αποτυγχάνει, το 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	Επιστρέφεται όταν το αίτημα render δεν περιλαμβάνει το job_id.
400	invalid_request_error	Δεν υπάρχουν διαθέσιμα αρχεία εξόδου για αυτή την εργασία	Επιστρέφεται όταν η εργασία δεν έχει αρχεία εξόδου που μπορούν να αποδοθούν.
400	invalid_request_error	Το input_keys πρέπει να είναι ένας μη κενός πίνακας	Επιστρέφεται όταν `input_keys` λείπει ή είναι κενό.
400	invalid_request_error	Το input_keys πρέπει να περιέχει τουλάχιστον ένα έγκυρο κλειδί εισόδου	Επιστρέφεται όταν όλα τα παρεχόμενα κλειδιά εισόδου είναι κενά ή άκυρα μετά την κανονικοποίηση.
400	input_duration_requirement_error	Η συνολική διάρκεια εισόδων πρέπει να είναι μεγαλύτερη από 2 δευτερόλεπτα	Επιστρέφεται όταν η συνδυασμένη διάρκεια όλων των εισερχόμενων μέσων είναι 2 δευτερόλεπτα ή λιγότερο.
400	input_duration_requirement_error	Η συνολική διάρκεια εισόδων πρέπει να είναι μικρότερη από 6 ώρες	Επιστρέφεται όταν η συνδυασμένη διάρκεια όλων των εισερχόμενων μέσων είναι 6 ώρες ή περισσότερο.
400	input_image_count_requirement_error	Ο αριθμός των εισερχόμενων εικόνων δεν πρέπει να υπερβαίνει τις 4000	Επιστρέφεται όταν ο αριθμός εισερχόμενων εικόνων υπερβαίνει το μέγιστο επιτρεπόμενο όριο των 4000.
400	input_video_count_requirement_error	Ο αριθμός των εισερχόμενων βίντεο δεν πρέπει να υπερβαίνει τα 400	Επιστρέφεται όταν ο αριθμός εισερχόμενων βίντεο υπερβαίνει το μέγιστο επιτρεπόμενο όριο των 400.
400	invalid_request_error	Μη έγκυρο video_category. Επιτρεπτές τιμές: podcast, ball-sports, non-ball-sports, beauty-product-demo, wedding, travel, others	Επιστρέφεται όταν το `video_category` δεν υποστηρίζεται.
400	invalid_request_error	Μη έγκυρο aspect_ratio. Επιτρεπτές τιμές: square, portrait, landscape	Επιστρέφεται όταν το `aspect_ratio` δεν υποστηρίζεται.
400	invalid_request_error	Το output_length πρέπει να είναι θετικός αριθμός	Επιστρέφεται όταν το `output_length` λείπει, είναι μηδέν ή αρνητικό.
400	invalid_request_error	Δεν ήταν δυνατός ο προσδιορισμός θετικής διάρκειας εισόδου από τα μεταδεδομένα του input_keys	Επιστρέφεται όταν το API δεν μπορεί να προσδιορίσει έγκυρη διάρκεια για τα ανεβασμένα εισερχόμενα.
400	invalid_request_error	Το music_volume πρέπει να είναι αριθμός μεταξύ 0 και 100	Επιστρέφεται όταν το `music_volume` παρέχεται αλλά δεν είναι έγκυρος αριθμός μεταξύ 0 και 100.
400	invalid_request_error	Το original_audio_volume πρέπει να είναι αριθμός μεταξύ 0 και 100	Επιστρέφεται όταν το `original_audio_volume` παρέχεται αλλά δεν είναι έγκυρος αριθμός μεταξύ 0 και 100.
400	invalid_request_error	Μη έγκυρο music_category. Επιτρεπτές τιμές: corporate, romantic, sports, kids_and_comedy, ambient_and_nature, horror_and_suspense, documentary, trending_vlogs	Επιστρέφεται όταν το `music_category` παρέχεται αλλά δεν ταιριάζει με κάποια από τις υποστηριζόμενες κατηγορίες μουσικής.
401	authentication_error	Λείπει το API key	Επιστρέφεται όταν η κεφαλίδα `x-api-key` δεν παρέχεται.
401	authentication_error	Μη έγκυρο API key	Επιστρέφεται όταν το παρεχόμενο API key δεν αντιστοιχεί σε ενεργό κλειδί.
402	insufficient_balance	Δεν έχετε αρκετές πιστώσεις για να επεξεργαστείτε αυτή την εργασία	Επιστρέφεται όταν ο λογαριασμός δεν διαθέτει αρκετές πιστώσεις για επεξεργασία ή απόδοση.
403	permission_error	Δεν έχετε δικαίωμα πρόσβασης σε αυτή την εργασία	Επιστρέφεται όταν ο πιστοποιημένος χρήστης δεν είναι ιδιοκτήτης της ζητούμενης εργασίας.
403	permission_error	Δεν έχετε δικαίωμα να αποδώσετε αυτή την εργασία	Επιστρέφεται όταν ο πιστοποιημένος χρήστης δεν είναι ιδιοκτήτης της εργασίας που αποδίδεται.
404	invalid_request_error	Η εργασία δεν βρέθηκε	Επιστρέφεται όταν η ζητούμενη εργασία δεν υπάρχει.
404	invalid_request_error	Ο χρήστης δεν βρέθηκε	Επιστρέφεται όταν η εγγραφή του πιστοποιημένου χρήστη δεν μπορεί να βρεθεί.
429	rate_limit_error	Πολύ πολλά αιτήματα	Επιστρέφεται όταν ο πελάτης υπερβαίνει τον επιτρεπόμενο ρυθμό αιτήσεων για το endpoint. Το τρέχον όριο είναι 60 αιτήματα ανά λεπτό. Ο περιορισμός ρυθμού εφαρμόζεται κυρίως ανά API key χρησιμοποιώντας την κεφαλίδα `x-api-key`, και σε περίπτωση απουσίας API key γίνεται επαναφορά στη διεύθυνση IP του πελάτη. Οι πελάτες που φτάνουν αυτό το όριο θα πρέπει να μειώσουν τη συχνότητα των αιτημάτων και να δοκιμάσουν ξανά αφού επαναρυθμιστεί το παράθυρο περιορισμού.
429	rate_limit_error	Έχετε ήδη 10 εργασίες σε εκτέλεση ή ουρά, που είναι το μέγιστο επιτρεπόμενο. Περιμένετε να ολοκληρωθούν ορισμένες εργασίες πριν υποβάλετε άλλη.	Επιστρέφεται όταν ο χρήστης έχει ήδη τον μέγιστο επιτρεπόμενο αριθμό εργασιών σε εξέλιξη, τόσο σε εκτελούμενες εργασίες στους servers όσο και σε εκκρεμείς ουρές. Το τρέχον όριο είναι συνολικά 10 εργασίες σε εκτέλεση ή ουρά ανά χρήστη. Η ιδιοκτησία καθορίζεται αντιστοιχίζοντας κάθε job_id στους απασχολημένους servers και τις εκκρεμείς εγγραφές στην ουρά πίσω στο user_email της εργασίας. Οι πελάτες που φτάνουν αυτό το όριο θα πρέπει να περιμένουν μία ή περισσότερες υπάρχουσες εργασίες να ολοκληρωθούν πριν δημιουργήσουν ή αποδώσουν άλλη εργασία.
500	api_error	Σφάλμα πιστοποίησης	Επιστρέφεται όταν η πιστοποίηση API key αποτυγχάνει απροσδόκητα στον διακομιστή.
500	api_error	Εσωτερικό σφάλμα διακομιστή	Επιστρέφεται για απροσδόκητες αποτυχίες στην πλευρά του διακομιστή στα endpoints status, render ή highlight reel.
500	server_error	Αποτυχία δημιουργίας URL μεταφόρτωσης	Επιστρέφεται όταν ο διακομιστής αποτύχει να δημιουργήσει μια υπογεγραμμένη διεύθυνση URL μεταφόρτωσης.