grok-imagine-video-1.5-preview
Το Grok Imagine Video 1.5 δημιουργεί βίντεο από κείμενο διάρκειας 1–15 δευτερολέπτων, συμπεριλαμβανομένου του 1080p. Το ίδιο το μοντέλο υποστηρίζει κίνηση από εικόνες, οπτικές αναφορές, καθορισμό βασικών καρέ και ηχητικό μέρος.
Σχετικά με το μοντέλο
Αυτή η περιγραφή καλύπτει τις δυνατότητες του μοντέλου. Οι είσοδοι, έξοδοι και επιλογές που διατίθενται στο Ailoot παρατίθενται παρακάτω για την επιλεγμένη μέθοδο.
Δημιουργία σκηνής βίντεο
Το Grok Imagine Video 1.5 είναι μοντέλο της xAI για δημιουργία βίντεο βάσει περιγραφής κειμένου και οπτικού υλικού. Στην τρέχουσα μέθοδο του Ailoot έχει δημοσιευτεί δημιουργία από κείμενο· οι πρόσθετες λειτουργίες του ίδιου του μοντέλου επιτρέπουν κίνηση από εικόνα, χρήση αναφορών και καθορισμό καρέ αναφοράς της σκηνής.
Το αποτέλεσμα δημιουργείται ασύγχρονα: μετά την υποβολή εργασίας, η ολοκλήρωση ελέγχεται μέσω του αναγνωριστικού της. Σύμφωνα με την xAI, η διαδικασία μπορεί να διαρκεί αρκετά λεπτά, ανάλογα με τη δυσκολία σκηνής, τη διάρκεια και την ανάλυση. Η λήψη αναγνωριστικού εργασίας δεν σημαίνει ακόμη ότι το βίντεο είναι έτοιμο.
Διάρκεια, αναλογίες και ανάλυση
Το δημιουργημένο βίντεο διαρκεί από 1 έως 15 δευτερόλεπτα. Μπορεί να επιλεγεί 1:1, 16:9, 9:16, 4:3, 3:4, 3:2 ή 2:3· για κείμενο, το προεπιλεγμένο σχήμα είναι 16:9. Κατά τη δημιουργία κίνησης από εικόνα, οι αναλογίες της διατηρούνται από προεπιλογή.
Για δημιουργία από κείμενο και αρχική εικόνα διατίθενται 480p, 720p και 1080p. Το 480p χρησιμοποιείται από προεπιλογή· η λειτουργία με αναφορές περιορίζεται στο 720p. Η ανάλυση 1080p δεν μπορεί να εφαρμόζεται σε όλες τις λειτουργίες μόνο επειδή υπάρχει στο μοντέλο.
Έλεγχος εμφάνισης
Στη λειτουργία αναφορών, η xAI δέχεται έως 7 εικόνες. Καθορίζουν ανθρώπους, αντικείμενα, ρούχα και άλλα οπτικά χαρακτηριστικά χωρίς να ορίζουν σταθερά το αρχικό καρέ. Αυτός ο τρόπος προορίζεται για σκηνές με επαναλαμβανόμενο χαρακτήρα, παρουσίαση προϊόντος και διατήρηση επιθυμητής εμφάνισης μεταξύ διαφορετικών σκηνοθεσιών.
Πρώτο, τελευταίο και ενδιάμεσα καρέ
Η έκδοση 1.5 επιτρέπει να καθοριστεί ακριβές πρώτο καρέ, ακριβές τελευταίο καρέ ή και τα δύο. Αν οριστεί μόνο το τελευταίο, το μοντέλο δημιουργεί μόνο του την αρχή και καταλήγει στη συγκεκριμένη εικόνα. Με καθορισμένα και τα δύο όρια, δημιουργεί κίνηση ανάμεσά τους· η οδηγία κειμένου μπορεί να διευκρινίζει την κίνηση και τη λειτουργία κάμερας.
Για εικονογραφημένο σχεδιασμό μέσα στο βίντεο μπορούν να καθοριστούν έως 4 βασικά καρέ. Ο χρόνος καθενός πρέπει να βρίσκεται αυστηρά μετά την αρχή και πριν από το τέλος· η αντιστοίχιση γίνεται σε πλέγμα 1/3 δευτερολέπτου. Δύο καρέ που στρογγυλοποιούνται στην ίδια θέση του πλέγματος απορρίπτονται. Για να το αποφύγετε, αφήστε μεταξύ τους τουλάχιστον 1/3 δευτερολέπτου. Το πρώτο και το τελευταίο καρέ ορίζονται χωριστά από αυτά τα τέσσερα ενδιάμεσα.
Τα καρέ αναφοράς μπορούν να συνδυάζονται με οπτικές αναφορές και προκαθορισμένες φωνές. Αν έχει καθοριστεί σταθερά έστω ένα καρέ, η περιγραφή κειμένου είναι προαιρετική: η ίδια η ακολουθία εικόνων ορίζει τη σκηνή. Τα βασικά καρέ δεν μπορούν να χρησιμοποιηθούν μαζί με τη λειτουργία επεξεργασίας βίντεο. Αυτές οι δυνατότητες της xAI δεν σημαίνουν διαθεσιμότητά τους στη δημοσιευμένη δημιουργία του Ailoot από κείμενο.
Ήχος και φωνές
Το δημιουργημένο βίντεο περιέχει ηχητικό μέρος από προεπιλογή· προβλέπεται επίσης αποτέλεσμα χωρίς ήχο. Στη λειτουργία της xAI με φωνητικές αναφορές μπορούν να επιλεγούν έως 3 προκαθορισμένες φωνές και να συνδεθούν με τους ομιλούντες συμμετέχοντες της σκηνής.
Η παροχή δικού σας αρχείου ήχου ως δείγμα φωνής δεν αποτελεί γενική δυνατότητα αυτού του μοντέλου: η xAI την παρέχει χωριστά κατόπιν αιτήματος. Η προκαθορισμένη φωνή και ο μεταφορτωμένος ήχος είναι διαφορετικοί τύποι εισόδου.
Λειτουργίες εργασίας
Η δημιουργία από κείμενο παράγει νέα σκηνή· η αρχική εικόνα ορίζει την αρχή της· οι αναφορές καθοδηγούν την εμφάνιση· τα σταθερά καθορισμένα καρέ ορίζουν οπτικά σημεία στον χρόνο. Κάθε λειτουργία έχει δικούς της περιορισμούς, επομένως οι ρυθμίσεις ενός τρόπου δεν μπορούν να μεταφέρονται ανεπιφύλακτα σε άλλον.
Ailoot · Βίντεο POST /v1/videos/generations grok-imagine-video-1.5-preview
grok-imagine-video-1.5-preview
grok-imagine-video-1.5-previewΕισαγωγή
Το Grok Imagine Video 1.5 δημιουργεί βίντεο από κείμενο διάρκειας 1–15 δευτερολέπτων, συμπεριλαμβανομένου του 1080p. Το ίδιο το μοντέλο υποστηρίζει κίνηση από εικόνες, οπτικές αναφορές, καθορισμό βασικών καρέ και ηχητικό μέρος.
- Αποδεκτές είσοδοι
- Κείμενο
- Αποτελέσματα
- Βίντεο
Διαθέσιμα στο Ailoot · είσοδοι και μέθοδοι
Ailoot · Βίντεο POST /v1/videos/generations
- Είσοδος
text- Έξοδος
video- Μορφή εξόδου
- mp4
| Πεδίο | Τύπος | Απαίτηση | Τιμές και όρια | Προεπιλογή |
|---|---|---|---|---|
Πεδίοmodel | Τύποςstring | ΑπαίτησηΥποχρεωτικό | Τιμές και όρια grok-imagine-video-1.5-preview | Προεπιλογή— |
Πεδίοprompt | Τύποςstring | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Ελάχιστο μήκος: 1 | Προεπιλογή— |
Πεδίοduration | Τύποςinteger | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Ελάχιστο: 1 Μέγιστο: 15 Συνθήκες: Μην δίνετε ταυτόχρονα duration και seconds Μονάδα: δευτερόλεπτα | Προεπιλογή1 |
Πεδίοseconds | Τύποςinteger|integer_string | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Ελάχιστο: 1 Μέγιστο: 15 Εναλλακτική: duration | Προεπιλογή— |
Πεδίοresolution | Τύποςstring | ΑπαίτησηΠροαιρετικό | Τιμές και όρια 480p, 720p, 1080p | Προεπιλογή480p |
Πεδίοaspect_ratio | Τύποςstring | ΑπαίτησηΠροαιρετικό | Τιμές και όρια 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3 Συνθήκες: Αν δοθεί εικόνα εισόδου και παραλειφθεί η αναλογία, ο πάροχος κληρονομεί την αναλογία διαστάσεων της εικόνας | Προεπιλογή16:9 |
Πεδίοsize | Τύποςstring | ΑπαίτησηΠροαιρετικό | Τιμές και όρια 1280x720, 720x1280, 1920x1080, 1080x1920 Συνθήκες: Πρέπει να συμφωνεί με τα resolution/aspect_ratio, αν οριστούν και τα δύο | Προεπιλογή— |
Πεδίοimage | Τύποςobject | ΑπαίτησηΠροαιρετικό | Τιμές και όρια Συνθήκες: Πραγματική υποστηριζόμενη εικόνα εισόδου· επιτρέπει την παράλειψη της προτροπής | Προεπιλογή— |
Συνδυασμοί υλικών εισόδου
Κείμενο σε βίντεο · Υποχρεωτικό: prompt
Εικόνα σε βίντεο · Υποχρεωτικό: image
Παράμετροι και κύκλος ζωής μεθόδου
| Παράμετρος | Σύμβαση |
|---|---|
Παράμετροςmaterial_types | Σύμβασηtext |
Παράμετρος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,01 $ ανά εικόνα εισόδου
- Έξοδος
- 0,25 $ ανά δευτερόλεπτο στα 1080p
- Έξοδος
- 0,08 $ ανά δευτερόλεπτο στα 480p
- Έξοδος
- 0,14 $ ανά δευτερόλεπτο στα 720p
Το Ailoot δεσμεύει ένα εκτιμώμενο ποσό πριν από το αίτημα. Μετά το αποτέλεσμα, εκκαθαρίζει την τελική χρέωση βάσει της μετρημένης χρήσης. Η εκκαθάριση ροής χρησιμοποιεί την τελική καταγραφή χρήσης. Πώς λειτουργούν η δέσμευση και η εκκαθάριση →
Παραδείγματα αιτημάτων
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": "grok-imagine-video-1.5-preview", "prompt": "A person walks slowly through a quiet garden as the camera tracks from the side."}'Λήψη και αποθήκευση αποτελεσμάτων
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 αρχείου που επιστρέφεται.
Διατηρήστε ολόκληρο το JSON κατάστασης και το πραγματικό request_id. Μια ολοκληρωμένη απόκριση με status=done περιέχει video.url με URL περιεχομένου που σας ανήκει. Διατηρήστε την αναφερόμενη διάρκεια και κάθε πεδίο αποτελέσματος που επιστρέφεται.
Αν χρειάζεται έλεγχος της αρχικής απάντησης
Διαβάστε την υπάρχουσα αρχική εργασία· μην επανυποβάλετε ποτέ αποστολή με άγνωστο αποτέλεσμα.
Πεδία απάντησης
| Πεδίο | Τύπος |
|---|---|
Πεδίοrequest_id | Τύποςstring |
Πεδίοid | Τύποςstring |
Πεδίοstatus | Τύποςstring |
Πεδίοvideo.url | Τύποςowned signed content URL |
Πεδίοvideo.duration | Τύποςnumber |
Πεδίοvideo.respect_moderation | Τύποςboolean |
Σφάλματα και επόμενα βήματα
| Απάντηση | Συνθήκη | Επόμενο βήμα |
|---|---|---|
Απάντηση400 · invalid_request_error | ΣυνθήκηΜη έγκυρα υποχρεωτικά πεδία, μη έγκυρη αναπαράσταση υλικού ή μη έγκυρη τιμή παραμέτρου | Επόμενο βήμαΔιορθώστε τα υποδεικνυόμενα πεδία πριν από νέο αίτημα δημιουργίας. |
Απάντηση409 · video_not_ready | ΣυνθήκηΤο περιεχόμενο του αρχικού αποτελέσματος δεν είναι ακόμη διαθέσιμο | Επόμενο βήμαΕλέγχετε περιοδικά το αρχικό ID που επιστρέφεται και τηρείτε το Retry-After. |
Απάντησηserver_error | ΣυνθήκηΗ απόκριση που επιστράφηκε αναφέρει ότι η λειτουργία ή το αποτέλεσμα χρειάζεται έλεγχο | Επόμενο βήμαΔιατηρήστε το αρχικό ID της λειτουργίας/εργασίας που επιστράφηκε, τις κεφαλίδες του αιτήματος και την απόκριση· συνεχίστε με τις υποστηριζόμενες αναγνώσεις αυτής της αρχικής λειτουργίας. Μην υποβάλετε ξανά το αίτημα δημιουργίας. |
Εναλλακτικά ονόματα
Εναλλακτικά ονόματα μοντέλου
Ailoot grok-imagine-video-1.5-preview
Εναλλακτικές διαδρομές μεθόδων
Χρησιμοποιήστε τις διαδρομές μεθόδων που εμφανίζονται παραπάνω.
Σχετικά ID μοντέλων
FAQ · grok-imagine-video-1.5-preview
- Ποιες είσοδοι και αποτελέσματα διατίθενται;
POST /v1/videos/generations·grok-imagine-video-1.5-preview:text→video- Ποια πεδία χρησιμοποιεί το αίτημα;
POST /v1/videos/generations·grok-imagine-video-1.5-preview:model,prompt,duration,seconds,resolution,aspect_ratio,size,image- Ποια όρια ισχύουν;
POST /v1/videos/generations·grok-imagine-video-1.5-preview:duration.minimum:1;duration.maximum:15;seconds.minimum:1;seconds.maximum:15