Hailuo 2.3 Fast
Το MiniMax Hailuo 2.3 Fast κινεί μια εικόνα πρώτου καρέ από σύντομη προτροπή κίνησης. Επιλέξτε αυτό το προφίλ εικόνας σε βίντεο για πλάνο προϊόντος, στάση χαρακτήρα ή στατικό καρέ storyboard.
Σχετικά με το μοντέλο
Αυτή η περιγραφή καλύπτει τις δυνατότητες του μοντέλου. Οι είσοδοι, έξοδοι και επιλογές που διατίθενται στο Ailoot παρατίθενται παρακάτω για την επιλεγμένη μέθοδο.
Το MiniMax Hailuo 2.3 Fast είναι το ονομαστικά προσδιορισμένο προφίλ Fast για παραγωγή βίντεο από εικόνα. Ξεκινήστε με συντεθειμένη εικόνα πρώτου καρέ και περιγράψτε πώς πρέπει να κινηθεί το θέμα ή η κάμερα. Μια στατική εικόνα προϊόντος, στάση χαρακτήρα ή καρέ storyboard δίνει στο πλάνο συγκεκριμένο οπτικό σημείο εκκίνησης.
Προετοιμασία εικόνας και οδηγίας κίνησης
Δώστε τετράγωνη εικόνα PNG ή JPEG μέσω URL HTTPS, με κάθε πλευρά μεταξύ 300 και 4.096 pixel. Το αρχείο εικόνας που λαμβάνεται δεν πρέπει να υπερβαίνει τα 20.000.000 byte. Κρατήστε την προτροπή μεταξύ 1 και 199 χαρακτήρων, εστιάζοντας σε μία ορατή δράση και στην κίνηση που έχει σημασία για το πλάνο.
Παρακολούθηση του αποσπάσματος μέχρι την ολοκλήρωση
Αυτό το προφίλ έχει ρυθμιστεί για ένα απόσπασμα MP4 768 × 768 με ονομαστική διάρκεια έξι δευτερολέπτων. Υποβάλετε το αίτημα μία φορά, αποθηκεύστε το επιστρεφόμενο ID και παρακολουθήστε εκείνο το αρχικό αίτημα μέχρι να ολοκληρωθεί. Κατεβάστε το επιστρεφόμενο βίντεο και διατηρήστε τις αναφερόμενες διαστάσεις και τη μετρημένη διάρκειά του μαζί με το αποτέλεσμα. Αν η έκβαση δημιουργίας είναι αβέβαιη, συνεχίστε τον έλεγχο του αρχικού αιτήματος αντί να το δημιουργήσετε ξανά.
Ailoot Ultra · Βίντεο POST /v1/videos MiniMax-Hailuo-2.3-Fast
MiniMax-Hailuo-2.3-FastΕισαγωγή
Το MiniMax Hailuo 2.3 Fast κινεί μια εικόνα πρώτου καρέ από σύντομη προτροπή κίνησης. Επιλέξτε αυτό το προφίλ εικόνας σε βίντεο για πλάνο προϊόντος, στάση χαρακτήρα ή στατικό καρέ storyboard.
- Αποδεκτές είσοδοι
- Κείμενο · Εικόνες
- Αποτελέσματα
- Βίντεο
Διαθέσιμα στο Ailoot · είσοδοι και μέθοδοι
Ailoot Ultra · Βίντεο POST /v1/videos
- Είσοδος
text,image- Έξοδος
video- Μορφή εξόδου
- mp4
- Πλήθος εξόδων
- Έως 1 έξοδος
| Πεδίο | Τύπος | Απαίτηση | Τιμές και όρια | Προεπιλογή |
|---|---|---|---|---|
Πεδίοmodel | Τύποςstring | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια MiniMax-Hailuo-2.3-Fast | Προεπιλογή— |
Πεδίοprompt | Τύποςstring | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια Ελάχιστο μήκος: 1 Μέγιστο μήκος: 199 Μονάδα: χαρακτήρες Unicode | Προεπιλογή— |
Πεδίοduration | Τύποςinteger | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια 6 Μονάδα: δευτερόλεπτα | Προεπιλογή— |
Πεδίοresolution | Τύποςstring | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια 768P | Προεπιλογή— |
Πεδίοfirst_frame_image | Τύποςhttps_url | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια Μέγιστο μέγεθος αρχείου σε byte: 20.000.000 Τύποι MIME: image/png, image/jpeg Ελάχιστη διάσταση: 300 Μέγιστη διάσταση: 4.096 Μόνο τετράγωνο: Ναι | Προεπιλογή— |
Συνδυασμοί υλικών εισόδου
Εικόνα σε βίντεο · Υποχρεωτικό: prompt, first_frame_image
Παράμετροι και κύκλος ζωής μεθόδου
| Παράμετρος | Σύμβαση |
|---|---|
Παράμετροςcontent_type | Σύμβασηapplication/json |
Παράμετροςrequired | Σύμβασηmodel, prompt, duration, resolution, first_frame_image |
Παράμετροςother_options | Σύμβασηfalse |
Παράμετροςduration | Σύμβαση6 |
Παράμετροςresolution | Σύμβαση768P |
Παράμετροςprompt_max_characters | Σύμβαση199 |
Παράμετροςfirst_frame_image | Σύμβαση{"type":"https_url","format":["png","jpeg"],"dimensions":"τετράγωνη εικόνα 300..4096 pixel","full_image_validation_before_send":true,"maximum_file_bytes":20000000} |
Παράμετροςmaterial_types | Σύμβασηtext, image |
Παράμετροςadditional_properties | Σύμβασηfalse |
Εναλλακτικά ονόματα μεθόδου: /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 | Ανάλυση768P | Μονάδα τιμολόγησηςανά απόσπασμα εξόδου ονομαστικής διάρκειας 6s | Χρέωση Έξοδος · ονομαστικό κλιπ εξόδου 6s $0.4 ανά απόσπασμα εξόδου ονομαστικής διάρκειας 6s |
Το Ailoot δεσμεύει ένα εκτιμώμενο ποσό πριν από το αίτημα. Μετά το αποτέλεσμα, εκκαθαρίζει την τελική χρέωση βάσει της μετρημένης χρήσης. Η εκκαθάριση ροής χρησιμοποιεί την τελική καταγραφή χρήσης. Πώς λειτουργούν η δέσμευση και η εκκαθάριση →
Στοιχεία τιμοκαταλόγου αναφοράς
Οι πίνακες αναφοράς του μοντέλου δεν αλλάζουν την επιλογή μεθόδου, τις εκτιμήσεις τιμής ή τις χρεώσεις. Οι εφαρμοζόμενες χρεώσεις χρησιμοποιούν τις τιμές της επιλεγμένης μεθόδου Ailoot.
MiniMax-Hailuo-2.3-Fast
Τιμές ανά διαμόρφωση
| Διαμόρφωση | Συνθήκες χρέωσης | Χρέωση |
|---|---|---|
| ΔιαμόρφωσηMiniMax-Hailuo-2.3-Fast · Προεπιλεγμένη διαμόρφωση | Συνθήκες χρέωσηςΠροεπιλεγμένη διαμόρφωση | Χρέωση Είσοδος · Είσοδος 0,00 $ ανά κλήση Έξοδος · Έξοδος 0,40 $ ανά κλήση |
MiniMax-Hailuo-2.3-Fast
Τιμές ανά διαμόρφωση
| Διαμόρφωση | Συνθήκες χρέωσης | Χρέωση |
|---|---|---|
| ΔιαμόρφωσηMiniMax-Hailuo-2.3-Fast · Προεπιλεγμένη διαμόρφωση | Συνθήκες χρέωσηςΠροεπιλεγμένη διαμόρφωση | Χρέωση Είσοδος · Είσοδος 0,00 $ ανά κλήση Έξοδος · Έξοδος 0,80 $ ανά κλήση |
MiniMax-Hailuo-2.3-Fast
Τιμές ανά διαμόρφωση
| Διαμόρφωση | Συνθήκες χρέωσης | Χρέωση |
|---|---|---|
| ΔιαμόρφωσηMiniMax-Hailuo-2.3-Fast · Προεπιλεγμένη διαμόρφωση | Συνθήκες χρέωσηςΠροεπιλεγμένη διαμόρφωση | Χρέωση Είσοδος · Είσοδος 0,00 $ ανά κλήση Έξοδος · Έξοδος 0,80 $ ανά κλήση |
Παραδείγματα αιτημάτων
Ailoot Ultra · Βίντεο
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_IMAGE_URL:?Set the actual HTTPS first-frame image URL}"
export AILOOT_IMAGE_URL
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "MiniMax-Hailuo-2.3-Fast", "prompt": "A cat in a spacesuit walking on the Moon", "duration": 6, "resolution": "768P"}')
from urllib.parse import urlsplit
u=os.environ["AILOOT_IMAGE_URL"]
z=urlsplit(u)
if z.scheme!="https" or not z.netloc or z.username or z.password:raise SystemExit("Choose the actual HTTPS first-frame image URL")
p["first_frame_image"]=u
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}"
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 αρχείου που επιστρέφεται.
Το ολοκληρωμένο 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 | Σημασία— |
Πεδίοoperation_id | Τύποςstring | ΣημασίαΕπιστρέφεται όταν status=unknown· πραγματικό αρχικό δημόσιο ID λειτουργίας βίντεο |
Πεδίοrequest_id | Τύποςstring | ΣημασίαΠροαιρετικό όταν status=unknown· επιστρέφεται μόνο αν η αρχική εργασία έχει ID αιτήματος |
Σφάλματα και επόμενα βήματα
| Απάντηση | Συνθήκη | Επόμενο βήμα |
|---|---|---|
Απάντηση400 · invalid_request_error | ΣυνθήκηΗ ανάγνωση του ακατέργαστου σώματος αιτήματος αποτυγχάνει πριν από την ανάλυση του προφίλ βίντεο | Επόμενο βήμαΔιατηρήστε την απόκριση που επιστρέφεται και διορθώστε το μη αναγνώσιμο σώμα αιτήματος. |
Απάντηση422 · price_unavailable | ΣυνθήκηΑποτυγχάνει η ανάλυση του ακριβούς προφίλ βίντεο ή το πλήρες αναλυμένο προφίλ δεν διαθέτει έτοιμη κάρτα με την ακριβή τιμή | Επόμενο βήμαΔιατηρήστε την απόκριση· χρησιμοποιήστε το πλήρες, ακριβές προφίλ που έχει άδεια πρόσβασης και τη δημοσιευμένη κάρτα του. Αυτός ο κλάδος εκτελείται πριν από αποστολή στον πάροχο. |
Απάντηση409 · video_not_ready | ΣυνθήκηΤο περιεχόμενο του αρχικού αποτελέσματος δεν είναι ακόμη διαθέσιμο | Επόμενο βήμαΕλέγχετε περιοδικά το αρχικό ID που επιστρέφεται και τηρείτε το Retry-After. |
Απάντησηserver_error | ΣυνθήκηΗ απόκριση που επιστράφηκε αναφέρει ότι η λειτουργία ή το αποτέλεσμα χρειάζεται έλεγχο | Επόμενο βήμαΔιατηρήστε το αρχικό ID της λειτουργίας/εργασίας που επιστράφηκε, τις κεφαλίδες του αιτήματος και την απόκριση· συνεχίστε με τις υποστηριζόμενες αναγνώσεις αυτής της αρχικής λειτουργίας. Μην υποβάλετε ξανά το αίτημα δημιουργίας. |
Απάντηση200 · video_result_unverified | ΣυνθήκηΗ κατάσταση της αρχικής εργασίας Fast είναι άγνωστη· status=unknown και charge_pending_check=true | Επόμενο βήμαΔιατηρήστε τα πραγματικά id/operation_id και το προαιρετικό request_id που επιστρέφονται· διαβάστε μόνο την αρχική εργασία. Μην επανυποβάλετε ποτέ το αίτημα. |
Εναλλακτικά ονόματα
Εναλλακτικά ονόματα μοντέλου
Ailoot Ultra MiniMax-Hailuo-2.3-Fast
Εναλλακτικές διαδρομές μεθόδων
/v1/videos/generations, /videos, /videos/generations
Σχετικά ID μοντέλων
FAQ · Hailuo 2.3 Fast
- Ποιες είσοδοι και αποτελέσματα διατίθενται;
POST /v1/videos·MiniMax-Hailuo-2.3-Fast:text,image→video- Ποια πεδία χρησιμοποιεί το αίτημα;
POST /v1/videos·MiniMax-Hailuo-2.3-Fast:model,prompt,duration,resolution,first_frame_image- Ποια όρια ισχύουν;
POST /v1/videos·MiniMax-Hailuo-2.3-Fast:prompt.maximum_length:199