MiniMax: H3
Το MiniMax H3 παράγει σύντομο βίντεο με εγγενή στερεοφωνικό ήχο από κείμενο, εικόνες καρέ ή πολυτροπικές αναφορές. Υποστηρίζει δημιουργία από πρώτο/τελευταίο καρέ, επεξεργασία με καθοδήγηση αναφορών και σχέσεις κίνησης ή φωνής, με έξοδο 4–15 δευτερολέπτων και διακριτή ροή επαναπαραγωγής 2K.
Σχετικά με το μοντέλο
Αυτή η περιγραφή καλύπτει τις δυνατότητες του μοντέλου. Οι είσοδοι, έξοδοι και επιλογές που διατίθενται στο Ailoot παρατίθενται παρακάτω για την επιλεγμένη μέθοδο.
Ένα οπτικοακουστικό αποτέλεσμα από πολυτροπική οδηγία
Το MiniMax H3 είναι το σύστημα βίντεο omni-modal της MiniMax. Ερμηνεύει μαζί κείμενο, εικόνες, βίντεο και ήχο και έπειτα παράγει βίντεο με εγγενή στερεοφωνικό ήχο. Ο κατασκευαστής το παρουσιάζει για σύντομες δημιουργικές εργασίες, όπως οπτικό υλικό προϊόντων, διαφήμιση, κινούμενες αφίσες και ιδέες κινηματογραφικών τίτλων, όπου οι σχέσεις μεταξύ στοιχείων αναφοράς έχουν τόση σημασία όσο η περιγραφή σκηνής.
Το τεκμηριωμένο σύστημα παράγει βίντεο 4–15 δευτερολέπτων στα 24 καρέ ανά δευτερόλεπτο με στερεοφωνικό ήχο 32 kHz. Η παραγωγή H3-Base λειτουργεί σε 768p· η πλήρης ροή 2K επαναπαράγει εκείνο το αποτέλεσμα χρησιμοποιώντας τα αρχικά πολυτροπικά συμφραζόμενα. Αυτό είναι περισσότερο από συμβατική αλλαγή μεγέθους: το δεύτερο στάδιο χρησιμοποιεί ξανά το μοντέλο και τα αρχικά συμφραζόμενα για να ανακτήσει λεπτή λεπτομέρεια. Τα H3 Max και H3-Context-IR έχουν ξεχωριστούς ρόλους και όρια.
Δημιουργία από κείμενο και με καθοδήγηση καρέ
Η είσοδος μόνο κειμένου περιγράφει ολόκληρη την οπτικοακουστική χρονογραμμή. Μια πρώτη εικόνα καθορίζει την αρχή, μια τελευταία το τέλος και δύο εικόνες μπορούν να ορίζουν και τα δύο. Για πλάνο πρώτου καρέ, ξεκινήστε με τη σύνθεση και την ταυτότητα που φαίνονται στη στατική εικόνα και έπειτα περιγράψτε τη δράση που αναπτύσσεται από αυτή. Για μετάβαση πρώτου σε τελευταίο καρέ, περιγράψτε την παρατηρήσιμη κίνηση που συνδέει τις δύο καταστάσεις αντί να επαναλαμβάνετε δύο άσχετες περιγραφές εικόνων.
Μια πρακτική οδηγία προϊόντος μπορεί να ορίζει κλειστή συσκευασία στο αρχικό καρέ, το χέρι που την ανοίγει, την ήπια κίνηση κάμερας και την τελική κατάσταση που πρέπει να επιτευχθεί. Διατηρήστε το σχήμα αντικειμένου, την τοποθέτηση ετικέτας και τον φωτισμό στα παρεχόμενα καρέ. Η δημιουργία με καθοδήγηση καρέ και η δημιουργία με καθοδήγηση αναφορών είναι ξεχωριστοί τρόποι εισόδου· η διεπαφή του κατασκευαστή δεν αναμειγνύει ρόλους πρώτου/τελευταίου καρέ με ρόλους μέσων αναφοράς σε ένα αίτημα.
Παραγωγή και επεξεργασία με καθοδήγηση αναφορών
Η λειτουργία αναφορών δέχεται κείμενο μαζί με εικόνες, αποσπάσματα βίντεο και αποσπάσματα ήχου. Προσδιορίστε τι συνεισφέρει κάθε πηγή: εμφάνιση χαρακτήρα, τοποθεσία, κίνηση κάμερας, χρονική δομή αρχικού αποσπάσματος ή φωνή. Ένα βίντεο που χρησιμοποιείται μόνο για κίνηση κάμερας διαφέρει από βίντεο που πρέπει πράγματι να επεξεργαστεί ή να συνεχιστεί. Δηλώστε ρητά αυτή τη σχέση.
Ο οδηγός αναφορών του κατασκευαστή διαχωρίζει ορισμούς θεμάτων, σύνοψη εργασίας, ανάλυση διατήρησης, λεπτομερή περιγραφή πλάνου, συνολικό ηχητικό τοπίο και μουσική υπόκρουση μόνο για το κοινό. Διακρίνει τη διατήρηση ορατού περιεχομένου από τη μεταφορά ιδιοτήτων ή μια ευρεία αναφορά ύφους. Για τον ήχο, η αντιγραφή σήματος διαφέρει από την αναφορά σε χροιά, ρυθμό ή εκφορά. Κρατήστε σταθερούς αυτούς τους ρόλους σε όλη την οδηγία.
Για σκηνή βάσει αναφορών, δώστε εικόνα χαρακτήρα, σύντομη αναφορά κίνησης κάμερας και ηχητική αναφορά φωνής και έπειτα περιγράψτε πού πρέπει κάθε στοιχείο να επηρεάζει το πλάνο-στόχο. Δηλώστε ποιες λεπτομέρειες ρούχων, περιβάλλοντος ή αντικειμένων πρέπει να παραμείνουν αναγνωρίσιμες. Συγκρίνετε το ολοκληρωμένο απόσπασμα με αυτές τις απαιτήσεις, συμπεριλαμβανομένων της συνέχειας κίνησης και της σχέσης μεταξύ ορατού ομιλητή και φωνής που ακούγεται.
Ομιλία, ήχος και χρονισμός πλάνων
Το H3 μοντελοποιεί μαζί διάλογο, φυσικούς ήχους, ατμόσφαιρα και μουσική. Η κάρτα μοντέλου τεκμηριώνει σταθερή υποστήριξη διαλόγου για αραβικά, κινεζικά, αγγλικά, γαλλικά, γερμανικά, ιταλικά, ιαπωνικά, κορεατικά, πορτογαλικά, ρωσικά και ισπανικά· η υποστήριξη άλλων γλωσσών περιγράφεται ως μεταβλητή. Δώστε τις ακριβείς εκφωνούμενες λέξεις και τη γλώσσα, με σταθερή ταυτότητα ομιλητή στα πλάνα.
Οι οδηγοί σύνταξης προτροπών του κατασκευαστή χρησιμοποιούν αγγλικά για τις περιγραφικές ενότητες, διατηρώντας τον διάλογο και το ορατό κείμενο στην αρχική τους γλώσσα. Το προφορικό περιεχόμενο χρησιμοποιεί <d>[Language] ...</d>, με ταυτότητα ομιλητή και περιγραφή φωνής έξω από το τμήμα. Διακρίνετε τη φυσική ομιλία από την αφήγηση εκτός κάδρου και προσδιορίστε πότε μια ατάκα συνεχίζεται μετά από κόψιμο ή διακόπτεται από το τέλος. Διατηρήστε ακριβώς και το ορατό κείμενο. Προσαρμόστε την ποσότητα ομιλίας στην επιλεγμένη διάρκεια και επιθεωρήστε μαζί τις αποδοσμένες λέξεις και την ακουστή ατάκα.
Περιγράψτε την κίνηση κάμερας ως ενέργεια, συμπεριλαμβάνοντας το εύρος και την ταχύτητά της όταν έχουν σημασία. Αριθμήστε τα πλάνα με τη σειρά αναπαραγωγής και κρατήστε τους χρόνους κοψίματος εντός της διάρκειας βίντεο. Διαχωρίστε ήχους σκηνής όπως βήματα ή κλείσιμο πόρτας από μουσική υπόκρουση που ακούει μόνο το κοινό. Αυτές οι επιλογές κάνουν ένα σύντομο σχέδιο πλάνου ευκολότερο στην ερμηνεία και στον έλεγχο έναντι του αποτελέσματός του.
Προετοιμασία εισόδου και αριθμητικά όρια
Το τρέχον σχήμα παραγωγής απαιτεί μη κενό κείμενο σε κάθε λειτουργία, έως 7.000 χαρακτήρες ανά στοιχείο κειμένου. Οι εικόνες μπορούν να είναι 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 δευτερόλεπτα. Η κάρτα μοντέλου περιορίζει τις μικτές εισόδους αναφοράς σε 12 αρχεία. Το τεκμηριωμένο όριο σώματος αιτήματος είναι 64 MB, διακριτό από τα όρια ανά αρχείο.
Επιλέξτε μόνο αναφορές που συνεισφέρουν στην οδηγία και κάντε ρητή κάθε συνεισφορά. Μια καθαρή άποψη θέματος είναι χρησιμότερη από πολλές αντικρουόμενες όψεις χωρίς εξήγηση. Διατηρήστε τη σειρά αναφορών, περικόψτε άσχετο υλικό χωρίς να αφαιρείτε αναγκαία συμφραζόμενα σκηνής και ελέγξτε ότι τα σύντομα αρχικά αποσπάσματα περιέχουν τη δράση ή το χαρακτηριστικό φωνής που ζητείται.
Σχήμα εξόδου και πλήρες σύστημα
Η διεπαφή H3 του κατασκευαστή προσφέρει 768P και 2K. Η παραγωγή μόνο από κείμενο απαιτεί συγκεκριμένη αναλογία: 21:9, 16:9, 4:3, 1:1, 3:4 ή 9:16. Η δημιουργία από πρώτο/τελευταίο καρέ παίρνει την αναλογία διαστάσεων από την εικόνα εισόδου· η δημιουργία από αναφορές μπορεί να χρησιμοποιεί προσαρμοστική ή ρητή αναλογία. Η ακέραια διάρκεια εξόδου είναι 4–15 δευτερόλεπτα.
Η κάρτα μοντέλου διακρίνει το H3-Context-IR, που ερμηνεύει και εμπλουτίζει την οδηγία, το H3-Base, που παράγει οπτικοακουστικό περιεχόμενο, και το H3-Regenerate-2K, που δημιουργεί το αποτέλεσμα υψηλότερης ανάλυσης. Τα δημοσιευμένα βασικά checkpoints διαχωρίζουν εργασίες καθοδήγησης καρέ και omni-reference. Τα στοιχεία συμφραζομένων και επαναπαραγωγής είναι διακριτά από αυτά τα βασικά βάρη, επομένως το όνομα ενός ανοιχτού checkpoint από μόνο του δεν τεκμηριώνει τη συμπεριφορά ολόκληρου του συστήματος.
Η ροή παραγωγής του κατασκευαστή είναι ασύγχρονη. Η διεπαφή αναζήτησης εργασιών ανακτά εργασίες των προηγούμενων επτά ημερών. Κρατήστε την ταυτότητα εργασίας μέχρι να επιστραφεί το πραγματικό αποτέλεσμα βίντεο και έπειτα αποθηκεύστε το απόσπασμα αντί να διατηρείτε μόνο διεύθυνση λήψης περιορισμένης ισχύος. Ελέγξτε οπτική ταυτότητα, μικρό κείμενο, αλληλεπιδράσεις αντικειμένων, προφορικό περιεχόμενο και χρονισμό ήχου στο επιδιωκόμενο μέγεθος θέασης. Ο κατασκευαστής προσδιορίζει την πολυτροπική κατανόηση και τη λεπτή οπτική λεπτομέρεια ως συνεχιζόμενους τομείς βελτίωσης· μια λεπτομερής οδηγία και η σύγκριση με την πηγή παραμένουν κεντρικά για χρήσιμο αποτέλεσμα.
Ailoot Ultra · Βίντεο POST /v1/videos minimax/hailuo-3
minimax/hailuo-3Εισαγωγή
Το MiniMax H3 παράγει σύντομο βίντεο με εγγενή στερεοφωνικό ήχο από κείμενο, εικόνες καρέ ή πολυτροπικές αναφορές. Υποστηρίζει δημιουργία από πρώτο/τελευταίο καρέ, επεξεργασία με καθοδήγηση αναφορών και σχέσεις κίνησης ή φωνής, με έξοδο 4–15 δευτερολέπτων και διακριτή ροή επαναπαραγωγής 2K.
- Αποδεκτές είσοδοι
- Κείμενο · Εικόνες · Ήχος · Βίντεο
- Αποτελέσματα
- Βίντεο
Διαθέσιμα στο Ailoot · είσοδοι και μέθοδοι
Ailoot Ultra · Βίντεο POST /v1/videos
- Είσοδος
text,image,audio,video- Έξοδος
video- Μορφή εξόδου
- αρχικά byte του MP4· χωρίς κανονικοποίηση ή διακωδικοποίηση
| Πεδίο | Τύπος | Απαίτηση | Τιμές και όρια | Προεπιλογή |
|---|---|---|---|---|
Πεδίοmodel | Τύποςstring | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια minimax/hailuo-3 | Προεπιλογή— |
Πεδίοprompt | Τύποςstring | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια | Προεπιλογή— |
Πεδίοduration | Τύποςinteger | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 Ελάχιστο: 1 Μέγιστο: 600 | Προεπιλογή— |
Πεδίοresolution | Τύποςstring | ΑπαίτησηΠροαιρετικό | Τιμές και όρια 2K | Προεπιλογή— |
Πεδίο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 | ΑπαίτησηΠροαιρετικό | Τιμές και όρια | Προεπιλογή— |
Πεδίοcallback_url | Τύποςstring | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Μοτίβο: ^https:// | Προεπιλογή— |
Πεδίοsession_id | Τύποςstring | ΑπαίτησηΠροαιρετικό | Τιμές και όρια | Προεπιλογή— |
Πεδίοtrace | Τύποςobject | ΑπαίτησηΠροαιρετικό | Τιμές και όρια | Προεπιλογή— |
Πεδίοuser | Τύποςstring | ΑπαίτησηΠροαιρετικό | Τιμές και όρια | Προεπιλογή— |
Συνδυασμοί υλικών εισόδου
Κείμενο σε βίντεο · Μια γραπτή προτροπή. · Υποχρεωτικό: model, prompt, duration
Δώστε την προτροπή ως κείμενο και τη διάρκεια σε ακέραια δευτερόλεπτα. Επιλέξτε υποστηριζόμενη ανάλυση και, αν χρειάζεται, αναλογία διαστάσεων.
model: Τύπος: string · minimax/hailuo-3
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
prompt: Τύπος: string · Μέγιστο πλήθος byte UTF-8: 10.000 · Απαιτείται περιεχόμενο πέρα από κενά διαστήματα: Ναι
Reference to video · Μια γραπτή προτροπή και υποστηριζόμενες αναφορές εικόνας, βίντεο και ήχου. · Υποχρεωτικό: model, prompt, duration, input_references
Το input_references είναι πίνακας αντικειμένων. Ορίστε το type σε image_url, video_url, audio_url και χρησιμοποιήστε το αντίστοιχο πεδίο που περιέχει url. Χρησιμοποιήστε δημόσια HTTPS URL. Παραλείψτε το frame_images για να επιλέξετε λειτουργία αναφορών. Η εκτίμηση περιλαμβάνει την εμφανιζόμενη συνιστώσα ανά εικόνα μόνο για εικόνες αναφοράς πέρα από τις πρώτες πέντε. Η τελική χρέωση ακολουθεί την πραγματική διαμόρφωση που τιμολογήθηκε. Μην συνδυάζετε εικόνες αναφοράς με εικόνες καρέ. Επιλέξτε υποστηριζόμενη ανάλυση και, αν χρειάζεται, αναλογία διαστάσεων.
model: Τύπος: string · minimax/hailuo-3
prompt: Τύπος: string · Μέγιστο πλήθος byte UTF-8: 10.000 · Απαιτείται περιεχόμενο πέρα από κενά διαστήματα: Ναι
Παράμετροι και κύκλος ζωής μεθόδου
| Παράμετρος | Σύμβαση |
|---|---|
Παράμετροςcontent_type | Σύμβασηapplication/json |
Παράμετροςrequired | Σύμβασηmodel, prompt, duration |
Παράμετροςmaterial_types | Σύμβασηtext, image, audio, video |
Παράμετρος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 |
| ΔιαμόρφωσηΤιμή βίντεο | Πίνακας χρεώσεων— | Προβλεπόμενη ποσότητα— | Μονάδα τιμολόγησηςανά δευτερόλεπτο βίντεο | Συνθήκες χρέωσηςΔεν δηλώνεται πρόσθετη συνθήκη σε αυτό το κλειδί τιμολόγησης. | Χρέωση Έξοδος · Τιμή βίντεο · Εκτίμηση μόνο για σύγκριση $0.26 ανά δευτερόλεπτο βίντεο |
| Διαμόρφωσηεικόνα αναφοράς | Πίνακας χρεώσεων— | Προβλεπόμενη ποσότητα— | Μονάδα τιμολόγησηςανά εικόνα αναφοράς | Συνθήκες χρέωσης— | Χρέωση Είσοδος · εικόνα αναφοράς · Εκτίμηση μόνο για σύγκριση $0.08 ανά εικόνα αναφοράς |
| ΔιαμόρφωσηΕκτιμώμενο κόστος δημιουργίας | Πίνακας χρεώσεων— | Προβλεπόμενη ποσότηταεκτίμηση για μία δημιουργία | Μονάδα τιμολόγησης— | Συνθήκες χρέωσης— | Χρέωση Έξοδος · Εκτιμώμενο κόστος δημιουργίας · Εκτίμηση μόνο για σύγκριση $1.3 εκτίμηση πριν από τη δημιουργία Αυτή η εκτίμηση δεν αποτελεί πρόσθετη χρέωση ούτε σταθερή τιμή για την ολοκληρωμένη παραγωγή. |
Το Ailoot δεσμεύει ένα εκτιμώμενο ποσό πριν από το αίτημα. Μετά το αποτέλεσμα, εκκαθαρίζει την τελική χρέωση βάσει της μετρημένης χρήσης. Η εκκαθάριση ροής χρησιμοποιεί την τελική καταγραφή χρήσης. Πώς λειτουργούν η δέσμευση και η εκκαθάριση →
Στοιχεία τιμοκαταλόγου αναφοράς
Οι πίνακες αναφοράς του μοντέλου δεν αλλάζουν την επιλογή μεθόδου, τις εκτιμήσεις τιμής ή τις χρεώσεις. Οι εφαρμοζόμενες χρεώσεις χρησιμοποιούν τις τιμές της επιλεγμένης μεθόδου Ailoot.
Τιμές αναφοράς για διαμορφώσεις βίντεο
Τιμές ανά διαμόρφωση
Αντιστοιχίστε κάθε χρέωση στις συνθήκες που εμφανίζονται. Χρησιμοποιήστε μία χρέωση ανά σύνολο εναλλακτικών διαμορφώσεων.
| Διαμόρφωση | Συνθήκες χρέωσης | Χρέωση |
|---|---|---|
| ΔιαμόρφωσηΤιμή βίντεο | Συνθήκες χρέωσηςΔεν δηλώνεται πρόσθετη συνθήκη σε αυτό το κλειδί τιμολόγησης. | Χρέωση Έξοδος · Τιμή βίντεο $0.26 ανά δευτερόλεπτο βίντεο Δημοσιευμένη αναφορά τιμής για την εμφανιζόμενη διαμόρφωση. Οι τελικές χρεώσεις ακολουθούν την πραγματική διαμόρφωση που χρεώθηκε. |
| ΔιαμόρφωσηΕικόνες αναφοράς πέρα από τις πρώτες πέντε | Συνθήκες χρέωσηςΔεν δηλώνεται πρόσθετη συνθήκη σε αυτό το κλειδί τιμολόγησης. | Χρέωση Είσοδος · Εικόνες αναφοράς μετά τις πρώτες πέντε $0.08 ανά εικόνα Οι πρώτες πέντε εικόνες αναφοράς είναι δωρεάν· η αναγραφόμενη τιμή ανά εικόνα ισχύει πέρα από τις πρώτες πέντε. Δημοσιευμένη τιμή αναφοράς για την εμφανιζόμενη διαμόρφωση. Οι τελικές χρεώσεις ακολουθούν την πραγματική διαμόρφωση που τιμολογήθηκε. |
Παραδείγματα αιτημάτων
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":"minimax/hailuo-3","prompt":"A serene mountain landscape at sunset","resolution":"2K"}', 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 minimax/hailuo-3
Εναλλακτικές διαδρομές μεθόδων
Χρησιμοποιήστε τις διαδρομές μεθόδων που εμφανίζονται παραπάνω.
Σχετικά ID μοντέλων
FAQ · MiniMax: H3
- Ποιες είσοδοι και αποτελέσματα διατίθενται;
POST /v1/videos·minimax/hailuo-3:text,image,audio,video→video- Ποια πεδία χρησιμοποιεί το αίτημα;
POST /v1/videos·minimax/hailuo-3:model,prompt,duration,resolution,aspect_ratio,generate_audio,frame_images,input_references,callback_url,session_id,trace,user- Ποια όρια ισχύουν;
POST /v1/videos·minimax/hailuo-3:duration.minimum:1;duration.maximum:600;frame_images.max_items:2;frame_images.min_items:1