MiniMax: Hailuo 02
Το Hailuo 02 δημιουργεί βίντεο από κείμενο ή εικόνα πρώτου καρέ και υποστηρίζει τεκμηριωμένη ροή εργασίας με πρώτο και τελευταίο καρέ. Οι εντολές κάμερας, η βελτιστοποίηση της προτροπής και οι επιλογές διάρκειας και ανάλυσης ανά λειτουργία βοηθούν στη διαμόρφωση του επιθυμητού πλάνου.
Σχετικά με το μοντέλο
Αυτή η περιγραφή καλύπτει τις δυνατότητες του μοντέλου. Οι είσοδοι, έξοδοι και επιλογές που διατίθενται στο Ailoot παρατίθενται παρακάτω για την επιλεγμένη μέθοδο.
Το Hailuo 02 είναι το μοντέλο βίντεο της MiniMax για σκηνές από κείμενο, κίνηση εικόνων και ροή εργασίας με πρώτο και τελευταίο καρέ. Μια γραπτή περιγραφή καθορίζει το θέμα, τη δράση και την κάμερα, ενώ οι εικόνες καρέ που παρέχονται μπορούν να ορίσουν την οπτική αφετηρία ή τον προορισμό της μετάβασης. Επιλέξτε τη λειτουργία δημιουργίας ανάλογα με το υλικό που έχετε ήδη και το μέρος του πλάνου που χρειάζεται να ελέγξετε.
Για δημιουργία βίντεο από κείμενο, περιγράψτε μια συνεκτική δράση με ευδιάκριτο περιβάλλον και οπτική γωνία. Μια σκηνή μπορεί να δείχνει ένα μικρό ιστιοφόρο που περνά δίπλα από μια προβλήτα, ενώ η κάμερα το ακολουθεί από την ακτή. Προσδιορίστε τι κινείται, ποιες λεπτομέρειες πρέπει να παραμένουν ορατές και πώς τελειώνει το πλάνο. Κρατήστε την περιγραφή εστιασμένη σε παρατηρήσιμα γεγονότα αντί για μια λίστα άσχετων οπτικών ποιοτήτων.
Για δημιουργία βίντεο από εικόνα, προετοιμάστε ένα πρώτο καρέ στο οποίο έχουν ήδη καθοριστεί το επιθυμητό θέμα και το καδράρισμα. Ο κατασκευαστής δέχεται εικόνες JPG, JPEG, PNG και WebP μικρότερες από 20 MB, με μικρή πλευρά μεγαλύτερη από 300 pixel και αναλογία πλευρών μεταξύ 2:5 και 5:2. Χρησιμοποιήστε μια εικόνα με ορατά τα σημαντικά περιγράμματα και χαρακτηριστικά και περιγράψτε την κίνηση που πρέπει να αναπτυχθεί από αυτή.
Το Hailuo 02 διαθέτει επίσης τεκμηριωμένη λειτουργία πρώτου και τελευταίου καρέ. Προετοιμάστε τις δύο εικόνες ως την επιθυμητή αρχική και τελική κατάσταση μιας ακολουθίας και περιγράψτε πώς κινείται η σκηνή μεταξύ τους. Το πρώτο καρέ καθορίζει το καδράρισμα· ο κατασκευαστής δηλώνει ότι ένα τελευταίο καρέ διαφορετικών διαστάσεων περικόπτεται ώστε να ταιριάζει με αυτό. Ευθυγραμμίστε εκ των προτέρων τη σύνθεση των εικόνων όταν ένα θέμα πρέπει να παραμένει ορατό σε όλη τη μετάβαση.
Η προτροπή μπορεί να περιέχει έως 2.000 χαρακτήρες. Το Hailuo 02 υποστηρίζει εντολές κάμερας μέσα σε αγκύλες, μεταξύ άλλων push, pull, truck, pan, pedestal, tilt, zoom, tracking και στατικό πλάνο. Εντολές μαζί στην ίδια αγκύλη ζητούν ταυτόχρονη κίνηση· εντολές σε διαφορετικά σημεία της περιγραφής ζητούν μια ακολουθία. Ο κατασκευαστής συνιστά συνδυασμό έως τριών κινήσεων, επομένως επιλέξτε τη δράση της κάμερας που κάνει το θέμα πιο ευδιάκριτο.
Η διάρκεια και η ανάλυση συνδέονται με τη λειτουργία. Η δημιουργία από κείμενο τεκμηριώνει έξι ή δέκα δευτερόλεπτα στα 768P και έξι δευτερόλεπτα στα 1080P. Η δημιουργία από εικόνα τεκμηριώνει επίσης 512P για έξι ή δέκα δευτερόλεπτα. Η ροή εργασίας με πρώτο και τελευταίο καρέ τεκμηριώνει 768P για έξι ή δέκα δευτερόλεπτα και 1080P για έξι δευτερόλεπτα. Επιλέξτε έναν υποστηριζόμενο συνδυασμό για το πλάνο, αντί να μεταφέρετε τις επιλογές ανάλυσης μιας λειτουργίας σε όλες τις άλλες.
Η αυτόματη βελτιστοποίηση της προτροπής είναι τεκμηριωμένη παράμετρος ελέγχου και είναι ενεργοποιημένη από προεπιλογή στη ροή εργασίας του κατασκευαστή. Διατηρήστε τη ρύθμισή της κατά τη σύγκριση εκδοχών, επειδή μια ξαναγραμμένη περιγραφή αλλάζει όσα λαμβάνει το μοντέλο. Κρατήστε το ακριβές κείμενο, τα καρέ αναφοράς και τις επιλεγμένες ρυθμίσεις εξόδου μαζί με το παραγόμενο απόσπασμα, ώστε μια αναθεώρηση να μπορεί να στοχεύσει τη δράση ή το καδράρισμα που χρειάζεται βελτίωση.
Ελέγξτε ολόκληρη την ολοκληρωμένη ακολουθία: την αρχική σύνθεση, τη συνέχεια του θέματος, τον χρονισμό της δράσης και το τελικό καρέ. Για μια μετάβαση, ελέγξτε το πρώτο και το τελευταίο καρέ και την κίνηση μεταξύ τους. Αποθηκεύστε το πραγματικό βίντεο για επεξεργασία, μαζί με την προτροπή και τις αναφορές· χρησιμοποιήστε την επόμενη αναθεώρηση για να αντιμετωπίσετε ένα συγκεκριμένο οπτικό πρόβλημα, όπως μια κρυμμένη λεπτομέρεια, μια απότομη κίνηση της κάμερας ή ένα τέλος που έρχεται πολύ νωρίς.
Ailoot Ultra · Βίντεο POST /v1/videos minimaxi-hailuo-02
minimaxi-hailuo-02Εισαγωγή
Το Hailuo 02 δημιουργεί βίντεο από κείμενο ή εικόνα πρώτου καρέ και υποστηρίζει τεκμηριωμένη ροή εργασίας με πρώτο και τελευταίο καρέ. Οι εντολές κάμερας, η βελτιστοποίηση της προτροπής και οι επιλογές διάρκειας και ανάλυσης ανά λειτουργία βοηθούν στη διαμόρφωση του επιθυμητού πλάνου.
- Αποδεκτές είσοδοι
- Κείμενο · Εικόνες
- Αποτελέσματα
- Βίντεο
Διαθέσιμα στο Ailoot · είσοδοι και μέθοδοι
Ailoot Ultra · Βίντεο POST /v1/videos
- Είσοδος
text,image- Έξοδος
video
| Πεδίο | Τύπος | Απαίτηση | Τιμές και όρια | Προεπιλογή |
|---|---|---|---|---|
Πεδίοmodel | Τύποςstring | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια minimaxi-hailuo-02 Συνθήκες: Χρησιμοποιήστε τον ακριβή επιλογέα μοντέλου Ailoot. | Προεπιλογή— |
Πεδίοprompt | Τύποςstring | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια Συνθήκες: Περιγράψτε τη σκηνή και την κίνηση. | Προεπιλογή— |
Πεδίοduration | Τύποςinteger | ΑπαίτησηΠροαιρετικό | Τιμές και όρια 6, 10 Συνθήκες: Στείλτε μία από τις αναγραφόμενες τιμές διάρκειας· δεν δηλώνεται προεπιλογή. | Προεπιλογή— |
Πεδίοend_image | Τύποςstring | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Συνθήκες: Ένα τελικό καρέ ισχύει μόνο σε υποστηριζόμενη λειτουργία εισόδου εικόνας. | Προεπιλογή— |
Πεδίοimage | Τύποςstring or array<string> | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Συνθήκες: Χρησιμοποιήστε πραγματικό δημόσια προσβάσιμο URL εικόνας ή συμβολοσειρά εικόνας base64· δεν δηλώνεται εδώ μέγιστο πλήθος εικόνων. | Προεπιλογή— |
Πεδίοresolution | Τύποςstring | ΑπαίτησηΠροαιρετικό | Τιμές και όρια 512P, 768P, 1080P Συνθήκες: Στείλτε μία από τις αναγραφόμενες τιμές ανάλυσης· δεν δηλώνεται προεπιλογή. | Προεπιλογή— |
Παράμετροι και κύκλος ζωής μεθόδου
| Παράμετρος | Σύμβαση |
|---|---|
Παράμετροςcontent_type | Σύμβασηapplication/json |
Παράμετροςrequired | Σύμβασηmodel, prompt |
Παράμετροςoptional | Σύμβασηduration, end_image, image, resolution |
Παράμετροςmaterial_types | Σύμβασηtext, image |
Παράμετροςconditions | ΣύμβασηΧρησιμοποιήστε τον ακριβή επιλογέα μοντέλου Ailoot., Περιγράψτε τη σκηνή και την κίνηση., Στείλτε μία από τις αναγραφόμενες τιμές διάρκειας· δεν δηλώνεται προεπιλογή., Ένα τελικό καρέ ισχύει μόνο σε υποστηριζόμενη λειτουργία εισόδου εικόνας., Χρησιμοποιήστε πραγματικό δημόσια προσβάσιμο URL εικόνας ή συμβολοσειρά εικόνας base64· δεν δηλώνεται εδώ μέγιστο πλήθος εικόνων., Στείλτε μία από τις αναγραφόμενες τιμές ανάλυσης· δεν δηλώνεται προεπιλογή. |
Εναλλακτικά ονόματα μεθόδου: /v1/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/media/assets
GET /v1/media/assets/{asset_id}
Τιμολόγηση
Πώς υπολογίζεται η τελική χρέωση
Οι εμφανιζόμενες τιμές χρησιμοποιούνται για την εκτίμηση του κόστους πριν από την παραγωγή. Η τελική χρέωση υπολογίζεται από το κόστος που καταγράφηκε για την αρχική παραγωγή. Η μετρημένη διάρκεια της εξόδου και οι προβλεπόμενες ποσότητες δεν αποτελούν την τελική χρεώσιμη ποσότητα.
Οι τιμολογιακές αναφορές δεν προσθέτουν επιλογές αιτήματος. Οι υποστηριζόμενες παράμετροι αναφέρονται στην επιλεγμένη μέθοδο.
- Γρήγορη λειτουργία
- Δεν έχει οριστεί Όταν επιλέγεται η γρήγορη λειτουργία
- Λειτουργία flex
- Δεν έχει οριστεί Όταν επιλέγεται η λειτουργία flex
- Μέγιστη προσπάθεια συλλογισμού
- Δεν έχει οριστεί Όταν η μέγιστη προσπάθεια συλλογισμού χρησιμοποιεί την προσαρμογή default
Εκτιμώμενες χρεώσεις για σύγκριση
Τιμές ανά διαμόρφωση
Αντιστοιχίστε κάθε χρέωση στις συνθήκες που εμφανίζονται. Χρησιμοποιήστε μία χρέωση ανά σύνολο εναλλακτικών διαμορφώσεων.
| Διαμόρφωση | Πίνακας χρεώσεων | Προβλεπόμενη ποσότητα | Χρέωση |
|---|---|---|---|
| ΔιαμόρφωσηΒασικές χρεώσεις token | Πίνακας χρεώσεωνΒασική χρέωση | Προβλεπόμενη ποσότητα— | Χρέωση Είσοδος · Token εισόδου · Εκτίμηση μόνο για σύγκριση — / 1K token Έξοδος · Token εξόδου · Εκτίμηση μόνο για σύγκριση — / 1K token Είσοδος · Ανάγνωση από την κρυφή μνήμη · Εκτίμηση μόνο για σύγκριση — / 1K token Είσοδος · Εγγραφή στην κρυφή μνήμη · Εκτίμηση μόνο για σύγκριση — / 1K token Είσοδος · Εγγραφή στην κρυφή μνήμη, 1 ώρα · Εκτίμηση μόνο για σύγκριση — / 1K token |
| ΔιαμόρφωσηΕκτιμώμενο κόστος δημιουργίας | Πίνακας χρεώσεων— | Προβλεπόμενη ποσότηταεκτίμηση για μία δημιουργία | Χρέωση Έξοδος · Εκτιμώμενο κόστος δημιουργίας · Εκτίμηση μόνο για σύγκριση $0.2 εκτίμηση πριν από τη δημιουργία Αυτή η εκτίμηση δεν αποτελεί πρόσθετη χρέωση ούτε σταθερή τιμή για την ολοκληρωμένη παραγωγή. |
Το Ailoot δεσμεύει ένα εκτιμώμενο ποσό πριν από το αίτημα. Μετά το αποτέλεσμα, εκκαθαρίζει την τελική χρέωση βάσει της μετρημένης χρήσης. Η εκκαθάριση ροής χρησιμοποιεί την τελική καταγραφή χρήσης. Πώς λειτουργούν η δέσμευση και η εκκαθάριση →
Παραδείγματα αιτημάτων
Ailoot Ultra · Βίντεο
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
cat > request.json <<'JSON'
{
"model": "minimaxi-hailuo-02",
"prompt": "A cat is walking on grass."
}
JSON
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
# Create once; retain id, polling_url, original task identifiers and every header.
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_STATUS'
import json,os,subprocess
from pathlib import Path
from urllib.parse import urljoin,urlsplit
r=json.loads(Path("result.json").read_text())
u=urljoin("https://api.ailoot.ai",r["polling_url"])
p=urlsplit(u)
if p.scheme!="https" or p.netloc!="api.ailoot.ai" or p.username or p.password:
raise SystemExit("Unexpected returned polling URL; preserve the response")
subprocess.run(["curl","--fail-with-body","--silent","--show-error",u,"-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"],"-D","status-headers.txt","-o","status.json"],check=True)
# Read this same original polling_url again while pending.
# Preserve unknown/result_pending_check; do not repeat creation.
PY_STATUS
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())
roles={}
def visit(v,path=""):
if isinstance(v,dict):
for k,x in v.items(): visit(x,path+"/"+k)
elif isinstance(v,list):
for i,x in enumerate(v): visit(x,path+"/"+str(i))
elif isinstance(v,str):
u=urljoin("https://api.ailoot.ai",v); p=urlsplit(u)
if p.scheme=="https" and p.netloc=="api.ailoot.ai" and not p.username and not p.password and p.path.startswith("/v1/media/assets/") and p.path.endswith("/content"):
roles.setdefault(u,[]).append(path)
visit(r)
if not roles: raise SystemExit("No completed owned assets; retain the original status")
manifest=[]
for i,(u,paths) in enumerate(roles.items()):
target=Path(f"asset-{i}.bin")
subprocess.run(["curl","--fail-with-body","--silent","--show-error",u,"-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"],"-o",str(target)],check=True)
raw=target.read_bytes()
if not raw: raise SystemExit("Empty asset; retain original status and metadata")
ext="glb" if raw[:4]==b"glTF" else "png" if raw[:8]==b"\x89PNG\r\n\x1a\n" else "jpg" if raw[:3]==b"\xff\xd8\xff" else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "mp4" if raw[4:8]==b"ftyp" else "bin"
name=f"asset-{i}.{ext}"
if target.name!=name: target.rename(name)
manifest.append({"file":name,"response_paths":paths,"bytes":len(raw)})
Path("asset-manifest.json").write_text(json.dumps(manifest,indent=2))
print("Saved",len(manifest),"unique owned assets; every response role retained")
PY_ASSETS
Λήψη και αποθήκευση αποτελεσμάτων
Ailoot Ultra · Βίντεο
GET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
Διατηρήστε όλα τα ολοκληρωμένα αποτελέσματα
Αποθηκεύστε κάθε ολοκληρωμένο βίντεο ή αρχείο που επιστρέφεται· ανακτήστε κάθε πραγματικό URL αρχείου που επιστρέφεται.
Διατηρήστε ολόκληρη την απόκριση και τις κεφαλίδες, τα αρχικά αναγνωριστικά, κάθε πραγματική έξοδο και όλα τα πεδία χρήσης και λογιστικής καταγραφής. Αποθηκεύστε κάθε μοναδικό αρχείο πολυμέσων που σας ανήκει και διατηρήστε κάθε ρόλο που παραπέμπει σε αυτό.
Αν χρειάζεται έλεγχος της αρχικής απάντησης
Διατηρήστε το δημόσιο id εργασίας ή λειτουργίας που επιστρέφεται και όλες τις κεφαλίδες. Διαβάστε μόνο την αρχική εργασία· τα unknown ή result_pending_check δεν επιτρέπουν άλλη δημιουργία.
Πεδία απάντησης
| Πεδίο | Τύπος |
|---|---|
Πεδίοid | Τύποςstring |
Πεδίοpolling_url | Τύποςstring |
Πεδίοprovider_task_id | Τύποςstring |
Πεδίοtask_id | Τύποςstring |
Πεδίοstatus | Τύποςstring |
Πεδίοvideo_url | Τύποςstring |
Εναλλακτικά ονόματα
Εναλλακτικά ονόματα μοντέλου
Ailoot Ultra minimaxi-hailuo-02
Εναλλακτικές διαδρομές μεθόδων
/v1/videos/generations
Σχετικά ID μοντέλων
FAQ · MiniMax: Hailuo 02
- Ποιες είσοδοι και αποτελέσματα διατίθενται;
POST /v1/videos·minimaxi-hailuo-02:text,image→video- Ποια πεδία χρησιμοποιεί το αίτημα;
POST /v1/videos·minimaxi-hailuo-02:model,prompt,duration,end_image,image,resolution