Black Forest Labs: FLUX.3 Video
Το FLUX 3 Video δημιουργεί αποσπάσματα με συγχρονισμένο διάλογο, εφέ και ήχους περιβάλλοντος από κείμενο, καθορισμένες εικόνες ή απόσπασμα προς συνέχεια. Τα καρέ-κλειδιά, η σύνθεση πολλών πλάνων και η ενίσχυση προσχεδίου βοηθούν στην ανάπτυξη ελεγχόμενης ακολουθίας και στη διατήρηση της επιλεγμένης λήψης.
Σχετικά με το μοντέλο
Αυτή η περιγραφή καλύπτει τις δυνατότητες του μοντέλου. Οι είσοδοι, έξοδοι και επιλογές που διατίθενται στο Ailoot παρατίθενται παρακάτω για την επιλεγμένη μέθοδο.
Το FLUX 3 Video είναι το πολυτροπικό μοντέλο της Black Forest Labs για παραγωγή βίντεο με συγχρονισμένο ήχο. Δημιουργεί σκηνές από γραπτή οδηγία, χτίζει κίνηση γύρω από καθορισμένες εικόνες ή συνεχίζει υπάρχον απόσπασμα. Ομιλία, εφέ και ήχοι περιβάλλοντος μπορούν να παράγονται μαζί με τα καρέ, υποστηρίζοντας σύντομη σκηνή της οποίας η κίνηση κάμερας, η δράση και ο ήχος σχεδιάζονται ως μία ακολουθία.
Για μετατροπή κειμένου σε βίντεο, περιγράψτε θέμα, σκηνικό, ορατή δράση, συμπεριφορά κάμερας και ήχο. Μια χρήσιμη σκηνή προϊόντος μπορεί να αρχίζει με γενική άποψη, να κινείται προς λεπτομέρεια υλικού και να τελειώνει με το προϊόν σε χρήση. Οι οδηγίες πολλών πλάνων μπορούν να κατονομάζουν κάθε πλάνο και τη μετάβαση μεταξύ γωνιών κάμερας, διατηρώντας συνεπή το θέμα και το οπτικό ύφος στην ακολουθία. Η τυπογραφία μπορεί να εμφανίζεται μέσα στη σκηνή, επομένως δώστε τις ακριβείς λέξεις και τη θέση τους όταν μια πινακίδα ή ένας τίτλος έχει σημασία. Το μοντέλο καλύπτει ζωντανή δράση, κινούμενα σχέδια, γραφικά κίνησης και στιλιζαρισμένες εμφανίσεις.
Η μετατροπή εικόνας σε βίντεο χρησιμοποιεί μία έως δέκα εικόνες καρέ-κλειδιών. Μία εικόνα ορίζει το αρχικό καρέ· ένα ζεύγος καθορίζει αρχή και τέλος, ενώ διατεταγμένες εικόνες με χρονικές σημάνσεις καθοδηγούν συγκεκριμένες στιγμές του αποσπάσματος. Αυτές οι εικόνες γίνονται καρέ του βίντεο αντί να λειτουργούν μόνο ως γενικές αναφορές ύφους. Με τρεις ή περισσότερες εικόνες χωρίς χρονικές σημάνσεις, ο κατασκευαστής απαιτεί ρητή διάρκεια: η πρώτη και η τελευταία καθορίζουν τα άκρα και οι άλλες τοποθετούνται ομοιόμορφα ανάμεσά τους. Τα καρέ με χρονικές σημάνσεις πρέπει να είναι σε χρονική σειρά· η αυτόματη διάρκεια φτάνει έως την τελευταία χρονική σήμανση στρογγυλοποιημένη προς τα πάνω, εντός του μέγιστου ορίου 20 δευτερολέπτων. Προετοιμάστε καρέ-κλειδιά με συμβατά θέματα, κάδρο και οπτική λεπτομέρεια και περιγράψτε την κίνηση μεταξύ τους. Για αποκάλυψη προϊόντος, το πρώτο καρέ μπορεί να δείχνει το κλειστό αντικείμενο και το τελευταίο την ανοιχτή διάταξη, με την ενδιάμεση δράση ορισμένη στην προτροπή.
Η συνέχεια βίντεο ξεκινά από τα τελευταία καρέ του παρεχόμενου αποσπάσματος. Η ροή της κυκλοφορίας χρησιμοποιεί έως τέσσερα δευτερόλεπτα υπάρχοντος βίντεο και ήχου ως συμφραζόμενα για την επόμενη δράση, μεταφέροντας συμπεριφορά κάμερας, κίνηση και ήχο στην ένωση. Επιλέξτε τέλος πηγής που ορίζει σαφώς πού κινούνται το θέμα και η κάμερα και περιγράψτε τι συμβαίνει έπειτα. Η συνέχεια διαφέρει από την επανασυγγραφή υπάρχοντος πλάνου: το FLUX Video Edit είναι ξεχωριστό μοντέλο επεξεργασίας και δεν γίνεται μέρος του μοντέλου παραγωγής μόνο επειδή και τα δύο δέχονται βίντεο.
Η παραγωγή βάσει κειμένου και εικόνας υποστηρίζει αποσπάσματα από 5 έως 20 δευτερόλεπτα. Η επισκόπηση ανά λειτουργία δίνει για τη συνέχεια βίντεο εύρος εξόδου 5–15 δευτερολέπτων. Η διάρκεια και η αναλογία διαστάσεων μπορούν να επιλέγονται αυτόματα ή η οδηγία μπορεί να προσδιορίζει υποστηριζόμενο οριζόντιο, τετράγωνο ή κατακόρυφο σχήμα, συμπεριλαμβανομένων των 21:9, 2:1, 16:9, 4:3, 1:1, 3:4, 9:16 και 9:21. Η έξοδος είναι 24 καρέ ανά δευτερόλεπτο. Επιλέξτε διάρκεια γύρω από μικρό αριθμό ορατών ενεργειών αντί να προσπαθείτε να χωρέσετε ολόκληρη ιστορία σε μία σύντομη παραγωγή.
Η έξοδος HD προέρχεται απευθείας από την παραγωγή· τα FHD, QHD και UHD ολοκληρώνουν την ίδια σκηνή με εργαλείο αύξησης ανάλυσης βίντεο. Για 16:9, οι παραδοθείσες διαστάσεις είναι αντίστοιχα 1280 × 704, 1920 × 1088, 2560 × 1440 και 3840 × 2176. Οι διαστάσεις ευθυγραμμίζονται σε πολλαπλάσια του 32, επομένως μια ονομαστική κατηγορία ανάλυσης μπορεί να διαφέρει από συμβατικό μέγεθος παράδοσης. Περικόψτε το ολοκληρωμένο καρέ όταν χρειάζεται ακριβής τυπικός καμβάς, διατηρώντας το σημαντικό περιεχόμενο στις άκρες του. Η υψηλότερη ανάλυση είναι στάδιο ολοκλήρωσης και όχι διαφορετική ερμηνεία του πλάνου.
Ο εγγενής ήχος είναι ενεργοποιημένος από προεπιλογή και μπορεί να απενεργοποιηθεί για σιωπηλό απόσπασμα. Για διάλογο, παραθέστε την ατάκα, προσδιορίστε τον ομιλητή και περιγράψτε την εκφορά της· η πολύγλωσση ομιλία, οι προφορές και ο συγχρονισμός χειλιών ανήκουν στις οπτικοακουστικές δυνατότητες του μοντέλου. Συνδέστε τον διάλογο και τις ηχητικές οδηγίες με το ορατό συμβάν, όπως ένα καπάκι που κλείνει ή βήματα που απομακρύνονται. Ελέγξτε τη φωνή, τον χρονισμό και την εκφωνούμενη διατύπωση μαζί με την εικόνα, αντί να αντιμετωπίζετε τον ήχο ως άσχετη στρώση που προστίθεται μετά την παραγωγή.
Η λειτουργία Draft παράγει προεπισκόπηση HD και πακέτο προσχεδίου. Ενισχύστε το επιλεγμένο πακέτο για να αποδώσετε εκείνη την παραγωγή σε πλήρη ποιότητα· η αποστολή της ίδιας προτροπής ως νέο αίτημα πλήρους απόδοσης είναι νέα ερμηνεία και μπορεί να παράγει διαφορετική λήψη. Τα προσχέδια χρησιμοποιούν μόνο HD, ενώ η ενίσχυση μπορεί να επιλέγει τις τέσσερις κατηγορίες ανάλυσης και έχει προεπιλογή FHD. Αυτό δίνει μια πρακτική ακολουθία διερεύνησης δράσης και σύνθεσης πρώτα και ολοκλήρωσης της επιλεγμένης λήψης στο επιδιωκόμενο μέγεθος παράδοσης έπειτα.
Η ροή του κατασκευαστή επιστρέφει αναγνωριστικό εργασίας πριν ετοιμαστεί το MP4 και στη συνέχεια παρέχει το ολοκληρωμένο απόσπασμα όταν τελειώσει η επεξεργασία. Οι υπογεγραμμένες θέσεις αποτελεσμάτων λήγουν έπειτα από περίπου δύο ώρες, επομένως διατηρήστε το πραγματικό στοιχείο μόλις επιλεγεί το πλάνο. Επιθεωρήστε τις μεταβάσεις καρέ-κλειδιών, τα κοψίματα, την τυπογραφία, τις λεπτομέρειες θέματος και την ηχητική ένωση σε σχέση με την οδηγία. Για μεγαλύτερη ακολουθία, διατηρήστε τις αναφορές και τα τελικά συμφραζόμενα του επιτυχημένου πλάνου ως είσοδο στο επόμενο απόσπασμα, αντί να υποθέτετε ότι ένα σύντομο αίτημα περιέχει ολόκληρη την παραγωγή.
Ailoot Ultra · Βίντεο POST /v1/videos black-forest-labs/flux-3-video
black-forest-labs/flux-3-video
black-forest-labs/flux-3-videoΕισαγωγή
Το FLUX 3 Video δημιουργεί αποσπάσματα με συγχρονισμένο διάλογο, εφέ και ήχους περιβάλλοντος από κείμενο, καθορισμένες εικόνες ή απόσπασμα προς συνέχεια. Τα καρέ-κλειδιά, η σύνθεση πολλών πλάνων και η ενίσχυση προσχεδίου βοηθούν στην ανάπτυξη ελεγχόμενης ακολουθίας και στη διατήρηση της επιλεγμένης λήψης.
- Αποδεκτές είσοδοι
- Κείμενο · Εικόνες
- Αποτελέσματα
- Βίντεο
Διαθέσιμα στο Ailoot · είσοδοι και μέθοδοι
Ailoot Ultra · Βίντεο POST /v1/videos
- Είσοδος
text,image- Έξοδος
video- Μορφή εξόδου
- αρχικά byte του MP4· χωρίς κανονικοποίηση ή διακωδικοποίηση
| Πεδίο | Τύπος | Απαίτηση | Τιμές και όρια | Προεπιλογή |
|---|---|---|---|---|
Πεδίοmodel | Τύποςstring | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια black-forest-labs/flux-3-video | Προεπιλογή— |
Πεδίοprompt | Τύποςstring | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια | Προεπιλογή— |
Πεδίοduration | Τύποςinteger | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20 Ελάχιστο: 1 Μέγιστο: 600 | Προεπιλογή— |
Πεδίοresolution | Τύποςstring | ΑπαίτησηΠροαιρετικό | Τιμές και όρια 720p, 1080p | Προεπιλογή— |
Πεδίοaspect_ratio | Τύποςstring | ΑπαίτησηΠροαιρετικό | Τιμές και όρια 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 | Προεπιλογή— |
Πεδίοgenerate_audio | Τύποςboolean | ΑπαίτησηΠροαιρετικό | Τιμές και όρια false, true | Προεπιλογή— |
Πεδίο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 | ΑπαίτησηΠροαιρετικό | Τιμές και όρια | Προεπιλογή— |
Πεδίοprevious_job_id | Τύποςstring | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Μοτίβο: ^video_[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$ | Προεπιλογή— |
Πεδίοcallback_url | Τύποςstring | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Μοτίβο: ^https:// | Προεπιλογή— |
Πεδίοsession_id | Τύποςstring | ΑπαίτησηΠροαιρετικό | Τιμές και όρια | Προεπιλογή— |
Πεδίοtrace | Τύποςobject | ΑπαίτησηΠροαιρετικό | Τιμές και όρια | Προεπιλογή— |
Πεδίοuser | Τύποςstring | ΑπαίτησηΠροαιρετικό | Τιμές και όρια | Προεπιλογή— |
Συνδυασμοί υλικών εισόδου
Κείμενο σε βίντεο · Μια γραπτή προτροπή. · Υποχρεωτικό: model, prompt, duration
Δώστε την προτροπή ως κείμενο και τη διάρκεια σε ακέραια δευτερόλεπτα. Επιλέξτε υποστηριζόμενη ανάλυση και, αν χρειάζεται, αναλογία διαστάσεων.
model: Τύπος: string · black-forest-labs/flux-3-video
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 · black-forest-labs/flux-3-video
prompt: Τύπος: string · Μέγιστο πλήθος byte UTF-8: 10.000 · Απαιτείται περιεχόμενο πέρα από κενά διαστήματα: Ναι
Continue a video · Μια γραπτή προτροπή και το ολοκληρωμένο αρχικό σας βίντεο. · Υποχρεωτικό: model, prompt, duration, previous_job_id
Ορίστε το previous_job_id στο δημόσιο ID βίντεο του ολοκληρωμένου αρχικού σας αποτελέσματος. Χρησιμοποιήστε το ίδιο μοντέλο, λογαριασμό και κλειδί API. Διατηρήστε την υπάρχουσα ταυτότητα της εργασίας· αυτό το αίτημα δημιουργεί ξεχωριστή εργασία συνέχισης. Επιλέξτε υποστηριζόμενη ανάλυση και, αν χρειάζεται, αναλογία διαστάσεων.
model: Τύπος: string · black-forest-labs/flux-3-video
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, previous_job_id, 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 |
| ΔιαμόρφωσηΚείμενο σε βίντεο · Εικόνα σε βίντεο (εικόνες καρέ) · τιμή αναφοράς | Πίνακας χρεώσεων— | Προβλεπόμενη ποσότητα— | Στοιχείο χρέωσηςreference_output_rate | Λειτουργία αναφοράςΚείμενο σε βίντεο · Εικόνα σε βίντεο (εικόνες καρέ) | Μονάδα τιμολόγησηςανά δευτερόλεπτο εξόδου | Συνθήκες χρέωσης— | Χρέωση Έξοδος · Τιμή αναφοράς ανά δευτερόλεπτο βίντεο εξόδου · Εκτίμηση μόνο για σύγκριση $0.34 ανά δευτερόλεπτο εξόδου |
| ΔιαμόρφωσηΤιμή βίντεο | Πίνακας χρεώσεων— | Προβλεπόμενη ποσότητα— | Στοιχείο χρέωσης— | Λειτουργία αναφοράς— | Μονάδα τιμολόγησηςανά δευτερόλεπτο βίντεο | Συνθήκες χρέωσηςresolution: 1080p | Χρέωση Έξοδος · Τιμή βίντεο · Εκτίμηση μόνο για σύγκριση $0.58 ανά δευτερόλεπτο βίντεο |
| ΔιαμόρφωσηΤιμή βίντεο | Πίνακας χρεώσεων— | Προβλεπόμενη ποσότητα— | Στοιχείο χρέωσης— | Λειτουργία αναφοράς— | Μονάδα τιμολόγησηςανά δευτερόλεπτο βίντεο | Συνθήκες χρέωσηςresolution: 720p | Χρέωση Έξοδος · Τιμή βίντεο · Εκτίμηση μόνο για σύγκριση $0.34 ανά δευτερόλεπτο βίντεο |
| ΔιαμόρφωσηΤιμή βίντεο | Πίνακας χρεώσεων— | Προβλεπόμενη ποσότητα— | Στοιχείο χρέωσης— | Λειτουργία αναφοράς— | Μονάδα τιμολόγησηςανά δευτερόλεπτο βίντεο | Συνθήκες χρέωσηςείσοδος: video_continuation; ανάλυση: 1080p | Χρέωση Έξοδος · Τιμή βίντεο · Εκτίμηση μόνο για σύγκριση $1.06 ανά δευτερόλεπτο βίντεο |
| ΔιαμόρφωσηΤιμή βίντεο | Πίνακας χρεώσεων— | Προβλεπόμενη ποσότητα— | Στοιχείο χρέωσης— | Λειτουργία αναφοράς— | Μονάδα τιμολόγησηςανά δευτερόλεπτο βίντεο | Συνθήκες χρέωσηςείσοδος: video_continuation; ανάλυση: 720p | Χρέωση Έξοδος · Τιμή βίντεο · Εκτίμηση μόνο για σύγκριση $0.82 ανά δευτερόλεπτο βίντεο |
| ΔιαμόρφωσηΕκτιμώμενο κόστος δημιουργίας | Πίνακας χρεώσεων— | Προβλεπόμενη ποσότηταεκτίμηση για μία δημιουργία | Στοιχείο χρέωσης— | Λειτουργία αναφοράς— | Μονάδα τιμολόγησης— | Συνθήκες χρέωσης— | Χρέωση Έξοδος · Εκτιμώμενο κόστος δημιουργίας · Εκτίμηση μόνο για σύγκριση $1.7 εκτίμηση πριν από τη δημιουργία Αυτή η εκτίμηση δεν αποτελεί πρόσθετη χρέωση ούτε σταθερή τιμή για την ολοκληρωμένη παραγωγή. |
Το Ailoot δεσμεύει ένα εκτιμώμενο ποσό πριν από το αίτημα. Μετά το αποτέλεσμα, εκκαθαρίζει την τελική χρέωση βάσει της μετρημένης χρήσης. Η εκκαθάριση ροής χρησιμοποιεί την τελική καταγραφή χρήσης. Πώς λειτουργούν η δέσμευση και η εκκαθάριση →
Στοιχεία τιμοκαταλόγου αναφοράς
Οι πίνακες αναφοράς του μοντέλου δεν αλλάζουν την επιλογή μεθόδου, τις εκτιμήσεις τιμής ή τις χρεώσεις. Οι εφαρμοζόμενες χρεώσεις χρησιμοποιούν τις τιμές της επιλεγμένης μεθόδου Ailoot.
Τιμές αναφοράς για διαμορφώσεις βίντεο
Τιμές ανά διαμόρφωση
Αντιστοιχίστε κάθε χρέωση στις συνθήκες που εμφανίζονται. Χρησιμοποιήστε μία χρέωση ανά σύνολο εναλλακτικών διαμορφώσεων.
| Διαμόρφωση | Συνθήκες χρέωσης | Χρέωση |
|---|---|---|
| ΔιαμόρφωσηΤιμή βίντεο | Συνθήκες χρέωσηςΔεν δηλώνεται πρόσθετη συνθήκη σε αυτό το κλειδί τιμολόγησης. | Χρέωση Έξοδος · Τιμή βίντεο $0.34 ανά δευτερόλεπτο βίντεο Δημοσιευμένη αναφορά τιμής για την εμφανιζόμενη διαμόρφωση. Οι τελικές χρεώσεις ακολουθούν την πραγματική διαμόρφωση που χρεώθηκε. |
| ΔιαμόρφωσηΤιμή βίντεο | Συνθήκες χρέωσηςresolution: 720p | Χρέωση Έξοδος · Τιμή βίντεο $0.34 ανά δευτερόλεπτο βίντεο Δημοσιευμένη αναφορά τιμής για την εμφανιζόμενη διαμόρφωση. Οι τελικές χρεώσεις ακολουθούν την πραγματική διαμόρφωση που χρεώθηκε. |
| ΔιαμόρφωσηΤιμή βίντεο | Συνθήκες χρέωσηςresolution: 1080p | Χρέωση Έξοδος · Τιμή βίντεο $0.58 ανά δευτερόλεπτο βίντεο Δημοσιευμένη αναφορά τιμής για την εμφανιζόμενη διαμόρφωση. Οι τελικές χρεώσεις ακολουθούν την πραγματική διαμόρφωση που χρεώθηκε. |
| ΔιαμόρφωσηΤιμή βίντεο | Συνθήκες χρέωσηςείσοδος: video_continuation; ανάλυση: 720p | Χρέωση Έξοδος · Τιμή βίντεο $0.82 ανά δευτερόλεπτο βίντεο Δημοσιευμένη αναφορά τιμής για την εμφανιζόμενη διαμόρφωση. Οι τελικές χρεώσεις ακολουθούν την πραγματική διαμόρφωση που χρεώθηκε. |
| ΔιαμόρφωσηΤιμή βίντεο | Συνθήκες χρέωσηςείσοδος: video_continuation; ανάλυση: 1080p | Χρέωση Έξοδος · Τιμή βίντεο $1.06 ανά δευτερόλεπτο βίντεο Δημοσιευμένη αναφορά τιμής για την εμφανιζόμενη διαμόρφωση. Οι τελικές χρεώσεις ακολουθούν την πραγματική διαμόρφωση που χρεώθηκε. |
Παραδείγματα αιτημάτων
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":"black-forest-labs/flux-3-video","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 black-forest-labs/flux-3-video
Εναλλακτικές διαδρομές μεθόδων
Χρησιμοποιήστε τις διαδρομές μεθόδων που εμφανίζονται παραπάνω.
Σχετικά ID μοντέλων
FAQ · Black Forest Labs: FLUX.3 Video
- Ποιες είσοδοι και αποτελέσματα διατίθενται;
POST /v1/videos·black-forest-labs/flux-3-video:text,image→video- Ποια πεδία χρησιμοποιεί το αίτημα;
POST /v1/videos·black-forest-labs/flux-3-video:model,prompt,duration,resolution,aspect_ratio,generate_audio,frame_images,input_references,previous_job_id,callback_url,session_id,trace,user- Ποια όρια ισχύουν;
POST /v1/videos·black-forest-labs/flux-3-video:duration.minimum:1;duration.maximum:600;frame_images.max_items:2;frame_images.min_items:1