ByteDance: Seedance 1.5 Pro
Το ByteDance Seedance 1.5 Pro παράγει βίντεο μαζί με συγχρονισμένο διάλογο, ηχητικά εφέ και μουσική. Κατευθύνετε τους ομιλητές, τα συναισθήματα, την κάμερα και την ηχητική ατμόσφαιρα για να αναπτύξετε σύντομα δράματα, διαφημίσεις με ομιλία και σκηνές χαρακτήρων.
Σχετικά με το μοντέλο
Αυτή η περιγραφή καλύπτει τις δυνατότητες του μοντέλου. Οι είσοδοι, έξοδοι και επιλογές που διατίθενται στο Ailoot παρατίθενται παρακάτω για την επιλεγμένη μέθοδο.
Το Seedance 1.5 Pro είναι το μοντέλο της ByteDance Seed για εγγενή κοινή παραγωγή ήχου και βίντεο. Μοντελοποιεί μαζί την οπτική δράση, την ομιλία και τον ρυθμό, επιτρέποντας σε μια σκηνή να περιλαμβάνει ερμηνεία χαρακτήρα, συγχρονισμένο διάλογο και σχεδιασμένο ηχητικό τοπίο. Η κεντρική διαφορά από μια οδηγία βίντεο μόνο για εικόνα είναι ότι ο ήχος γίνεται μέρος της περιγραφής σκηνής: ποιος μιλά, πώς εκφέρεται η ατάκα και τι ακούει το κοινό γύρω από τη δράση.
Κοινή οπτικοακουστική παραγωγή
Το τεκμηριωμένο εύρος ήχων περιλαμβάνει περιβαλλοντικούς ήχους, εφέ δράσης, συνθετικούς ήχους, όργανα, μουσική υπόκρουση και φωνητικά. Το μοντέλο προορίζεται να συνδέει τον ήχο με όσα συμβαίνουν στην οθόνη: ένα αντικείμενο που χτυπά σε τραπέζι, μια πόρτα που ανοίγει ή έναν χαρακτήρα που μιλά. Χρησιμοποιήστε το για σύντομη δραματική στιγμή, διαφήμιση προϊόντος με ομιλία ή σκηνή της οποίας η διάθεση εξαρτάται τόσο από την ερμηνεία όσο και από τον ήχο.
Ξεκινήστε την προτροπή με το θέμα και την κίνηση, έπειτα προσθέστε περιβάλλον, κάμερα, οπτικό ύφος και ήχο. Μια σύντομη σκηνή θα μπορούσε να είναι: «Ένας σεφ σηκώνει το καπάκι από μια μικρή κατσαρόλα, χαμογελά και λέει: “Είναι έτοιμο”. Απελευθερώνεται μια απαλή ριπή ατμού και ακολουθεί το ήσυχο κροτάλισμα του καπακιού καθώς ακουμπά στον πάγκο». Αυτό δίνει στην ατάκα και στα εφέ ορατή αιτία.
Διάλογος και αφήγηση εκτός κάδρου
Το μοντέλο υποστηρίζει μονολόγους και συζητήσεις με πολλούς ομιλητές, με κινήσεις χειλιών που αντιστοιχούν στους χαρακτήρες. Ο οδηγός του τεκμηριώνει μανδαρινικά, κινεζικές διαλέκτους όπως καντονέζικα, Shaanxi και Sichuan, καθώς και προφορικά αγγλικά, ιαπωνικά, κορεατικά, ισπανικά και ινδονησιακά. Οι τεκμηριωμένες γλώσσες προτροπής είναι κινεζικά και αγγλικά· η γλώσσα της προτροπής και η γλώσσα που ζητείται για μια ατάκα είναι ξεχωριστές επιλογές.
Προσδιορίστε κάθε ομιλητή με συνεπές ορατό χαρακτηριστικό και γράψτε τις ατάκες σε εισαγωγικά. Συμπεριλάβετε οδηγίες εκφοράς όπως ήρεμη φωνή, διστακτική απάντηση ή ταχύτερο ρυθμό και κάντε ρητή την εναλλαγή. Για δύο ομιλητές, περιγράψτε ποιος μιλά πρώτος και ποιανού αντίδραση δείχνει η κάμερα. Μια σύντομη ανταλλαγή που χωρά στο επιλεγμένο απόσπασμα δίνει στο μοντέλο σαφέστερο στόχο ερμηνείας από ένα μεγάλο κείμενο με απροσδιόριστους ομιλητές.
Η αφήγηση εκτός κάδρου μπορεί να κατευθύνεται μέσω χροιάς, συναισθήματος, επιτονισμού και ταχύτητας ομιλίας. Είναι χρήσιμη όταν η φωνή πρέπει να εξηγεί ένα προϊόν ενώ η κάμερα παραμένει σε αυτό ή όταν ένας αφηγητής διαμορφώνει τη διάθεση χωρίς ορατό ομιλητή. Ο οδηγός περιγράφει διατήρηση αναγνωρίσιμης χροιάς με αλλαγή εκφοράς· ελέγξτε την πραγματική διατύπωση, την προφορά και την ερμηνεία μαζί με την εικόνα.
Ηχητικά εφέ και μουσική υπόκρουση
Περιγράψτε τα εφέ ως συμβάντα συνδεδεμένα με τη δράση: βήματα καθώς εισέρχεται ένας χαρακτήρας, βροχή που δυναμώνει έξω από παράθυρο ή ύφασμα που κινείται καθώς φοριέται ένα παλτό. Η μουσική υπόκρουση παράγεται από προεπιλογή ώστε να ταιριάζει στην προτροπή. Προσδιορίστε διάθεση, ύφος και ρυθμό όταν έχουν σημασία και δηλώστε πότε πρέπει να αρχίζει ή να σβήνει σε σχέση με τη σκηνή.
Για μια ήσυχη επίδειξη, ζητήστε διακριτική μουσική και δώστε έμφαση στους ήχους χειρισμού προϊόντος. Για μια σκηνή κινουμένων σχεδίων, περιγράψτε τη στιγμή δράσης που πρέπει να συμπέσει με τον μουσικό ρυθμό. Το παραγόμενο ηχητικό κομμάτι είναι μονοφωνικό. Η τεκμηριωμένη ρύθμιση ήχου επιτρέπει επίσης σιωπηλό βίντεο όταν το έργο χρειάζεται ξεχωριστά προετοιμασμένο ηχητικό κομμάτι.
Μεταβάσεις πλάνων και κατεύθυνση κάμερας
Το μοντέλο υποστηρίζει αλλαγές πλάνων με συνεπή οπτική απόδοση, αντίστροφα πλάνα για συζήτηση και οδηγίες για τον χρονισμό μεταβάσεων. Μια χρήσιμη ακολουθία διαλόγου μπορεί να παρουσιάζει δύο ομιλητές σε μεσαίο πλάνο, να κόβει στον ομιλητή που απαντά και να επιστρέφει στην αντίδραση του πρώτου. Δηλώστε την ταυτότητα κάθε ατόμου όταν αλλάζει το πλάνο.
Ο οδηγός καλύπτει υψηλές, χαμηλές και στο ύψος των ματιών γωνίες· οπτικές πάνω από τον ώμο και υποκειμενικές οπτικές· καθώς και γενικό, μεσαίο και κοντινό κάδρο. Περιγράψτε μια κίνηση κάμερας μέσω της αρχικής σύνθεσης, της κατεύθυνσης, του εύρους και της τελικής σύνθεσης. Για παράδειγμα, ένα αργό dolly-in μπορεί να καταλήγει στην έκφραση του ομιλητή καθώς ολοκληρώνεται η ατάκα. Συνδέστε την κίνηση με την ιστορία αντί να απαριθμείτε πολλές τεχνικές κάμερας χωρίς σκοπό.
Λειτουργίες, έξοδος και προεπισκόπηση
Οι τεκμηριωμένοι τρόποι εισόδου είναι μετατροπή κειμένου σε βίντεο, εικόνας πρώτου καρέ σε βίντεο και εικόνων πρώτου και τελευταίου καρέ σε βίντεο. Μια έτοιμη πρώτη εικόνα ορίζει την αρχική σύνθεση· μια τελική εικόνα μπορεί να ορίζει το επιδιωκόμενο τελικό σημείο. Οι προδιαγραφές εξόδου παραθέτουν MP4 στα 24 fps, 480p, 720p ή 1080p και ρυθμίσεις διάρκειας 4–12 δευτερολέπτων. Το μοντέλο μπορεί επίσης να επιλέγει διάρκεια ακέραιων δευτερολέπτων εντός του υποστηριζόμενου εύρους. Οι τεκμηριωμένες αναλογίες είναι 21:9, 16:9, 4:3, 1:1, 3:4 και 9:16, με υποστήριξη προσαρμοστικού καδραρίσματος.
Ο κατασκευαστής τεκμηριώνει ροή Draft δύο σταδίων: προεπισκόπηση 480p για επιθεώρηση δομής σκηνής, επιλογών πλάνων, κίνησης και πρόθεσης προτροπής, ακολουθούμενη από τελική παραγωγή που επαναχρησιμοποιεί τις δημιουργικές εισόδους. Αυτό επιτρέπει την αξιολόγηση μιας σχεδιασμένης ερμηνείας πριν επιλεγεί η τελική ανάλυσή της. Η ίδια η προεπισκόπηση περιορίζεται σε 480p και δεν υποστηρίζει επιστροφή τελευταίου καρέ. Το αναγνωριστικό εργασίας Draft του κατασκευαστή παραμένει έγκυρο για επτά ημέρες μετά τη δημιουργία· δημιουργήστε το τελικό βίντεο από αυτό εντός του παραθύρου.
Για εργασία βάσει εικόνας, προετοιμάστε την αρχική εικόνα για το επιδιωκόμενο κάδρο: η αλλαγή αναλογίας εξόδου μπορεί να περικόψει την εικόνα. Επαναλαμβανόμενο seed παράγει παρόμοια και όχι εγγυημένα πανομοιότυπα καρέ, ενώ οδηγία σταθερής κάμερας δεν αποτελεί εγγύηση τέλειου κλειδώματος. Κυρίως, αξιολογήστε ένα απόσπασμα διαλόγου ως ενιαία οπτικοακουστική ερμηνεία: ο σωστός ομιλητής, η ακουστή ατάκα, η αντίδραση προσώπου και η έμφαση κάμερας πρέπει όλα να υπηρετούν το ίδιο συμβάν.
Ailoot Ultra · Βίντεο POST /v1/videos bytedance/seedance-1-5-pro
bytedance/seedance-1-5-proΕισαγωγή
Το ByteDance Seedance 1.5 Pro παράγει βίντεο μαζί με συγχρονισμένο διάλογο, ηχητικά εφέ και μουσική. Κατευθύνετε τους ομιλητές, τα συναισθήματα, την κάμερα και την ηχητική ατμόσφαιρα για να αναπτύξετε σύντομα δράματα, διαφημίσεις με ομιλία και σκηνές χαρακτήρων.
- Αποδεκτές είσοδοι
- Κείμενο · Εικόνες
- Αποτελέσματα
- Βίντεο
Διαθέσιμα στο Ailoot · είσοδοι και μέθοδοι
Ailoot Ultra · Βίντεο POST /v1/videos
- Είσοδος
text,image- Έξοδος
video- Μορφή εξόδου
- αρχικά byte του MP4· χωρίς κανονικοποίηση ή διακωδικοποίηση
| Πεδίο | Τύπος | Απαίτηση | Τιμές και όρια | Προεπιλογή |
|---|---|---|---|---|
Πεδίοmodel | Τύποςstring | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια bytedance/seedance-1-5-pro | Προεπιλογή— |
Πεδίοprompt | Τύποςstring | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια | Προεπιλογή— |
Πεδίοduration | Τύποςinteger | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια 4, 5, 6, 7, 8, 9, 10, 11, 12 Ελάχιστο: 1 Μέγιστο: 600 | Προεπιλογή— |
Πεδίοresolution | Τύποςstring | ΑπαίτησηΠροαιρετικό | Τιμές και όρια 480p, 720p, 1080p | Προεπιλογή— |
Πεδίοaspect_ratio | Τύποςstring | ΑπαίτησηΠροαιρετικό | Τιμές και όρια 1:1, 3:4, 9:16, 9:21, 4:3, 16:9, 21:9 | Προεπιλογή— |
Πεδίοgenerate_audio | Τύποςboolean | ΑπαίτησηΠροαιρετικό | Τιμές και όρια false, true Συνθήκες: Η παράλειψη αυτής της επιλογής επιλέγει την τιμή με ήχο. Ορίστε την σε false για να επιλέξετε την τιμή χωρίς ήχο. Ελέγξτε το has_audio στο αποτέλεσμα για να δείτε αν επιστράφηκε ηχητικό κομμάτι. | Προεπιλογή— |
Πεδίοframe_images | Τύποςarray | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Ελάχιστο πλήθος στοιχείων: 1 Μέγιστο πλήθος στοιχείων: 2 Περιεχόμενο εισόδου: Πίνακας αντικειμένων καρέ. Κάθε αντικείμενο έχει type=image_url, image_url που περιέχει url και frame_type. Χρησιμοποιήστε HTTPS URL εικόνας και ορίστε το frame_type σε first_frame ή last_frame. Κάθε ρόλος καρέ εμφανίζεται το πολύ μία φορά. Ακριβή κλειδιά: type, image_url, frame_type Συνθήκες: Αυτά τα κλειδιά περιγράφουν κάθε αντικείμενο καρέ· το image_url περιέχει μόνο url. Παραλείψτε το frame_images για αίτημα μόνο με κείμενο. | Προεπιλογή— |
Πεδίοinput_references | Τύποςarray | ΑπαίτησηΠροαιρετικό | Τιμές και όρια | Προεπιλογή— |
Πεδίοsize | Τύποςstring | ΑπαίτησηΠροαιρετικό | Τιμές και όρια 480x480, 480x640, 480x854, 480x1120, 640x480, 720x720, 720x960, 720x1280, 720x1680, 854x480, 960x720, 1080x1080, 1080x1440, 1080x1920, 1080x2520, 1120x480, 1280x720, 1440x1080, 1680x720, 1920x1080, 2520x1080 Μοτίβο: ^[1-9][0-9]*x[1-9][0-9]*$ | Προεπιλογή— |
Πεδίοseed | Τύποςinteger | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Ελάχιστο: -9.223.372.036.854.775.808 Μέγιστο: 9.223.372.036.854.775.807 | Προεπιλογή— |
Πεδίοcallback_url | Τύποςstring | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Μοτίβο: ^https:// | Προεπιλογή— |
Πεδίοsession_id | Τύποςstring | ΑπαίτησηΠροαιρετικό | Τιμές και όρια | Προεπιλογή— |
Πεδίοtrace | Τύποςobject | ΑπαίτησηΠροαιρετικό | Τιμές και όρια | Προεπιλογή— |
Πεδίοuser | Τύποςstring | ΑπαίτησηΠροαιρετικό | Τιμές και όρια | Προεπιλογή— |
Συνδυασμοί υλικών εισόδου
Κείμενο σε βίντεο · Μια γραπτή προτροπή. · Υποχρεωτικό: model, prompt, duration
Δώστε την προτροπή ως κείμενο και τη διάρκεια σε ακέραια δευτερόλεπτα. Επιλέξτε υποστηριζόμενη ανάλυση και αναλογία διαστάσεων ή ακριβές αναγραφόμενο μέγεθος.
model: Τύπος: string · bytedance/seedance-1-5-pro
prompt: Τύπος: string · Μέγιστο πλήθος byte UTF-8: 10.000 · Απαιτείται περιεχόμενο πέρα από κενά διαστήματα: Ναι
Εικόνα σε βίντεο · Μια γραπτή προτροπή και μια εικόνα πρώτου καρέ. · Υποχρεωτικό: model, prompt, duration, frame_images
Το frame_images είναι πίνακας. Κάθε αντικείμενο καρέ έχει type, image_url και frame_type· το image_url περιέχει url. Ορίστε το type σε image_url. Χρησιμοποιήστε first_frame με προαιρετικό last_frame. Κάθε ρόλος καρέ εμφανίζεται το πολύ μία φορά. Δώστε ένα δημόσιο HTTPS URL εικόνας για κάθε καρέ. Επιλέξτε υποστηριζόμενη ανάλυση και αναλογία διαστάσεων ή ακριβές αναγραφόμενο μέγεθος.
Ακριβή κλειδιά: type, image_url, frame_type
model: Τύπος: string · bytedance/seedance-1-5-pro
prompt: Τύπος: string · Μέγιστο πλήθος byte UTF-8: 10.000 · Απαιτείται περιεχόμενο πέρα από κενά διαστήματα: Ναι
Παράμετροι και κύκλος ζωής μεθόδου
| Παράμετρος | Σύμβαση |
|---|---|
Παράμετροςcontent_type | Σύμβασηapplication/json |
Παράμετροςrequired | Σύμβασηmodel, prompt, duration |
Παράμετροςmaterial_types | Σύμβασηtext, image |
Παράμετροςadditional_properties | Σύμβασηfalse |
Παράμετροςoptional_controls | Σύμβασηresolution, aspect_ratio, generate_audio, frame_images, input_references, size, seed, callback_url, session_id, trace, user |
Κύκλος ζωής: submit_once_poll_original
GET /v1/videos/{public_id}
GET /v1/videos/{public_id}/content
Τιμολόγηση
Πώς υπολογίζεται η τελική χρέωση
Οι εμφανιζόμενες τιμές χρησιμοποιούνται για την εκτίμηση του κόστους πριν από την παραγωγή. Η τελική χρέωση υπολογίζεται από το κόστος που καταγράφηκε για την αρχική παραγωγή. Η μετρημένη διάρκεια της εξόδου και οι προβλεπόμενες ποσότητες δεν αποτελούν την τελική χρεώσιμη ποσότητα.
Οι τιμολογιακές αναφορές δεν προσθέτουν επιλογές αιτήματος. Οι υποστηριζόμενες παράμετροι αναφέρονται στην επιλεγμένη μέθοδο.
- Γρήγορη λειτουργία
- Δεν έχει οριστεί Όταν επιλέγεται η γρήγορη λειτουργία
- Λειτουργία flex
- Δεν έχει οριστεί Όταν επιλέγεται η λειτουργία flex
- Μέγιστη προσπάθεια συλλογισμού
- Δεν έχει οριστεί Όταν η μέγιστη προσπάθεια συλλογισμού χρησιμοποιεί την προσαρμογή default
Εκτιμώμενες χρεώσεις για σύγκριση
Τιμές ανά διαμόρφωση
Αντιστοιχίστε κάθε χρέωση στις συνθήκες που εμφανίζονται. Χρησιμοποιήστε μία χρέωση ανά σύνολο εναλλακτικών διαμορφώσεων.
| Διαμόρφωση | Πίνακας χρεώσεων | Προβλεπόμενη ποσότητα | Μονάδα τιμολόγησης | Συνθήκες χρέωσης | Χρέωση |
|---|---|---|---|---|---|
| ΔιαμόρφωσηΒασικές χρεώσεις token | Πίνακας χρεώσεωνΒασική χρέωση | Προβλεπόμενη ποσότητα— | Μονάδα τιμολόγησης— | Συνθήκες χρέωσης— | Χρέωση Είσοδος · Token εισόδου · Εκτίμηση μόνο για σύγκριση — / 1K token Έξοδος · Token εξόδου · Εκτίμηση μόνο για σύγκριση — / 1K token Είσοδος · Ανάγνωση από την κρυφή μνήμη · Εκτίμηση μόνο για σύγκριση — / 1K token Είσοδος · Εγγραφή στην κρυφή μνήμη · Εκτίμηση μόνο για σύγκριση — / 1K token Είσοδος · Εγγραφή στην κρυφή μνήμη, 1 ώρα · Εκτίμηση μόνο για σύγκριση — / 1K token |
| ΔιαμόρφωσηΤιμή token βίντεο | Πίνακας χρεώσεων— | Προβλεπόμενη ποσότητα— | Μονάδα τιμολόγησηςανά 1K token βίντεο | Συνθήκες χρέωσηςΔεν δηλώνεται πρόσθετη συνθήκη σε αυτό το κλειδί τιμολόγησης. | Χρέωση Έξοδος · Τιμή ανά token βίντεο · Εκτίμηση μόνο για σύγκριση $0.0048 ανά 1K token βίντεο Η τιμή ανά token βίντεο είναι η κύρια αναφορά τιμής. Οι ενδεικτικές εκτιμήσεις ανά δευτερόλεπτο είναι ξεχωριστές αναφορές και όχι πρόσθετη χρέωση. |
| ΔιαμόρφωσηΤιμή token βίντεο | Πίνακας χρεώσεων— | Προβλεπόμενη ποσότητα— | Μονάδα τιμολόγησηςανά 1K token βίντεο | Συνθήκες χρέωσηςήχος: without_audio | Χρέωση Έξοδος · Τιμή ανά token βίντεο · Εκτίμηση μόνο για σύγκριση $0.0024 ανά 1K token βίντεο Η τιμή ανά token βίντεο είναι η κύρια αναφορά τιμής. Οι ενδεικτικές εκτιμήσεις ανά δευτερόλεπτο είναι ξεχωριστές αναφορές και όχι πρόσθετη χρέωση. |
| ΔιαμόρφωσηΕκτιμώμενο κόστος δημιουργίας | Πίνακας χρεώσεων— | Προβλεπόμενη ποσότηταεκτίμηση για μία δημιουργία | Μονάδα τιμολόγησης— | Συνθήκες χρέωσης— | Χρέωση Έξοδος · Εκτιμώμενο κόστος δημιουργίας · Εκτίμηση μόνο για σύγκριση $0.05184 εκτίμηση πριν από τη δημιουργία Αυτή η εκτίμηση δεν αποτελεί πρόσθετη χρέωση ούτε σταθερή τιμή για την ολοκληρωμένη παραγωγή. |
Το Ailoot δεσμεύει ένα εκτιμώμενο ποσό πριν από το αίτημα. Μετά το αποτέλεσμα, εκκαθαρίζει την τελική χρέωση βάσει της μετρημένης χρήσης. Η εκκαθάριση ροής χρησιμοποιεί την τελική καταγραφή χρήσης. Πώς λειτουργούν η δέσμευση και η εκκαθάριση →
Στοιχεία τιμοκαταλόγου αναφοράς
Οι πίνακες αναφοράς του μοντέλου δεν αλλάζουν την επιλογή μεθόδου, τις εκτιμήσεις τιμής ή τις χρεώσεις. Οι εφαρμοζόμενες χρεώσεις χρησιμοποιούν τις τιμές της επιλεγμένης μεθόδου Ailoot.
Τιμές αναφοράς για διαμορφώσεις βίντεο
Τιμές ανά διαμόρφωση
Αντιστοιχίστε κάθε χρέωση στις συνθήκες που εμφανίζονται. Χρησιμοποιήστε μία χρέωση ανά σύνολο εναλλακτικών διαμορφώσεων.
| Διαμόρφωση | Συνθήκες χρέωσης | Χρέωση |
|---|---|---|
| ΔιαμόρφωσηΤιμή token βίντεο | Συνθήκες χρέωσηςΔεν δηλώνεται πρόσθετη συνθήκη σε αυτό το κλειδί τιμολόγησης. | Χρέωση Έξοδος · Τιμή ανά token βίντεο $0.0048 ανά 1K token βίντεο Η τιμή ανά token βίντεο είναι η κύρια αναφορά τιμής. Οι ενδεικτικές εκτιμήσεις ανά δευτερόλεπτο είναι ξεχωριστές αναφορές και όχι πρόσθετη χρέωση. |
| ΔιαμόρφωσηΤιμή token βίντεο | Συνθήκες χρέωσηςήχος: without_audio | Χρέωση Έξοδος · Τιμή ανά token βίντεο $0.0024 ανά 1K token βίντεο Η τιμή ανά token βίντεο είναι η κύρια αναφορά τιμής. Οι ενδεικτικές εκτιμήσεις ανά δευτερόλεπτο είναι ξεχωριστές αναφορές και όχι πρόσθετη χρέωση. |
Παραδείγματα αιτημάτων
Ailoot Ultra · Βίντεο
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
from pathlib import Path
Path('request.json').write_text('{"aspect_ratio":"16:9","duration":8,"model":"bytedance/seedance-1-5-pro","prompt":"A serene mountain landscape at sunset","resolution":"720p"}', encoding='utf-8')
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('result.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT
Λήψη και αποθήκευση αποτελεσμάτων
Ailoot Ultra · Βίντεο
υπογεγραμμένα URL περιεχομένου που σας ανήκει
GET /v1/videos/{public_id}GET /v1/videos/{public_id}/content
Έλεγχος κατάστασης εργασίας
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_STATUS_URL'
import json
from pathlib import Path
from urllib.parse import quote
r=json.loads(Path('result.json').read_text())
if not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')
Path('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))
PY_STATUS_URL
curl --fail-with-body --silent --show-error "$(cat status-url.txt)" \
-H "Authorization: Bearer $AILOOT_API_KEY" -D status-headers.txt -o status.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('status.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT
Άλλες ανακτήσεις περιεχομένου
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_ASSETS'
import json,os,subprocess
from pathlib import Path
from urllib.parse import urljoin,urlsplit
r=json.loads(Path('status.json').read_text())
if r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')
if not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')
urls=[]
for i,u in enumerate(r.get('data',[])):
if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')
urls.append((str(i),u))
for label,path in urls:
u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)
if z.scheme!='https' or z.netloc!='api.ailoot.ai' or z.username or z.password:raise SystemExit('Use the actual returned Ailoot owned content URL')
target=Path('owned-'+label+'.bin')
subprocess.run(['curl','--fail-with-body','--silent','--show-error',u,'-H','Authorization: Bearer '+os.environ['AILOOT_API_KEY'],'-D',str(target)+'.headers','-o',str(target)],check=True)
print('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')
PY_ASSETS
Διατηρήστε όλα τα ολοκληρωμένα αποτελέσματα
Αποθηκεύστε κάθε ολοκληρωμένο βίντεο ή αρχείο που επιστρέφεται· ανακτήστε κάθε πραγματικό URL αρχείου που επιστρέφεται.
Διατηρήστε κάθε πραγματική έξοδο που σας ανήκει και τα μετρημένα μεταδεδομένα που επιστρέφονται μαζί της.
Αν χρειάζεται έλεγχος της αρχικής απάντησης
503 result_pending_check + αρχικό id + X-Should-Retry:false· μην επαναλάβετε ποτέ το αρχικό αίτημα
Πεδία απάντησης
| Πεδίο | Τύπος | Σημασία |
|---|---|---|
Πεδίοindex | Τύποςinteger | ΣημασίαΘέση αυτού του βίντεο στη λίστα εξόδων, με αρίθμηση από το μηδέν. |
Πεδίοcontent_url | Τύποςstring | ΣημασίαΥπογεγραμμένο HTTPS URL λήψης για αυτό το ολοκληρωμένο βίντεο. |
Πεδίοsha256 | Τύποςstring | null | ΣημασίαΣύνοψη SHA-256 των αρχικών byte βίντεο· null αν δεν είναι διαθέσιμη. |
Πεδίοsize_bytes | Τύποςinteger | null | ΣημασίαΜέγεθος του αρχικού αρχείου βίντεο σε byte· null αν δεν είναι διαθέσιμο. |
Πεδίοduration_ms | Τύποςinteger | null | ΣημασίαΜετρημένη διάρκεια βίντεο σε χιλιοστά του δευτερολέπτου· null αν δεν είναι διαθέσιμη. |
Πεδίοwidth | Τύποςinteger | null | ΣημασίαΠλάτος βίντεο σε pixel· null αν δεν είναι διαθέσιμο. |
Πεδίοheight | Τύποςinteger | null | ΣημασίαΎψος βίντεο σε pixel· null αν δεν είναι διαθέσιμο. |
Πεδίοvideo_codec | Τύποςstring | null | ΣημασίαΑναγνωριστικό κωδικοποιητή βίντεο· null αν δεν έχει καταγραφεί. |
Πεδίοhas_audio | Τύποςboolean | null | ΣημασίαΑν το βίντεο περιέχει ηχητικό κομμάτι· null αν δεν έχει μετρηθεί. |
Πεδίοaudio_codec | Τύποςstring | null | ΣημασίαΑναγνωριστικό κωδικοποιητή ήχου· null όταν δεν έχει καταγραφεί αναγνωριστικό. |
Σφάλματα και επόμενα βήματα
| Απάντηση | Συνθήκη | Επόμενο βήμα |
|---|---|---|
Απάντηση404 · not_found_error | ΣυνθήκηΗ πρόσβαση στο βίντεο δεν είναι διαθέσιμη ή αυτό το ID βίντεο δεν βρέθηκε. | Επόμενο βήμαΕλέγξτε την πρόσβαση στο βίντεο. Για υπάρχον βίντεο, χρησιμοποιήστε το αρχικό δημόσιο ID του και το ίδιο κλειδί API. |
Απάντηση401 · authentication_error | ΣυνθήκηΤο κλειδί API δεν αντιστοιχεί στον ταυτοποιημένο λογαριασμό. | Επόμενο βήμαΕλέγξτε το κλειδί API και την πρόσβαση του λογαριασμού σας πριν υποβάλετε αίτημα. |
Απάντηση400 · invalid_request_error | ΣυνθήκηΔεν ήταν δυνατή η ανάγνωση του αιτήματος ή ο δείκτης λήψης δεν είναι έγκυρος. | Επόμενο βήμαΔιορθώστε το σώμα αιτήματος. Για λήψη, επιλέξτε δείκτη εξόδου που επιστράφηκε από την αρχική εργασία. |
Απάντηση422 · price_unavailable | ΣυνθήκηΗ επιλεγμένη διαμόρφωση βίντεο δεν μπορεί να τιμολογηθεί. | Επόμενο βήμαΕπιλέξτε μια υποστηριζόμενη διαμόρφωση βίντεο και συμπληρώστε τις απαιτούμενες επιλογές της πριν υποβάλετε διορθωμένο αίτημα. |
Απάντηση422 · invalid_request_error | ΣυνθήκηΜια είσοδος βίντεο ή η αρχική εργασία συνέχισης δεν είναι έγκυρη. | Επόμενο βήμαΧρησιμοποιήστε έγκυρες εισόδους HTTPS. Για συνέχιση, χρησιμοποιήστε το δημόσιο ID του ολοκληρωμένου αρχικού σας βίντεο με το ίδιο κλειδί API. |
Απάντηση402 · billing_error | ΣυνθήκηΤο διαθέσιμο υπόλοιπο ή τα όρια δεν επιτρέπουν δέσμευση ποσού. | Επόμενο βήμαΕλέγξτε το διαθέσιμο υπόλοιπο και τα όριά σας πριν στείλετε νέο αίτημα. |
Απάντηση503 · server_error | ΣυνθήκηΗ επαλήθευση βίντεο, η αποθήκευση ή η πρόσβαση στην υπηρεσία είναι προσωρινά μη διαθέσιμη. | Επόμενο βήμαΠεριμένετε να γίνει διαθέσιμη η υπηρεσία. Αν έχετε ήδη ID βίντεο, ελέγξτε αυτή την αρχική εργασία αντί να ξεκινήσετε άλλη δημιουργία. |
Απάντηση503 · result_pending_check | ΣυνθήκηΤο αρχικό αποτέλεσμα βίντεο και η χρέωση χρειάζονται έλεγχο. | Επόμενο βήμαΔιατηρήστε το ID βίντεο που επιστρέφεται και ελέγξτε αυτή την εργασία. Μην στέλνετε νέο αίτημα δημιουργίας για αντικατάσταση όσο διαρκεί ο έλεγχος. |
Απάντηση503 · owned_result_unavailable | ΣυνθήκηΗ λήψη του υπάρχοντος βίντεο είναι προσωρινά μη διαθέσιμη. | Επόμενο βήμαΕλέγξτε αργότερα την ίδια εργασία βίντεο και κατεβάστε την υπάρχουσα έξοδό της. Μια νέα δημιουργία παράγει ξεχωριστή λειτουργία. |
Απάντηση409 · video_not_ready | ΣυνθήκηΤο περιεχόμενο βίντεο δεν έχει δημοσιευτεί. | Επόμενο βήμαΕλέγξτε την κατάσταση της αρχικής εργασίας. Κατεβάστε το αποτέλεσμα όταν αναφέρει completed· αν αναφέρει failed, ακολουθήστε την ειδοποίησή της για έλεγχο χρέωσης. |
Εναλλακτικά ονόματα
Εναλλακτικά ονόματα μοντέλου
Ailoot Ultra bytedance/seedance-1-5-pro
Εναλλακτικές διαδρομές μεθόδων
Χρησιμοποιήστε τις διαδρομές μεθόδων που εμφανίζονται παραπάνω.
Σχετικά ID μοντέλων
FAQ · ByteDance: Seedance 1.5 Pro
- Ποιες είσοδοι και αποτελέσματα διατίθενται;
POST /v1/videos·bytedance/seedance-1-5-pro:text,image→video- Ποια πεδία χρησιμοποιεί το αίτημα;
POST /v1/videos·bytedance/seedance-1-5-pro:model,prompt,duration,resolution,aspect_ratio,generate_audio,frame_images,input_references,size,seed,callback_url,session_id,trace,user- Ποια όρια ισχύουν;
POST /v1/videos·bytedance/seedance-1-5-pro:duration.minimum:1;duration.maximum:600;frame_images.max_items:2;frame_images.min_items:1;seed.minimum:-9223372036854775808;seed.maximum:9223372036854775807