MiniMax-Hailuo-2.3
Το MiniMax Hailuo 2.3 δημιουργεί βίντεο από κείμενο ή αρχική εικόνα, με χειριστήρια κίνησης και κατεύθυνσης κάμερας. Επιλέξτε έξι δευτερόλεπτα σε 768P ή 1080P ή δέκα δευτερόλεπτα σε 768P για ερμηνείες χαρακτήρων, στιλιζαρισμένες σκηνές και πλάνα προϊόντων που μπορούν να ελεγχθούν και να μονταριστούν.
- Ailoot · Βίντεο
POST /v1/videos/generationsMiniMax-Hailuo-2.3 - Ailoot Ultra · Βίντεο
POST /v1/videosMiniMax-Hailuo-2.3
Σχετικά με το μοντέλο
Αυτή η περιγραφή καλύπτει τις δυνατότητες του μοντέλου. Οι είσοδοι, έξοδοι και επιλογές που διατίθενται στο Ailoot παρατίθενται παρακάτω για την επιλεγμένη μέθοδο.
Το MiniMax Hailuo 2.3 είναι μοντέλο παραγωγής βίντεο με λειτουργίες μετατροπής κειμένου και εικόνας σε βίντεο. Εξελίσσει το Hailuo 02 με έμφαση στη σωματική δράση, το οπτικό ύφος, τις μικροεκφράσεις χαρακτήρων και την απόκριση σε οδηγίες κίνησης. Δώστε γραπτή σκηνή για να δημιουργήσετε πλάνο από την αρχή ή χρησιμοποιήστε αρχική εικόνα για να ορίσετε την πρώτη οπτική και να περιγράψετε την κίνηση που ακολουθεί.
Η σωματική ερμηνεία είναι ένας από τους κύριους τομείς βελτίωσης της έκδοσης. Το Hailuo 2.3 στοχεύει σε πιο ομαλές και ελεγχόμενες κινήσεις σώματος, συμπεριλαμβανομένων σκηνών με κινούμενη κάμερα. Σχεδιάστε τη σημαντική δράση πριν προσθέσετε διακοσμητική λεπτομέρεια. Ένας χαρακτήρας που σηκώνει αντικείμενο, στρέφεται προς άλλο άτομο ή κινείται μέσα σε δωμάτιο δίνει στο πλάνο ορατό συμβάν προς αξιολόγηση. Αποφασίστε ποια κίνηση μεταφέρει την ιστορία και κρατήστε τις γύρω οδηγίες συνεπείς με αυτή.
Η στιλιζαρισμένη απόδοση είναι άλλη μία εστίαση. Το μοντέλο υποστηρίζει εργασία σε anime και εικονογράφηση, καθώς και ύφη όπως ζωγραφική με μελάνι και γραφικά υπολογιστή παιχνιδιών. Περιγράψτε την οπτική απόδοση που θέλετε και κρατήστε την εμφάνιση συνεκτική με τη σκηνή. Αν μια αρχική εικόνα ορίζει ήδη σχεδιαστικό ύφος, χρησιμοποιήστε το κείμενο για να καθοδηγήσετε την κίνηση αντί να εισάγετε ανταγωνιστική περιγραφή του σχεδιασμού χαρακτήρα. Ελέγξτε ολόκληρο το απόσπασμα για το αν αυτή η απόδοση παραμένει ευανάγνωστη κατά την κίνηση.
Το μοντέλο εστιάζει επίσης στην ερμηνεία προσώπου και στις λεπτές αλλαγές έκφρασης. Προετοιμάστε πλάνο χαρακτήρα γύρω από την αντίδραση που έχει σημασία: να προσέχει ένα αντικείμενο, να αποκτά περιέργεια ή να απαντά με μικρό χαμόγελο. Μια κοντινή οπτική μπορεί να κάνει αυτή την αλλαγή ευκολότερη στην αξιολόγηση, ενώ μεγάλη ακολουθία χειρονομιών μπορεί να αποσπά από αυτή. Ελέγξτε το πρόσωπο πριν, κατά τη διάρκεια και μετά την αντίδραση αντί να κρίνετε μόνο ένα αντιπροσωπευτικό στατικό καρέ.
Η κίνηση αντικειμένων είναι χρήσιμη για σκηνές με επίκεντρο το προϊόν. Μια πρωτότυπη οδηγία θα μπορούσε να δείχνει μικρό κεραμικό βάζο που περιστρέφεται σε ζεστό πλάγιο φως ενώ η κάμερα το πλησιάζει σταδιακά. Προσδιορίστε ποιες ιδιότητες πρέπει να παραμένουν αναγνωρίσιμες, όπως σιλουέτα, χείλος και φινίρισμα επιφάνειας. Ελέγξτε αυτές τις λεπτομέρειες κατά την κίνηση, επειδή μια πειστική ατμόσφαιρα από μόνη της δεν τεκμηριώνει πιστή άποψη προϊόντος.
Για μετατροπή κειμένου σε βίντεο, η απαιτούμενη περιγραφή μπορεί να περιέχει έως 2.000 χαρακτήρες. Δηλώστε θέμα, δράση, σκηνικό και οπτικό ύφος με συνεκτική σειρά. Η μετατροπή εικόνας σε βίντεο απαιτεί εικόνα αρχικού καρέ, με προαιρετική περιγραφή έως 2.000 χαρακτήρων. Η εικόνα καθορίζει την αρχική σύνθεση, επομένως προετοιμάστε θέμα και κάδρο πριν ζητήσετε κίνηση. Αφήστε ορατό χώρο όπου πρέπει να κινηθεί χέρι, αντικείμενο ή χαρακτήρας.
Η αρχική εικόνα δέχεται JPG, JPEG, PNG ή WebP, πρέπει να είναι μικρότερη από 20 MB, χρειάζεται μικρή πλευρά μεγαλύτερη από 300 pixel και πρέπει να έχει αναλογία διαστάσεων μεταξύ 2:5 και 5:2. Μπορεί να παρέχεται ως δημόσιο URL εικόνας ή Base64 data URL. Επιλέξτε καθαρή αρχική εικόνα αντί να βασίζεστε στην κίνηση για διόρθωση κρυμμένου προσώπου ή ήδη περικομμένης δράσης.
Το Hailuo 2.3 παράγει στα 24 καρέ ανά δευτερόλεπτο. Ένα πλάνο έξι δευτερολέπτων μπορεί να χρησιμοποιεί 768P ή 1080P· ένα πλάνο δέκα δευτερολέπτων χρησιμοποιεί 768P. Οι προεπιλογές είναι έξι δευτερόλεπτα και 768P. Επιλέξτε διάρκεια για τη δράση που θέλετε να δείτε: μια σύντομη αντίδραση μπορεί να χωρά σε μικρό πλάνο, ενώ πιο αργή κίνηση χρειάζεται περισσότερο χώρο. Διαβάστε το πραγματικό πλάτος και ύψος του ολοκληρωμένου αποτελέσματος όταν τοποθετείτε το απόσπασμα σε μοντάζ, αφού μια ετικέτα ανάλυσης από μόνη της δεν είναι ολόκληρη η απόφαση κάδρου.
Η κατεύθυνση κάμερας μπορεί να χρησιμοποιεί εντολές σε αγκύλες. Τα διαθέσιμα χειριστήρια καλύπτουν πλάγια μετακίνηση, πανοραμική κίνηση, προσέγγιση, κατακόρυφη μετατόπιση, κλίση, ζουμ, κούνημα, παρακολούθηση και στατικό πλάνο. Μια εντολή όπως [Push in] κατευθύνει την προσέγγιση· εντολές ομαδοποιημένες μέσα στην ίδια αγκύλη ενεργούν μαζί, ενώ εντολές τοποθετημένες με σειρά περιγράφουν ακολουθία. Η MiniMax συνιστά έως τρεις ταυτόχρονες εντολές. Κρατήστε την κίνηση κάμερας συμβατή με τη δράση θέματος, ώστε το κύριο συμβάν να παραμένει εύκολο στην παρακολούθηση.
Η αυτόματη βελτιστοποίηση προτροπής είναι ενεργοποιημένη από προεπιλογή και μπορεί να απενεργοποιηθεί για στενότερο έλεγχο της παρεχόμενης διατύπωσης. Η προαιρετική γρήγορη προεπεξεργασία μειώνει τον χρόνο βελτιστοποίησης όταν αυτή είναι ενεργοποιημένη· είναι ξεχωριστή ρύθμιση από την επιλογή μοντέλου Hailuo 2.3 Fast. Το τυπικό Hailuo 2.3 υποστηρίζει και τους δύο τρόπους δημιουργίας, ενώ το Fast είναι η ξεχωριστή έκδοση εικόνας σε βίντεο. Επιλέξτε έκδοση ανάλογα με το αν το έργο ξεκινά μόνο με κείμενο ή με υπάρχον καρέ.
Η ροή παραγωγής επιστρέφει ασύγχρονο αναγνωριστικό εργασίας και έπειτα αναφέρει προετοιμασία, ουρά, επεξεργασία, επιτυχία ή αποτυχία. Σε επιτυχία, το αποτέλεσμα παρέχει αναγνωριστικό αρχείου και τις πραγματικές διαστάσεις βίντεο και το ολοκληρωμένο βίντεο ανακτάται για λήψη. Αποθηκεύστε το απόσπασμα όσο ισχύει η διεύθυνση λήψης του. Η τρέχουσα αναφορά λήψης βίντεο του κατασκευαστή δίνει στο επιστρεφόμενο URL λήψης διάρκεια ισχύος μίας ώρας. Για μονταρισμένη ακολουθία, διατηρήστε κάθε πλάνο μαζί με την προτροπή και την αρχική εικόνα του, ώστε η επιλεγμένη δημιουργική κατεύθυνση να παραμένει ανιχνεύσιμη κατά την αναθεώρηση.
Ελέγξτε δράση, φυσική συνέχεια, λεπτομέρειες προσώπου ή προϊόντος, οπτικό ύφος και συμπεριφορά κάμερας στο αποθηκευμένο απόσπασμα. Παρακολουθήστε ολόκληρο το πλάνο και έπειτα επιθεωρήστε την αρχή και το τέλος του, όπου θα ενωθεί με άλλο υλικό. Αν το αίτημα περιέχει υπερβολικά πολλές ανταγωνιστικές κινήσεις, απλοποιήστε την κύρια δράση· αν ο αρχικός σχεδιασμός είναι ασαφής, βελτιώστε την αρχική εικόνα. Επιλέξτε πλάνο που μεταδίδει το επιδιωκόμενο συμβάν και έπειτα προσθέστε αφήγηση, τίτλους και μεταβάσεις στη ροή μοντάζ.
Ailoot · Βίντεο POST /v1/videos/generations MiniMax-Hailuo-2.3
MiniMax-Hailuo-2.3Εισαγωγή
Το MiniMax Hailuo 2.3 δημιουργεί βίντεο από κείμενο ή αρχική εικόνα, με χειριστήρια κίνησης και κατεύθυνσης κάμερας. Επιλέξτε έξι δευτερόλεπτα σε 768P ή 1080P ή δέκα δευτερόλεπτα σε 768P για ερμηνείες χαρακτήρων, στιλιζαρισμένες σκηνές και πλάνα προϊόντων που μπορούν να ελεγχθούν και να μονταριστούν.
- Αποδεκτές είσοδοι
- Κείμενο · Εικόνες
- Αποτελέσματα
- Βίντεο
Διαθέσιμα στο Ailoot · είσοδοι και μέθοδοι
Ailoot · Βίντεο POST /v1/videos/generations
- Είσοδος
text,image- Έξοδος
video- Μορφή εξόδου
- mp4
| Πεδίο | Τύπος | Απαίτηση | Τιμές και όρια | Προεπιλογή |
|---|---|---|---|---|
Πεδίοmodel | Τύποςstring | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια MiniMax-Hailuo-2.3 | Προεπιλογή— |
Πεδίοprompt | Τύποςstring | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια Ελάχιστο μήκος: 1 Μέγιστο μήκος: 2.000 Μονάδα: χαρακτήρες Unicode | Προεπιλογή— |
Πεδίοduration | Τύποςinteger | ΑπαίτησηΠροαιρετικό | Τιμές και όρια 6, 10 Συνθήκες: Τα 10 δευτερόλεπτα απαιτούν 768P Μονάδα: δευτερόλεπτα | Προεπιλογή6 |
Πεδίοresolution | Τύποςstring | ΑπαίτησηΠροαιρετικό | Τιμές και όρια 768P, 1080P Συνθήκες: Το 1080P απαιτεί 6 δευτερόλεπτα | Προεπιλογή768P |
Πεδίοfirst_frame_image | Τύποςhttps_url|data_image_url | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Μέγιστο πλήθος αποκωδικοποιημένων byte: 20.971.520 Τύποι MIME: image/jpeg, image/png, image/webp Ελάχιστη διάσταση (αποκλειστική): 300 Εύρος αναλογιών διαστάσεων: 2:5, 5:2 | Προεπιλογή— |
Πεδίοprompt_optimizer | Τύποςboolean | ΑπαίτησηΠροαιρετικό | Τιμές και όρια | Προεπιλογή— |
Πεδίοfast_pretreatment | Τύποςboolean | ΑπαίτησηΠροαιρετικό | Τιμές και όρια | Προεπιλογή— |
Συνδυασμοί υλικών εισόδου
Εικόνα σε βίντεο · Υποχρεωτικό: prompt, first_frame_image
Κείμενο σε βίντεο · Υποχρεωτικό: prompt
Παράμετροι και κύκλος ζωής μεθόδου
| Παράμετρος | Σύμβαση |
|---|---|
Παράμετροςmaterial_types | Σύμβασηtext, image |
Παράμετροςrequired | Σύμβασηnull |
Παράμετροςoptional_controls | Σύμβασηnull |
Κύκλος ζωής: submit_once_poll_original
GET /v1/videos/{request_id}
GET /v1/videos/generations/{request_id}
GET /v1/videos/{request_id}/content
GET /v1/videos/generations/{request_id}/content
Οι δομές και τα ID των μεθόδων είναι ακριβή· η δυνατότητα του προμηθευτή είναι ξεχωριστή από την αποδοχή αιτημάτων.
Τιμολόγηση
Χρεώσεις μεθόδων Ailoot
POST /v1/videos/generations- Έξοδος
- 0,28 $ ανά βίντεο 6 s στα 768p
Το Ailoot δεσμεύει ένα εκτιμώμενο ποσό πριν από το αίτημα. Μετά το αποτέλεσμα, εκκαθαρίζει την τελική χρέωση βάσει της μετρημένης χρήσης. Η εκκαθάριση ροής χρησιμοποιεί την τελική καταγραφή χρήσης. Πώς λειτουργούν η δέσμευση και η εκκαθάριση →
Στοιχεία τιμοκαταλόγου αναφοράς
Οι πίνακες αναφοράς του μοντέλου δεν αλλάζουν την επιλογή μεθόδου, τις εκτιμήσεις τιμής ή τις χρεώσεις. Οι εφαρμοζόμενες χρεώσεις χρησιμοποιούν τις τιμές της επιλεγμένης μεθόδου Ailoot.
MiniMax-Hailuo-2.3
Τιμές ανά διαμόρφωση
| Διαμόρφωση | Συνθήκες χρέωσης | Χρέωση |
|---|---|---|
| ΔιαμόρφωσηMiniMax-Hailuo-2.3 · Προεπιλεγμένη διαμόρφωση | Συνθήκες χρέωσηςΠροεπιλεγμένη διαμόρφωση | Χρέωση Είσοδος · Είσοδος 0,00 $ ανά κλήση Έξοδος · Έξοδος 0,60 $ ανά κλήση |
MiniMax-Hailuo-2.3
Τιμές ανά διαμόρφωση
| Διαμόρφωση | Συνθήκες χρέωσης | Χρέωση |
|---|---|---|
| ΔιαμόρφωσηMiniMax-Hailuo-2.3 · Προεπιλεγμένη διαμόρφωση | Συνθήκες χρέωσηςΠροεπιλεγμένη διαμόρφωση | Χρέωση Είσοδος · Είσοδος 0,00 $ ανά κλήση Έξοδος · Έξοδος 1,20 $ ανά κλήση |
MiniMax-Hailuo-2.3
Τιμές ανά διαμόρφωση
| Διαμόρφωση | Συνθήκες χρέωσης | Χρέωση |
|---|---|---|
| ΔιαμόρφωσηMiniMax-Hailuo-2.3 · Προεπιλεγμένη διαμόρφωση | Συνθήκες χρέωσηςΠροεπιλεγμένη διαμόρφωση | Χρέωση Είσοδος · Είσοδος 0,00 $ ανά κλήση Έξοδος · Έξοδος 1,20 $ ανά κλήση |
Παραδείγματα αιτημάτων
Ailoot · Βίντεο
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
curl https://api.ailoot.ai/v1/videos/generations \
-H "Authorization: Bearer $AILOOT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model": "MiniMax-Hailuo-2.3", "prompt": "A person walks slowly through a quiet garden as the camera tracks from the side.", "duration": 6, "resolution": "768P"}'Λήψη και αποθήκευση αποτελεσμάτων
Ailoot · Βίντεο
mp4
GET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /v1/videos/generations/{request_id}/content
Έλεγχος κατάστασης εργασίας
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_VIDEO_ID:?Set the actual Ailoot operation ID returned by creation}"
export AILOOT_VIDEO_ID
video_id=$(python3 -c 'import os, urllib.parse; print(urllib.parse.quote(os.environ["AILOOT_VIDEO_ID"], safe=""))') || exit 1
curl "https://api.ailoot.ai/v1/videos/generations/$video_id" \
-H "Authorization: Bearer $AILOOT_API_KEY"Άλλες ανακτήσεις περιεχομένου
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_VIDEO_ID:?Set the actual Ailoot operation ID returned by creation}"
export AILOOT_VIDEO_ID
video_id=$(python3 -c 'import os, urllib.parse; print(urllib.parse.quote(os.environ["AILOOT_VIDEO_ID"], safe=""))') || exit 1
curl "https://api.ailoot.ai/v1/videos/generations/$video_id/content" \
-H "Authorization: Bearer $AILOOT_API_KEY" \
--output video.mp4Διατηρήστε όλα τα ολοκληρωμένα αποτελέσματα
Αποθηκεύστε κάθε ολοκληρωμένο βίντεο ή αρχείο που επιστρέφεται· ανακτήστε κάθε πραγματικό URL αρχείου που επιστρέφεται.
Διατηρήστε κάθε στοιχείο δεδομένων και δείκτη εξόδου που επιστρέφεται. Το content_url αφορά μόνο το πρώτο· ανακτήστε κάθε πραγματική διαδρομή περιεχομένου ή αρχείο πολυμέσων. Το GET περιεχομένου χωρίς index δεν αντιστοιχεί σε όλες τις εξόδους.
Αν χρειάζεται έλεγχος της αρχικής απάντησης
Διαβάστε την υπάρχουσα αρχική εργασία· μην επανυποβάλετε ποτέ αποστολή με άγνωστο αποτέλεσμα.
Πεδία απάντησης
| Πεδίο | Τύπος |
|---|---|
Πεδίοid | Τύποςstring |
Πεδίοobject | Τύποςstring |
Πεδίοmodel | Τύποςstring |
Πεδίοstatus | Τύποςstring |
Πεδίοcontent_url | Τύποςsigned URL |
Πεδίοdata[] | Τύποςsigned URL |
Πεδίοusage | Τύποςobject |
Πεδίοresult_pending_check | Τύποςboolean |
Σφάλματα και επόμενα βήματα
| Απάντηση | Συνθήκη | Επόμενο βήμα |
|---|---|---|
Απάντηση400 · invalid_request_error | ΣυνθήκηΜη έγκυρα υποχρεωτικά πεδία, μη έγκυρη αναπαράσταση υλικού ή μη έγκυρη τιμή παραμέτρου | Επόμενο βήμαΔιορθώστε τα υποδεικνυόμενα πεδία πριν από νέο αίτημα δημιουργίας. |
Απάντηση409 · video_not_ready | ΣυνθήκηΤο περιεχόμενο του αρχικού αποτελέσματος δεν είναι ακόμη διαθέσιμο | Επόμενο βήμαΕλέγχετε περιοδικά το αρχικό ID που επιστρέφεται και τηρείτε το Retry-After. |
Απάντησηserver_error | ΣυνθήκηΗ απόκριση που επιστράφηκε αναφέρει ότι η λειτουργία ή το αποτέλεσμα χρειάζεται έλεγχο | Επόμενο βήμαΔιατηρήστε το αρχικό ID της λειτουργίας/εργασίας που επιστράφηκε, τις κεφαλίδες του αιτήματος και την απόκριση· συνεχίστε με τις υποστηριζόμενες αναγνώσεις αυτής της αρχικής λειτουργίας. Μην υποβάλετε ξανά το αίτημα δημιουργίας. |
Εναλλακτικά ονόματα
Εναλλακτικά ονόματα μοντέλου
Ailoot MiniMax-Hailuo-2.3
Ailoot Ultra MiniMax-Hailuo-2.3
Εναλλακτικές διαδρομές μεθόδων
/v1/videos/generations, /videos, /videos/generations
Σχετικά ID μοντέλων
Ailoot Ultra · Βίντεο POST /v1/videos MiniMax-Hailuo-2.3
MiniMax-Hailuo-2.3Εισαγωγή
Το MiniMax Hailuo 2.3 δημιουργεί βίντεο από κείμενο ή αρχική εικόνα, με χειριστήρια κίνησης και κατεύθυνσης κάμερας. Επιλέξτε έξι δευτερόλεπτα σε 768P ή 1080P ή δέκα δευτερόλεπτα σε 768P για ερμηνείες χαρακτήρων, στιλιζαρισμένες σκηνές και πλάνα προϊόντων που μπορούν να ελεγχθούν και να μονταριστούν.
- Αποδεκτές είσοδοι
- Κείμενο
- Αποτελέσματα
- Βίντεο
Διαθέσιμα στο Ailoot · είσοδοι και μέθοδοι
Ailoot Ultra · Βίντεο POST /v1/videos
- Είσοδος
text- Έξοδος
video- Μορφή εξόδου
- mp4
- Πλήθος εξόδων
- Έως 1 έξοδος
| Πεδίο | Τύπος | Απαίτηση | Τιμές και όρια | Προεπιλογή |
|---|---|---|---|---|
Πεδίοmodel | Τύποςstring | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια MiniMax-Hailuo-2.3 | Προεπιλογή— |
Πεδίοprompt | Τύποςstring | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια Ελάχιστο μήκος: 1 Μέγιστο μήκος: 2.000 Συνθήκες: Για 768P: το πολύ 2000 κωδικά σημεία Unicode. Για 1080P: λιγότερα από 200 κωδικά σημεία Unicode (μέγιστο 199). Η προτροπή πρέπει να περιέχει κείμενο που δεν αποτελείται μόνο από κενά. Μονάδα: χαρακτήρες Unicode | Προεπιλογή— |
Πεδίοduration | Τύποςinteger | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια 6 Μονάδα: δευτερόλεπτα | Προεπιλογή— |
Πεδίοresolution | Τύποςstring | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια 768P, 1080P | Προεπιλογή— |
Συνδυασμοί υλικών εισόδου
Κείμενο σε βίντεο · Υποχρεωτικό: prompt
Παράμετροι και κύκλος ζωής μεθόδου
| Παράμετρος | Σύμβαση |
|---|---|
Παράμετροςcontent_type | Σύμβασηapplication/json |
Παράμετροςrequired | Σύμβασηmodel, prompt, duration, resolution |
Παράμετροςother_options | Σύμβασηfalse |
Παράμετροςduration | Σύμβαση6 |
Παράμετροςresolution | Σύμβαση768P, 1080P |
Παράμετροςprompt_max_characters | Σύμβαση2000 |
Παράμετροςmaterial_types | Σύμβασηtext |
Παράμετροςprompt_max_characters_by_resolution | Σύμβαση{"768P":2000,"1080P":199} |
Εναλλακτικά ονόματα μεθόδου: /v1/videos/generations, /videos, /videos/generations
Κύκλος ζωής: submit_once_poll_original
GET /v1/videos/{request_id}
GET /v1/videos/generations/{request_id}
GET /v1/videos/{request_id}/content
GET /v1/videos/generations/{request_id}/content
Δημιουργήστε μία φορά και αποθηκεύστε το ID που επιστρέφεται.
Ελέγχετε περιοδικά την αρχική κατάσταση· διατηρήστε κάθε ολοκληρωμένο αρχείο πολυμέσων και τη διάρκειά του.
Τιμολόγηση
Οι τιμολογιακές αναφορές δεν προσθέτουν επιλογές αιτήματος. Οι υποστηριζόμενες παράμετροι αναφέρονται στην επιλεγμένη μέθοδο.
- Γρήγορη λειτουργία
- Δεν έχει οριστεί Όταν επιλέγεται η γρήγορη λειτουργία
- Λειτουργία flex
- Δεν έχει οριστεί Όταν επιλέγεται η λειτουργία flex
- Μέγιστη προσπάθεια συλλογισμού
- Δεν έχει οριστεί Όταν η μέγιστη προσπάθεια συλλογισμού χρησιμοποιεί την προσαρμογή default
Χρεώσεις Ailoot
Τιμές ανά διαμόρφωση
Αντιστοιχίστε κάθε χρέωση στις συνθήκες που εμφανίζονται. Χρησιμοποιήστε μία χρέωση ανά σύνολο εναλλακτικών διαμορφώσεων.
| Διαμόρφωση | Πίνακας χρεώσεων | Ονομαστική διάρκεια αποσπάσματος, δευτερόλεπτα | Ανάλυση | Μονάδα τιμολόγησης | Χρέωση |
|---|---|---|---|---|---|
| ΔιαμόρφωσηΒασικές χρεώσεις token | Πίνακας χρεώσεωνΒασική χρέωση | Ονομαστική διάρκεια αποσπάσματος, δευτερόλεπτα— | Ανάλυση— | Μονάδα τιμολόγησης— | Χρέωση Είσοδος · Token εισόδου — / 1K token Έξοδος · Token εξόδου — / 1K token Είσοδος · Ανάγνωση από την κρυφή μνήμη — / 1K token Είσοδος · Εγγραφή στην κρυφή μνήμη — / 1K token Είσοδος · Εγγραφή στην κρυφή μνήμη, 1 ώρα — / 1K token |
| ΔιαμόρφωσηUltra | Πίνακας χρεώσεων— | Ονομαστική διάρκεια αποσπάσματος, δευτερόλεπτα6 | Ανάλυση1080P | Μονάδα τιμολόγησηςανά απόσπασμα εξόδου ονομαστικής διάρκειας 6s | Χρέωση Έξοδος · ονομαστικό κλιπ εξόδου 6s $1.2 ανά απόσπασμα εξόδου ονομαστικής διάρκειας 6s |
| ΔιαμόρφωσηUltra | Πίνακας χρεώσεων— | Ονομαστική διάρκεια αποσπάσματος, δευτερόλεπτα6 | Ανάλυση768P | Μονάδα τιμολόγησηςανά απόσπασμα εξόδου ονομαστικής διάρκειας 6s | Χρέωση Έξοδος · ονομαστικό κλιπ εξόδου 6s $0.6 ανά απόσπασμα εξόδου ονομαστικής διάρκειας 6s |
Το Ailoot δεσμεύει ένα εκτιμώμενο ποσό πριν από το αίτημα. Μετά το αποτέλεσμα, εκκαθαρίζει την τελική χρέωση βάσει της μετρημένης χρήσης. Η εκκαθάριση ροής χρησιμοποιεί την τελική καταγραφή χρήσης. Πώς λειτουργούν η δέσμευση και η εκκαθάριση →
Στοιχεία τιμοκαταλόγου αναφοράς
Οι πίνακες αναφοράς του μοντέλου δεν αλλάζουν την επιλογή μεθόδου, τις εκτιμήσεις τιμής ή τις χρεώσεις. Οι εφαρμοζόμενες χρεώσεις χρησιμοποιούν τις τιμές της επιλεγμένης μεθόδου Ailoot.
MiniMax-Hailuo-2.3
Τιμές ανά διαμόρφωση
| Διαμόρφωση | Συνθήκες χρέωσης | Χρέωση |
|---|---|---|
| ΔιαμόρφωσηMiniMax-Hailuo-2.3 · Προεπιλεγμένη διαμόρφωση | Συνθήκες χρέωσηςΠροεπιλεγμένη διαμόρφωση | Χρέωση Είσοδος · Είσοδος 0,00 $ ανά κλήση Έξοδος · Έξοδος 0,60 $ ανά κλήση |
MiniMax-Hailuo-2.3
Τιμές ανά διαμόρφωση
| Διαμόρφωση | Συνθήκες χρέωσης | Χρέωση |
|---|---|---|
| ΔιαμόρφωσηMiniMax-Hailuo-2.3 · Προεπιλεγμένη διαμόρφωση | Συνθήκες χρέωσηςΠροεπιλεγμένη διαμόρφωση | Χρέωση Είσοδος · Είσοδος 0,00 $ ανά κλήση Έξοδος · Έξοδος 1,20 $ ανά κλήση |
MiniMax-Hailuo-2.3
Τιμές ανά διαμόρφωση
| Διαμόρφωση | Συνθήκες χρέωσης | Χρέωση |
|---|---|---|
| ΔιαμόρφωσηMiniMax-Hailuo-2.3 · Προεπιλεγμένη διαμόρφωση | Συνθήκες χρέωσηςΠροεπιλεγμένη διαμόρφωση | Χρέωση Είσοδος · Είσοδος 0,00 $ ανά κλήση Έξοδος · Έξοδος 1,20 $ ανά κλήση |
Παραδείγματα αιτημάτων
Ailoot Ultra · Βίντεο
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "MiniMax-Hailuo-2.3", "prompt": "A cat in a spacesuit walking on the Moon", "duration": 6, "resolution": "768P"}')
Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
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
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "MiniMax-Hailuo-2.3", "prompt": "A cat in a spacesuit walking on the Moon", "duration": 6, "resolution": "1080P"}')
Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
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
Λήψη και αποθήκευση αποτελεσμάτων
Ailoot Ultra · Βίντεο
mp4
GET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /v1/videos/generations/{request_id}/content
Έλεγχος κατάστασης εργασίας
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_OPERATION_ID:?Set the actual Ailoot operation ID returned by creation}"
export AILOOT_OPERATION_ID
operation_id=$(python3 -c 'import os,urllib.parse;print(urllib.parse.quote(os.environ["AILOOT_OPERATION_ID"],safe=""))')
curl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/videos/$operation_id" \
-H "Authorization: Bearer $AILOOT_API_KEY" -o status.json
python3 - <<'PY_STATUS'
import json
from pathlib import Path
r=json.loads(Path("status.json").read_text())
print(json.dumps(r))
if r.get("status")=="completed":
for x in r.get("data",[]):print(x)
PY_STATUS
Αποθηκεύστε όλα τα ολοκληρωμένα αρχεία
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_STATUS_FILE:?Set the actual completed status JSON file}"
export AILOOT_STATUS_FILE
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
from urllib.parse import urlsplit,urljoin
f=Path(os.environ["AILOOT_STATUS_FILE"])
if not f.is_file():raise SystemExit("Choose the actual completed status file")
r=json.loads(f.read_text())
if r.get("status")!="completed" or not isinstance(r.get("data"),list) or not r["data"]:raise SystemExit("Wait for a completed status with asset paths")
urls=[]
for x in r["data"]:
if not isinstance(x,str) or "\n" in x or "\r" in x:raise SystemExit("Invalid asset path")
u=urljoin("https://api.ailoot.ai",x)
z=urlsplit(u)
if z.scheme!="https" or z.netloc!="api.ailoot.ai" or z.username or z.password:raise SystemExit("Use the actual Ailoot asset paths from status")
urls.append(u)
Path("asset-urls.txt").write_text("\n".join(urls)+"\n")
PY_REQUEST
index=0
while IFS= read -r asset_url; do
curl --fail-with-body --silent --show-error "$asset_url" \
-H "Authorization: Bearer $AILOOT_API_KEY" -o "video-${index}.mp4"
index=$((index + 1))
done < asset-urls.txt
Άλλες ανακτήσεις περιεχομένου
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_OPERATION_ID:?Set the actual Ailoot operation ID returned by creation}"
export AILOOT_OPERATION_ID
operation_id=$(python3 -c 'import os,urllib.parse;print(urllib.parse.quote(os.environ["AILOOT_OPERATION_ID"],safe=""))')
curl --fail-with-body --silent --show-error "https://api.ailoot.ai/v1/videos/$operation_id/content" \
-H "Authorization: Bearer $AILOOT_API_KEY" -o video.mp4
Διατηρήστε όλα τα ολοκληρωμένα αποτελέσματα
Αποθηκεύστε κάθε ολοκληρωμένο βίντεο ή αρχείο που επιστρέφεται· ανακτήστε κάθε πραγματικό URL αρχείου που επιστρέφεται.
Το ολοκληρωμένο data[] περιέχει όλα τα υπογεγραμμένα URL περιεχομένου που σας ανήκουν. Ανακτήστε κάθε URL που επιστρέφεται ή χρησιμοποιήστε το τελικό σημείο περιεχομένου με το index ορισμένο σε πραγματικό δείκτη εξόδου. Μια αποτυχημένη αρχική εργασία μπορεί να επιστρέψει charge_pending_check· ελέγξτε αυτή την αρχική εργασία αντί να τη δημιουργήσετε ξανά.
Αν χρειάζεται έλεγχος της αρχικής απάντησης
Διαβάστε την υπάρχουσα αρχική εργασία· μην επανυποβάλετε ποτέ αποστολή με άγνωστο αποτέλεσμα.
Μέγιστο πλήθος εξόδων: 1.
Πεδία απάντησης
| Πεδίο | Τύπος |
|---|---|
Πεδίοid | Τύποςstring |
Πεδίοobject | Τύποςstring |
Πεδίοmodel | Τύποςstring |
Πεδίοstatus | Τύποςstring |
Πεδίοdata[] | Τύποςsigned content URL |
Πεδίοcharge_pending_check | Τύποςboolean |
Πεδίοerror.code | Τύποςstring |
Πεδίοerror.message | Τύποςstring |
Πεδίοrequested_nominal_duration_seconds | Τύποςinteger |
Πεδίοmeasured_duration_seconds | Τύποςnumber |
Πεδίοwidth | Τύποςinteger |
Πεδίοheight | Τύποςinteger |
Σφάλματα και επόμενα βήματα
| Απάντηση | Συνθήκη | Επόμενο βήμα |
|---|---|---|
Απάντηση400 · invalid_request_error | ΣυνθήκηΜη έγκυρα υποχρεωτικά πεδία, μη έγκυρη αναπαράσταση υλικού ή μη έγκυρη τιμή παραμέτρου | Επόμενο βήμαΔιορθώστε τα υποδεικνυόμενα πεδία πριν από νέο αίτημα δημιουργίας. |
Απάντηση409 · video_not_ready | ΣυνθήκηΤο περιεχόμενο του αρχικού αποτελέσματος δεν είναι ακόμη διαθέσιμο | Επόμενο βήμαΕλέγχετε περιοδικά το αρχικό ID που επιστρέφεται και τηρείτε το Retry-After. |
Απάντησηserver_error | ΣυνθήκηΗ απόκριση που επιστράφηκε αναφέρει ότι η λειτουργία ή το αποτέλεσμα χρειάζεται έλεγχο | Επόμενο βήμαΔιατηρήστε το αρχικό ID της λειτουργίας/εργασίας που επιστράφηκε, τις κεφαλίδες του αιτήματος και την απόκριση· συνεχίστε με τις υποστηριζόμενες αναγνώσεις αυτής της αρχικής λειτουργίας. Μην υποβάλετε ξανά το αίτημα δημιουργίας. |
Εναλλακτικά ονόματα
Εναλλακτικά ονόματα μοντέλου
Ailoot MiniMax-Hailuo-2.3
Ailoot Ultra MiniMax-Hailuo-2.3
Εναλλακτικές διαδρομές μεθόδων
/v1/videos/generations, /videos, /videos/generations
Σχετικά ID μοντέλων
FAQ · MiniMax-Hailuo-2.3
- Ποιες είσοδοι και αποτελέσματα διατίθενται;
POST /v1/videos/generations·MiniMax-Hailuo-2.3:text,image→videoPOST /v1/videos·MiniMax-Hailuo-2.3:text→video- Ποια πεδία χρησιμοποιεί το αίτημα;
POST /v1/videos/generations·MiniMax-Hailuo-2.3:model,prompt,duration,resolution,first_frame_image,prompt_optimizer,fast_pretreatmentPOST /v1/videos·MiniMax-Hailuo-2.3:model,prompt,duration,resolution- Ποια όρια ισχύουν;
POST /v1/videos/generations·MiniMax-Hailuo-2.3:prompt.maximum_length:2000POST /v1/videos·MiniMax-Hailuo-2.3:prompt.maximum_length:2000