μοντέλα

MiniMax: H3 Max

Markdown · JSON

MiniMax: H3 Max

Το MiniMax H3 Max είναι γρήγορη παραλλαγή H3 με μετεκπαίδευση για σύντομο βίντεο με συγχρονισμένο ήχο. Η τεκμηριωμένη ροή της MiniMax υποστηρίζει κείμενο, εικόνες καρέ και πολυτροπικές αναφορές, με έξοδο 480P ή 768P, διάρκεια 5–15 δευτερολέπτων και δικές της επιλογές επέκτασης προτροπής.

Σχετικά με το μοντέλο

Αυτή η περιγραφή καλύπτει τις δυνατότητες του μοντέλου. Οι είσοδοι, έξοδοι και επιλογές που διατίθενται στο Ailoot παρατίθενται παρακάτω για την επιλεγμένη μέθοδο.

Μια γρήγορη παραλλαγή H3 με μετεκπαίδευση

Το MiniMax H3 Max είναι παραλλαγή του βασικού μοντέλου MiniMax H3 με μετεκπαίδευση, βελτιστοποιημένη για ταχύτερη παραγωγή, τήρηση προτροπής και οπτικοακουστική ποιότητα. Η παραλλαγή αναπτύχθηκε μέσω μετεκπαίδευσης από τη fal Research. Διατηρεί ενιαία πολυτροπικά συμφραζόμενα και εγγενώς συγχρονισμένη εικόνα και ήχο. Η ταχύτητα είναι σχεδιαστική προτεραιότητα και όχι σταθερός χρόνος ολοκλήρωσης για κάθε προτροπή, διάρκεια ή εφαρμογή.

Κρατήστε το Max διακριτό από το αρχικό σύστημα H3 και από την ξεχωριστή παραλλαγή Max Turbo. Η τρέχουσα διεπαφή της MiniMax παραθέτει το Max σε 480P ή 768P, με προεπιλογή 768P, 24 καρέ ανά δευτερόλεπτο και ακέραια διάρκεια από 5 έως 15 δευτερόλεπτα. Η τεκμηριωμένη ροή Max δεν προσφέρει τη ρύθμιση 2K του αρχικού συστήματος H3 ούτε έξοδο τεσσάρων δευτερολέπτων.

Από προτροπή σε πλάνο

Κάθε παραγωγή περιλαμβάνει μη κενή γραπτή οδηγία, έως 7.000 χαρακτήρες ανά στοιχείο κειμένου. Περιγράψτε θέμα, αρχική σύνθεση, δράση και αποτέλεσμα και έπειτα κάντε σαφείς τις οδηγίες κάμερας και ήχου. Για σύντομη αποκάλυψη αντικειμένου, προσδιορίστε τι πρέπει να δει πρώτα ο θεατής, πώς το αντικείμενο εισέρχεται στο οπτικό πεδίο και πώς πρέπει να τελειώσει το πλάνο.

Μια χρήσιμη οδηγία πέντε δευτερολέπτων θα μπορούσε να περιγράφει κεραμικό φλιτζάνι σε ξύλινο τραπέζι, χέρι που τοποθετεί πιατάκι δίπλα του, μικρή κίνηση προσέγγισης κάμερας και τον ήχο κεραμικού που ακουμπά ξύλο. Κρατήστε τη δράση αρκετά μικρή ώστε να χωρά στην επιλεγμένη διάρκεια και επιθεωρήστε αν η επιστρεφόμενη κίνηση και ο ήχος ακολουθούν το ίδιο συμβάν.

Δημιουργία με καθοδήγηση καρέ

Ο κατασκευαστής τεκμηριώνει αρχικό καρέ, τελικό καρέ ή και τα δύο. Μια πρώτη εικόνα ορίζει πού ξεκινά το απόσπασμα· μια τελευταία εικόνα ορίζει την τελική οπτική κατάσταση. Εξηγήστε την κίνηση που τα συνδέει, συμπεριλαμβανομένων αλλαγών σε στάση, θέση αντικειμένου, κάμερα ή φωτισμό. Για μετάβαση δύο καρέ, αποφύγετε οδηγία που εισάγει ασύμβατη σκηνή μεταξύ των άκρων της.

Η έξοδος με καθοδήγηση καρέ αντλεί την αναλογία διαστάσεων από την εικόνα εισόδου. Για εργασία μόνο από κείμενο, επιλέξτε συγκεκριμένη αναλογία από 21:9, 16:9, 4:3, 1:1, 3:4 ή 9:16. Η εργασία με καθοδήγηση αναφορών μπορεί να χρησιμοποιεί προσαρμοστική αναλογία ή μία από τις τεκμηριωμένες ρητές επιλογές. Συνθέστε την αναφορά ή τη γραπτή σκηνή για το καρέ-στόχο αντί να υποθέτετε ότι η ίδια διάταξη λειτουργεί εξίσου καλά κατακόρυφα και οριζόντια.

Πολυτροπικές αναφορές

Το τρέχον σχήμα παραγωγής Max της MiniMax τεκμηριώνει επίσης εικόνες, βίντεο και ήχο αναφοράς. Δηλώστε τι πρέπει να επηρεάζει κάθε στοιχείο: ταυτότητα χαρακτήρα, περιβάλλον, μοτίβο κίνησης, τροχιά κάμερας, χροιά φωνής ή ηχητικό χαρακτηριστικό. Οι ρόλοι πρώτου/τελευταίου καρέ και οι ρόλοι μέσων αναφοράς αλληλοαποκλείονται σε αυτή τη διεπαφή.

Για πλάνο χαρακτήρα, προσδιορίστε χωριστά την αναφορά εμφάνισης και την αναφορά κίνησης και έπειτα δώστε τη δράση-στόχο και την ατάκα. Μια αναφορά φωνής που ορίζει την εκφορά διαφέρει από την αντιγραφή ολόκληρου του ηχητικού σήματός της. Κρατήστε την οδηγία ρητή ως προς τα χαρακτηριστικά που διατηρούνται και τις αλλαγές που γίνονται και ελέγξτε το πραγματικό οπτικοακουστικό απόσπασμα σε σχέση με κάθε ρόλο αναφοράς.

Επέκταση προτροπής

Η ρύθμιση επέκτασης ειδικά για το Max προσφέρει επιλογές disabled, balanced και quality, με προεπιλογή balanced. Επιλέξτε disabled όταν η παρεχόμενη οδηγία πρέπει να περάσει χωρίς επέκταση· χρησιμοποιήστε τεκμηριωμένη λειτουργία επέκτασης όταν επιθυμείται πρόσθετη ερμηνεία. Διατηρήστε την αρχική οδηγία, ώστε μια αλλαγή που εισάγεται κατά την επέκταση να διακρίνεται από το ζητούμενο περιεχόμενο.

Περιγράψτε τον ήχο ως μέρος της σκηνής. Προσδιορίστε φυσικούς ήχους, ατμόσφαιρα και κάθε εκφωνούμενη λέξη και διαχωρίστε τα από μουσική υπόκρουση που ακούει μόνο το κοινό. Δώστε την ακριβή ατάκα και τον επιδιωκόμενο ομιλητή αντί να ζητάτε απροσδιόριστο διάλογο. Ακούστε το αποτέλεσμα καθώς και παρακολουθήστε το· μια πειστική εικόνα δεν αποδεικνύει ότι η προφορική διατύπωση ή ο χρονισμός είναι σωστά.

Προετοιμασία εισόδου και όρια

Το τρέχον σχήμα του κατασκευαστή δέχεται εικόνες JPG, JPEG, PNG, WebP, HEIC ή HEIF, έως 30 MB η καθεμία, με πλευρές από 256 έως 5.760 pixel και αναλογίες από 0.4 έως 2.5. Οι ρόλοι αρχής και τέλους επιτρέπουν από μία εικόνα ο καθένας· η λειτουργία αναφορών επιτρέπει έως εννέα εικόνες. Διατηρήστε καθαρή άποψη του θέματος και των λεπτομερειών που πρέπει να παραμείνουν αναγνωρίσιμες.

Το βίντεο αναφοράς επιτρέπει έως τρία αποσπάσματα MP4 ή MOV, το καθένα 2–15 δευτερόλεπτα και όλα μαζί έως 15 δευτερόλεπτα, με όριο 50 MB ανά αρχείο. Τεκμηριώνει βίντεο H.264 ή H.265, ήχο AAC ή MP3, πλευρές από 256 έως 5.760 pixel, αναλογίες από 0.4 έως 2.5 και ρυθμό καρέ από 23.976 έως 60. Ο ήχος αναφοράς επιτρέπει έως τρία αποσπάσματα WAV ή MP3, το καθένα έως 15 MB και 2–15 δευτερόλεπτα, όλα μαζί έως 15 δευτερόλεπτα. Το σώμα αιτήματος έχει ξεχωριστό όριο 64 MB.

Χρησιμοποιήστε μόνο αναφορές που συνεισφέρουν στο πλάνο και προσδιορίστε κάθε συνεισφορά στο κείμενο. Ένα σύντομο, σχετικό απόσπασμα κίνησης χρησιμοποιείται ευκολότερα ως κατεύθυνση από μια μεγάλη συλλογή άσχετων συμβάντων. Κρατήστε ρητή την επιδιωκόμενη διάρκεια και την ανάλυση εξόδου, ώστε το αποτέλεσμα να μπορεί να συγκριθεί με την ίδια οδηγία.

Το ολοκληρωμένο αποτέλεσμα

Η ασύγχρονη ροή του κατασκευαστή επιστρέφει ταυτότητα εργασίας πριν γίνει διαθέσιμο το ολοκληρωμένο βίντεο. Η διεπαφή αναζήτησης εργασιών ανακτά εργασίες των προηγούμενων επτά ημερών. Αποθηκεύστε το πραγματικό επιστρεφόμενο απόσπασμα και την προδιαγραφή του για μοντάζ ή περαιτέρω έλεγχο· ένα αναγνωριστικό εργασίας δεν είναι το οπτικοακουστικό τεχνούργημα. Οι διευθύνσεις λήψης έχουν περιορισμένη διάρκεια ισχύος, επομένως κρατήστε το ίδιο το αρχείο όταν διατηρείτε επιλεγμένο αποτέλεσμα.

Ελέγξτε τη συνέχεια θέματος, την κίνηση, το ορατό κείμενο, τον διάλογο και τον χρονισμό ήχου στο μέγεθος χρήσης του αποσπάσματος. Χρησιμοποιήστε συγκεκριμένη ανατροφοδότηση για άλλη δημιουργική οδηγία: τη χειρονομία που άλλαξε, την ατάκα που παραλείφθηκε ή το κάδρο που χρειάζεται προσαρμογή. Το χρήσιμο αποτέλεσμα είναι σύντομο οπτικοακουστικό πλάνο συνδεδεμένο με το παρεχόμενο περιεχόμενο και τις ρητές σχέσεις αναφορών του.

Ailoot Ultra · Βίντεο POST /v1/videos minimax/hailuo-3-max

minimax/hailuo-3-max

MiniMax /minimax/hailuo-3-max

Εισαγωγή

Το MiniMax H3 Max είναι γρήγορη παραλλαγή H3 με μετεκπαίδευση για σύντομο βίντεο με συγχρονισμένο ήχο. Η τεκμηριωμένη ροή της MiniMax υποστηρίζει κείμενο, εικόνες καρέ και πολυτροπικές αναφορές, με έξοδο 480P ή 768P, διάρκεια 5–15 δευτερολέπτων και δικές της επιλογές επέκτασης προτροπής.

Αποδεκτές είσοδοι
Κείμενο · Εικόνες
Αποτελέσματα
Βίντεο

Διαθέσιμα στο Ailoot · είσοδοι και μέθοδοι

Ailoot Ultra · Βίντεο POST /v1/videos
Είσοδος
text, image
Έξοδος
video
Μορφή εξόδου
αρχικά byte του MP4· χωρίς κανονικοποίηση ή διακωδικοποίηση
ΠεδίοΤύποςΑπαίτησηΤιμές και όριαΠροεπιλογή
ΠεδίοmodelΤύποςstringΑπαίτησηΥποχρεωτικόΤιμές και όρια
minimax/hailuo-3-max
Προεπιλογή—
ΠεδίοpromptΤύποςstringΑπαίτησηΥποχρεωτικόΤιμές και όριαΠροεπιλογή—
ΠεδίοdurationΤύποςintegerΑπαίτησηΥποχρεωτικόΤιμές και όρια
5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15
Ελάχιστο: 1
Μέγιστο: 600
Προεπιλογή—
ΠεδίοresolutionΤύποςstringΑπαίτησηΠροαιρετικόΤιμές και όρια
768p, 480p
Προεπιλογή—
Πεδίοaspect_ratioΤύποςstringΑπαίτησηΠροαιρετικόΤιμές και όρια
21:9, 16:9, 4:3, 1:1, 3:4, 9:16
Προεπιλογή—
Πεδίοgenerate_audioΤύποςbooleanΑπαίτησηΠροαιρετικόΤιμές και όρια
false
Προεπιλογή—
Πεδίο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ΑπαίτησηΠροαιρετικόΤιμές και όριαΠροεπιλογή—
Πεδίοcallback_urlΤύποςstringΑπαίτησηΠροαιρετικόΤιμές και όρια
Μοτίβο: ^https://
Προεπιλογή—
Πεδίοsession_idΤύποςstringΑπαίτησηΠροαιρετικόΤιμές και όριαΠροεπιλογή—
ΠεδίοtraceΤύποςobjectΑπαίτησηΠροαιρετικόΤιμές και όριαΠροεπιλογή—
ΠεδίοuserΤύποςstringΑπαίτησηΠροαιρετικόΤιμές και όριαΠροεπιλογή—
Συνδυασμοί υλικών εισόδου

Κείμενο σε βίντεο · Μια γραπτή προτροπή. · Υποχρεωτικό: model, prompt, duration

Δώστε την προτροπή ως κείμενο και τη διάρκεια σε ακέραια δευτερόλεπτα. Επιλέξτε υποστηριζόμενη ανάλυση και, αν χρειάζεται, αναλογία διαστάσεων.

model: Τύπος: string · minimax/hailuo-3-max

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 · minimax/hailuo-3-max

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, 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.16 ανά δευτερόλεπτο εξόδου
ΔιαμόρφωσηΤιμή βίντεοΠίνακας χρεώσεων—Προβλεπόμενη ποσότητα—Στοιχείο χρέωσης—Μονάδα τιμολόγησηςανά δευτερόλεπτο βίντεοΣυνθήκες χρέωσηςresolution: 480pΧρέωση
Έξοδος · Τιμή βίντεο · Εκτίμηση μόνο για σύγκριση $0.1 ανά δευτερόλεπτο βίντεο
ΔιαμόρφωσηΤιμή βίντεοΠίνακας χρεώσεων—Προβλεπόμενη ποσότητα—Στοιχείο χρέωσης—Μονάδα τιμολόγησηςανά δευτερόλεπτο βίντεοΣυνθήκες χρέωσηςresolution: 768pΧρέωση
Έξοδος · Τιμή βίντεο · Εκτίμηση μόνο για σύγκριση $0.16 ανά δευτερόλεπτο βίντεο
ΔιαμόρφωσηΕκτιμώμενο κόστος δημιουργίαςΠίνακας χρεώσεων—Προβλεπόμενη ποσότηταεκτίμηση για μία δημιουργίαΣτοιχείο χρέωσης—Μονάδα τιμολόγησης—Συνθήκες χρέωσης—Χρέωση
Έξοδος · Εκτιμώμενο κόστος δημιουργίας · Εκτίμηση μόνο για σύγκριση $0.5 εκτίμηση πριν από τη δημιουργία

Αυτή η εκτίμηση δεν αποτελεί πρόσθετη χρέωση ούτε σταθερή τιμή για την ολοκληρωμένη παραγωγή.

Το Ailoot δεσμεύει ένα εκτιμώμενο ποσό πριν από το αίτημα. Μετά το αποτέλεσμα, εκκαθαρίζει την τελική χρέωση βάσει της μετρημένης χρήσης. Η εκκαθάριση ροής χρησιμοποιεί την τελική καταγραφή χρήσης. Πώς λειτουργούν η δέσμευση και η εκκαθάριση →

Στοιχεία τιμοκαταλόγου αναφοράς

Οι πίνακες αναφοράς του μοντέλου δεν αλλάζουν την επιλογή μεθόδου, τις εκτιμήσεις τιμής ή τις χρεώσεις. Οι εφαρμοζόμενες χρεώσεις χρησιμοποιούν τις τιμές της επιλεγμένης μεθόδου Ailoot.

Τιμές αναφοράς για διαμορφώσεις βίντεο

Τιμές ανά διαμόρφωση

Αντιστοιχίστε κάθε χρέωση στις συνθήκες που εμφανίζονται. Χρησιμοποιήστε μία χρέωση ανά σύνολο εναλλακτικών διαμορφώσεων.

ΔιαμόρφωσηΣυνθήκες χρέωσηςΧρέωση
ΔιαμόρφωσηΤιμή βίντεοΣυνθήκες χρέωσηςΔεν δηλώνεται πρόσθετη συνθήκη σε αυτό το κλειδί τιμολόγησης.Χρέωση
Έξοδος · Τιμή βίντεο $0.16 ανά δευτερόλεπτο βίντεο

Δημοσιευμένη αναφορά τιμής για την εμφανιζόμενη διαμόρφωση. Οι τελικές χρεώσεις ακολουθούν την πραγματική διαμόρφωση που χρεώθηκε.

ΔιαμόρφωσηΤιμή βίντεοΣυνθήκες χρέωσηςresolution: 480pΧρέωση
Έξοδος · Τιμή βίντεο $0.1 ανά δευτερόλεπτο βίντεο

Δημοσιευμένη αναφορά τιμής για την εμφανιζόμενη διαμόρφωση. Οι τελικές χρεώσεις ακολουθούν την πραγματική διαμόρφωση που χρεώθηκε.

ΔιαμόρφωσηΤιμή βίντεοΣυνθήκες χρέωσηςresolution: 768pΧρέωση
Έξοδος · Τιμή βίντεο $0.16 ανά δευτερόλεπτο βίντεο

Δημοσιευμένη αναφορά τιμής για την εμφανιζόμενη διαμόρφωση. Οι τελικές χρεώσεις ακολουθούν την πραγματική διαμόρφωση που χρεώθηκε.

Παραδείγματα αιτημάτων

Ailoot Ultra · Βίντεο

curl · δημιουργήστε βίντεο
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":"minimax/hailuo-3-max","prompt":"A serene mountain landscape at sunset","resolution":"480p"}', 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
Έλεγχος κατάστασης εργασίας
Λήψη της κατάστασης της αρχικής ενέργειας με GET
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 minimax/hailuo-3-max

Εναλλακτικές διαδρομές μεθόδων

Χρησιμοποιήστε τις διαδρομές μεθόδων που εμφανίζονται παραπάνω.

Σχετικά ID μοντέλων

minimax/hailuo-3-max

FAQ · MiniMax: H3 Max
Ποιες είσοδοι και αποτελέσματα διατίθενται;

POST /v1/videos · minimax/hailuo-3-max: text, image → video

Ποια πεδία χρησιμοποιεί το αίτημα;

POST /v1/videos · minimax/hailuo-3-max: model, prompt, duration, resolution, aspect_ratio, generate_audio, frame_images, input_references, callback_url, session_id, trace, user

Ποια όρια ισχύουν;

POST /v1/videos · minimax/hailuo-3-max: duration.minimum: 1; duration.maximum: 600; frame_images.max_items: 2; frame_images.min_items: 1

Περισσότερες λεπτομέρειες

Συνδέστε το Ailoot με Claude Code, OpenCode, Hermes ή τη δική σας εφαρμογή.

Η εταιρεία και το χαρτοφυλάκιο έργων της

Η εταιρεία και το χαρτοφυλάκιο έργων της: εκατομμύρια πελάτες· μηνιαίες πωλήσεις δισεκατομμυρίων.

Αγοράστε token με έκπτωση.

Έκπτωση συνδρομής για τακτική χρήση. Προωθητικοί κωδικοί — έως 50% στην αγορά token.

Συνδρομή
Επιλέξτε πρόγραμμα με έκπτωση για τα τακτικά αιτήματά σας.
Προωθητικός κωδικός έως 50%
Εισαγάγετε τον κωδικό στην αγορά. Η τιμή επανυπολογίζεται σύμφωνα με την ενεργή προσφορά.
Δαπάνες στο ιστορικό
Μοντέλο, token και ποσό αποθηκεύονται για κάθε αίτημα.

Επιλέξτε συνδρομή · Δείτε τιμές μοντέλων

Συνδέστε το API με το προϊόν που πουλάτε.

SaaS, εφαρμογές και bot — σύμφωνα με τη δημόσια προσφορά και τη σύμβαση άδειας χρήσης Ailoot. Για μεταπώληση ζητήστε σχετική άδεια.

Εμπορική εφαρμογή
Ενσωματώστε δημιουργία κειμένου, εικόνων, βίντεο και ήχου στις πληρωμένες λειτουργίες της υπηρεσίας σας.
Άδεια για μεταπωλητή
Στείλτε περιγραφή έργου και τρόπο πρόσβασης. Ζητήστε γραπτούς όρους χρήσης και μεταπώλησης.
Έγγραφα στον ιστότοπο
Δημόσια προσφορά, σύμβαση άδειας χρήσης και πολιτική επεξεργασίας δεδομένων είναι διαθέσιμες πριν τη σύνδεση.

Ζητήστε άδεια μεταπώλησης · Δημόσια προσφορά και σύμβαση άδειας χρήσης