MiniMax: I2V 01 Director
Το I2V 01 Director δίνει κίνηση σε μια εικόνα πρώτου καρέ με ρητές εντολές κίνησης της κάμερας στην προτροπή. Συνδυάστε τη σύνθεση που παρέχεται με κατευθυνόμενες οδηγίες truck, pan, push, tilt, zoom, tracking ή στατικής κάμερας για να σχεδιάσετε ένα σύντομο πλάνο.
Σχετικά με το μοντέλο
Αυτή η περιγραφή καλύπτει τις δυνατότητες του μοντέλου. Οι είσοδοι, έξοδοι και επιλογές που διατίθενται στο Ailoot παρατίθενται παρακάτω για την επιλεγμένη μέθοδο.
Το I2V 01 Director είναι η έκδοση δημιουργίας βίντεο από εικόνα της MiniMax με τεκμηριωμένες εντολές κάμερας. Μια εικόνα που παρέχεται καθορίζει το πρώτο καρέ και η προτροπή κατευθύνει τόσο την ορατή δράση όσο και την κάμερα. Αυτό είναι χρήσιμο όταν μια υπάρχουσα σύνθεση χρειάζεται συγκεκριμένη προσέγγιση, αποκάλυψη, κίνηση παρακολούθησης ή ελεγχόμενη στατική όψη αντί για ακαθόριστη κίνηση.
Προετοιμάστε την εικόνα ως την αρχή του επιθυμητού πλάνου. Για μια αποκάλυψη, δείξτε το θέμα και το μέρος του περιβάλλοντος που πρέπει να αποκαλύψει η κάμερα. Για κοντινή προσέγγιση, ξεκινήστε με αρκετό περιβάλλοντα χώρο, ώστε η αλλαγή στο καδράρισμα να είναι ευδιάκριτη. Ελέγξτε ότι τα σημαντικά χαρακτηριστικά του θέματος είναι ορατά πριν αρχίσει η κίνηση, ιδίως όταν το σχήμα ενός προϊόντος ή η εμφάνιση ενός χαρακτήρα πρέπει να παραμένουν αναγνωρίσιμα.
Ο κατασκευαστής δέχεται αναφορές JPG, JPEG, PNG και WebP μικρότερες από 20 MB, με μικρή πλευρά μεγαλύτερη από 300 pixel και αναλογία πλευρών μεταξύ 2:5 και 5:2. Ένα προσβάσιμο URL εικόνας ή κωδικοποιημένα δεδομένα εικόνας μπορούν να προσδιορίσουν το πρώτο καρέ στη ροή εργασίας του κατασκευαστή. Διατηρήστε την αρχική αναφορά, ώστε μια μεταγενέστερη αναθεώρηση να χρησιμοποιεί την ίδια σύνθεση και όχι μια αναδημιουργημένη προσέγγισή της.
Η προτροπή υποστηρίζει έως 2.000 χαρακτήρες και περιλαμβάνει δεκαπέντε ονομασμένες εντολές κάμερας. Το truck μετακινεί την κάμερα οριζόντια, το pan αλλάζει την οριζόντια κατεύθυνσή της, το pedestal τη μετακινεί κατακόρυφα και το tilt αλλάζει την κατακόρυφη κατεύθυνσή της. Τα push, pull και zoom προσφέρουν διαφορετικά είδη προσέγγισης ή απομάκρυνσης· τα tracking, shake και το στατικό πλάνο καλύπτουν άλλες προθέσεις για την κάμερα. Χρησιμοποιήστε την τεκμηριωμένη γραφή της εντολής όταν προσδιορίζετε μια κίνηση.
Τοποθετήστε τις εντολές μέσα σε τετράγωνες αγκύλες στο σημείο της περιγραφής όπου πρέπει να γίνει η κίνηση. Πολλές εντολές μέσα στην ίδια αγκύλη ζητούν ταυτόχρονη κίνηση, ενώ εντολές σε διαδοχικά σημεία περιγράφουν μια ακολουθία. Ο κατασκευαστής συνιστά έως τρεις συνδυασμένες κινήσεις. Ένα απλό push προς ένα θέμα μπορεί να επικοινωνήσει μια λεπτομέρεια σαφέστερα από πολλές κινήσεις που ανταγωνίζονται μέσα στο ίδιο σύντομο πλάνο.
Περιγράψτε την κίνηση του θέματος χωριστά από την κίνηση της κάμερας. Ένα άτομο που περπατά προς μια πόρτα και μια κάμερα που το ακολουθεί είναι δύο οδηγίες με διαφορετικά οπτικά αποτελέσματα. Δηλώστε την επιθυμητή σχέση τους, όπως να παραμένει ορατό το πρόσωπο κατά την προσέγγιση ή να μένει ακίνητη η κάμερα ενώ το θέμα διασχίζει το κάδρο. Προσδιορίστε την τελική σύνθεση, ώστε η παραγόμενη δράση να έχει χρήσιμο προορισμό.
Ο παλαιότερος πίνακας δημιουργίας βίντεο από εικόνα του κατασκευαστή αναφέρει τα 720P ως προεπιλογή για αυτή την έκδοση και δεν αναφέρει επιλογή δέκα δευτερολέπτων. Η αυτόματη βελτιστοποίηση της προτροπής είναι ενεργοποιημένη από προεπιλογή και μπορεί να απενεργοποιηθεί για ακριβέστερο έλεγχο της γραπτής περιγραφής. Διατηρήστε τη ρύθμισή της μαζί με την εικόνα προέλευσης και τις οδηγίες κάμερας κατά τη σύγκριση πλάνων, ώστε μια αλλαγή στη διατύπωση ή την ερμηνεία να είναι ορατή στην καταγραφή της δημιουργίας.
Ελέγξτε ολόκληρο το απόσπασμα ως προς τη ζητούμενη διαδρομή της κάμερας, τη συνέχεια του θέματος και το καδράρισμα των σημαντικών λεπτομερειών. Εξετάστε αν ένα push ή pan αποκαλύπτει την επιθυμητή πληροφορία και αν η τελική όψη αφήνει αρκετό χώρο για το επόμενο βήμα επεξεργασίας. Αποθηκεύστε το ολοκληρωμένο βίντεο με την ακριβή προτροπή, την εικόνα προέλευσης και τις ρυθμίσεις. Για μια αναθεώρηση, αλλάξτε την κατεύθυνση της κάμερας, τον χρονισμό ή τη δράση του θέματος που προκάλεσε το παρατηρούμενο πρόβλημα και συγκρίνετε το αποτέλεσμα με το ίδιο σχέδιο πλάνου.
Ailoot Ultra · Βίντεο POST /v1/videos minimaxi-i2v-01-director
minimaxi-i2v-01-directorΕισαγωγή
Το I2V 01 Director δίνει κίνηση σε μια εικόνα πρώτου καρέ με ρητές εντολές κίνησης της κάμερας στην προτροπή. Συνδυάστε τη σύνθεση που παρέχεται με κατευθυνόμενες οδηγίες truck, pan, push, tilt, zoom, tracking ή στατικής κάμερας για να σχεδιάσετε ένα σύντομο πλάνο.
- Αποδεκτές είσοδοι
- Κείμενο · Εικόνες
- Αποτελέσματα
- Βίντεο
Διαθέσιμα στο Ailoot · είσοδοι και μέθοδοι
Ailoot Ultra · Βίντεο POST /v1/videos
- Είσοδος
text,image- Έξοδος
video
| Πεδίο | Τύπος | Απαίτηση | Τιμές και όρια | Προεπιλογή |
|---|---|---|---|---|
Πεδίοmodel | Τύποςstring | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια minimaxi-i2v-01-director Συνθήκες: Χρησιμοποιήστε τον ακριβή επιλογέα μοντέλου 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-director",
"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-director
Εναλλακτικές διαδρομές μεθόδων
/v1/videos/generations
Σχετικά ID μοντέλων
FAQ · MiniMax: I2V 01 Director
- Ποιες είσοδοι και αποτελέσματα διατίθενται;
POST /v1/videos·minimaxi-i2v-01-director:text,image→video- Ποια πεδία χρησιμοποιεί το αίτημα;
POST /v1/videos·minimaxi-i2v-01-director:model,prompt,end_image,image