MiniMax: I2V 01
Το I2V 01 δίνει κίνηση σε μια εικόνα πρώτου καρέ που παρέχεται, με προαιρετική περιγραφή κειμένου για τη δράση. Προετοιμάστε την αρχική σύνθεση, κατευθύνετε την ορατή κίνηση και ελέγξτε το ολοκληρωμένο απόσπασμα ως προς τη συνέχεια του θέματος και το καδράρισμα.
Σχετικά με το μοντέλο
Αυτή η περιγραφή καλύπτει τις δυνατότητες του μοντέλου. Οι είσοδοι, έξοδοι και επιλογές που διατίθενται στο Ailoot παρατίθενται παρακάτω για την επιλεγμένη μέθοδο.
Το I2V 01 είναι η έκδοση δημιουργίας βίντεο από εικόνα της MiniMax για την ανάπτυξη κίνησης από ένα πρώτο καρέ που παρέχεται. Η εικόνα καθορίζει το θέμα και την αρχική σύνθεση· μια προαιρετική γραπτή προτροπή περιγράφει τη δράση που θα ακολουθήσει. Χρησιμοποιήστε το όταν η αρχική εικόνα υπάρχει ήδη ως φωτογραφία, παραγόμενη εικόνα ή προετοιμασμένη σκηνή και η εργασία είναι να μετατραπεί σε σύντομη ακολουθία βίντεο.
Επιλέξτε το πρώτο καρέ για την κίνηση που θέλετε να δείξετε. Μια εικόνα προϊόντος πρέπει να αποκαλύπτει το σχήμα και τις επιφάνειες που χρειάζεται να παραμένουν αναγνωρίσιμα. Ένα πορτρέτο πρέπει να δείχνει καθαρά το πρόσωπο και να αφήνει αρκετό χώρο για τη ζητούμενη χειρονομία. Για ένα περιβάλλον, προσδιορίστε το στοιχείο που φέρει την κίνηση, όπως φύλλα, νερό ή ένα άτομο που διασχίζει τη σκηνή. Προετοιμάστε τη σύνθεση πριν από τη δημιουργία, ώστε η δράση να έχει χρήσιμη αφετηρία.
Οι απαιτήσεις εικόνας του κατασκευαστή είναι JPG, JPEG, PNG ή WebP, κάτω από 20 MB, με τη μικρότερη πλευρά μεγαλύτερη από 300 pixel. Η αποδεκτή αναλογία πλευρών κυμαίνεται από 2:5 έως 5:2. Το πρώτο καρέ μπορεί να παρέχεται μέσω προσβάσιμου URL εικόνας ή κωδικοποιημένων δεδομένων εικόνας στη ροή εργασίας του κατασκευαστή. Διατηρήστε το πραγματικό αρχείο εικόνας μαζί με το αρχείο του αιτήματος, ώστε η οπτική αφετηρία να διατηρείται για μεταγενέστερη σύγκριση.
Χρησιμοποιήστε την περιγραφή κειμένου για να δηλώσετε την ορατή κίνηση, τον ρυθμό της και την επιθυμητή τελική κατάσταση. Για παράδειγμα, ένα κεραμικό φλιτζάνι πάνω σε τραπέζι μπορεί να παραμένει ακίνητο ενώ ανεβαίνει ατμός και η κουρτίνα στο φόντο κινείται ελαφρά. Ένα άτομο μπορεί να στραφεί προς ένα παράθυρο και να σταματήσει. Δώστε στο θέμα μία ευδιάκριτη δράση και εξηγήστε ποια χαρακτηριστικά πρέπει να παραμένουν ορατά σε όλη τη διάρκειά της.
Η προτροπή επιτρέπει έως 2.000 χαρακτήρες. Γράψτε τις χρήσιμες λεπτομέρειες με φυσική σειρά: θέμα, δράση, περιβάλλον και οπτική γωνία. Όταν η εικόνα καθορίζει ήδη τη σκηνή, χρησιμοποιήστε το κείμενο για να διευκρινίσετε την κίνηση αντί να επαναλάβετε κάθε ορατό αντικείμενο. Μια συνοπτική οδηγία για την κατεύθυνση και την έκταση μιας χειρονομίας μπορεί να είναι πιο χρήσιμη από πολλά γενικά επίθετα για κινηματογραφική ποιότητα.
Ο παλαιότερος πίνακας δημιουργίας βίντεο από εικόνα του κατασκευαστή αναφέρει τα 720P ως προεπιλογή για το I2V 01 και δεν αναφέρει επιλογή δέκα δευτερολέπτων για αυτή την έκδοση. Διατηρήστε τις επιλεγμένες ρυθμίσεις εξόδου μαζί με το απόσπασμα και αξιολογήστε τον πραγματικό χρονισμό του αποτελέσματος. Προετοιμάστε ένα πλάνο του οποίου η κύρια δράση μπορεί να γίνει κατανοητή ως μία σύντομη ακολουθία, με αρχική και τελική κατάσταση χρήσιμες για το επιθυμητό μοντάζ.
Η αυτόματη βελτιστοποίηση της προτροπής είναι ενεργοποιημένη από προεπιλογή στην τεκμηριωμένη ροή εργασίας του κατασκευαστή. Καταγράψτε αν χρησιμοποιείται κατά τη σύγκριση μιας αναθεώρησης. Διατηρήστε σταθερή την εικόνα όταν δοκιμάζετε διαφορετική περιγραφή δράσης ή κρατήστε σταθερή την περιγραφή όταν συγκρίνετε διαφορετική αρχική σύνθεση. Έτσι είναι ευκολότερο να διακρίνετε ποια δημιουργική αλλαγή επηρέασε το αποτέλεσμα.
Ελέγξτε το ολοκληρωμένο βίντεο από την αρχή έως το τέλος. Εξετάστε αν το θέμα παραμένει αναγνωρίσιμο, αν η κίνηση σέβεται την ορατή δομή της πηγής και αν η σημαντική λεπτομέρεια παραμένει στο κάδρο. Για μια σκηνή προϊόντος, ελέγξτε τα περιγράμματα και την εμφάνιση του υλικού κατά την κίνηση· για ένα πορτρέτο, ελέγξτε τη συνέχεια του προσώπου και της χειρονομίας. Αποθηκεύστε το πραγματικό απόσπασμα με την εικόνα προέλευσης και την προτροπή του και αναθεωρήστε το συγκεκριμένο πρόβλημα κίνησης ή καδραρίσματος που παραμένει.
Ailoot Ultra · Βίντεο POST /v1/videos minimaxi-i2v-01
minimaxi-i2v-01Εισαγωγή
Το I2V 01 δίνει κίνηση σε μια εικόνα πρώτου καρέ που παρέχεται, με προαιρετική περιγραφή κειμένου για τη δράση. Προετοιμάστε την αρχική σύνθεση, κατευθύνετε την ορατή κίνηση και ελέγξτε το ολοκληρωμένο απόσπασμα ως προς τη συνέχεια του θέματος και το καδράρισμα.
- Αποδεκτές είσοδοι
- Κείμενο · Εικόνες
- Αποτελέσματα
- Βίντεο
Διαθέσιμα στο Ailoot · είσοδοι και μέθοδοι
Ailoot Ultra · Βίντεο POST /v1/videos
- Είσοδος
text,image- Έξοδος
video
| Πεδίο | Τύπος | Απαίτηση | Τιμές και όρια | Προεπιλογή |
|---|---|---|---|---|
Πεδίοmodel | Τύποςstring | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια minimaxi-i2v-01 Συνθήκες: Χρησιμοποιήστε τον ακριβή επιλογέα μοντέλου Ailoot. | Προεπιλογή— |
Πεδίοprompt | Τύποςstring | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια Συνθήκες: Περιγράψτε τη σκηνή και την κίνηση. | Προεπιλογή— |
Πεδίοend_image | Τύποςstring | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Συνθήκες: Ένα τελικό καρέ ισχύει μόνο σε υποστηριζόμενη λειτουργία εισόδου εικόνας. | Προεπιλογή— |
Πεδίοimage | Τύποςstring or array<string> | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Συνθήκες: Χρησιμοποιήστε πραγματικό δημόσια προσβάσιμο URL εικόνας ή συμβολοσειρά εικόνας base64· δεν δηλώνεται εδώ μέγιστο πλήθος εικόνων. | Προεπιλογή— |
Παράμετροι και κύκλος ζωής μεθόδου
| Παράμετρος | Σύμβαση |
|---|---|
Παράμετροςcontent_type | Σύμβασηapplication/json |
Παράμετροςrequired | Σύμβασηmodel, prompt |
Παράμετροςoptional | Σύμβασηend_image, image |
Παράμετρος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 |
| ΔιαμόρφωσηΑνά αίτημα | Πίνακας χρεώσεων— | Προβλεπόμενη ποσότητα— | Ποσότητα τιμολόγησηςένα αίτημα | Χρέωση Είσοδος · Εκτίμηση μόνο για σύγκριση $1 ανά αίτημα |
| ΔιαμόρφωσηΕκτιμώμενο κόστος δημιουργίας | Πίνακας χρεώσεων— | Προβλεπόμενη ποσότηταεκτίμηση για μία δημιουργία | Ποσότητα τιμολόγησης— | Χρέωση Έξοδος · Εκτιμώμενο κόστος δημιουργίας · Εκτίμηση μόνο για σύγκριση $1 εκτίμηση πριν από τη δημιουργία Αυτή η εκτίμηση δεν αποτελεί πρόσθετη χρέωση ούτε σταθερή τιμή για την ολοκληρωμένη παραγωγή. |
Το Ailoot δεσμεύει ένα εκτιμώμενο ποσό πριν από το αίτημα. Μετά το αποτέλεσμα, εκκαθαρίζει την τελική χρέωση βάσει της μετρημένης χρήσης. Η εκκαθάριση ροής χρησιμοποιεί την τελική καταγραφή χρήσης. Πώς λειτουργούν η δέσμευση και η εκκαθάριση →
Παραδείγματα αιτημάτων
Ailoot Ultra · Βίντεο
# Replace YOUR_ACCESSIBLE_IMAGE_URL with your actual reachable reference image URL.
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
cat > request.json <<'JSON'
{
"model": "minimaxi-i2v-01",
"prompt": "A cat is walking on grass.",
"image": "YOUR_ACCESSIBLE_IMAGE_URL"
}
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-i2v-01
Εναλλακτικές διαδρομές μεθόδων
/v1/videos/generations
Σχετικά ID μοντέλων
FAQ · MiniMax: I2V 01
- Ποιες είσοδοι και αποτελέσματα διατίθενται;
POST /v1/videos·minimaxi-i2v-01:text,image→video- Ποια πεδία χρησιμοποιεί το αίτημα;
POST /v1/videos·minimaxi-i2v-01:model,prompt,end_image,image