grok-imagine-video

Το Grok Imagine Video δημιουργεί σύντομα βίντεο βάσει περιγραφής κειμένου με επιλογή διάρκειας και σχήματος κάδρου. Το ίδιο το μοντέλο της xAI υποστηρίζει επίσης κίνηση από εικόνα και στοχευμένη επεξεργασία βίντεο.

Ailoot · Βίντεο POST /v1/videos/generations grok-imagine-video

Σχετικά με το μοντέλο

Αυτή η περιγραφή καλύπτει τις δυνατότητες του μοντέλου. Οι είσοδοι, έξοδοι και επιλογές που διατίθενται στο Ailoot παρατίθενται παρακάτω για την επιλεγμένη μέθοδο.

Από την περιγραφή στο βίντεο

Το Grok Imagine Video δημιουργεί βίντεο από κείμενο. Το ίδιο το μοντέλο της xAI διαθέτει επίσης λειτουργίες με αρχική εικόνα και βίντεο. Στη δημοσιευμένη μέθοδο δημιουργίας του Ailoot, η είσοδος είναι περιγραφή κειμένου και το αποτέλεσμα βίντεο.

Η δημιουργία εκτελείται ασύγχρονα: πρώτα δημιουργείται εργασία και κατόπιν λαμβάνονται η κατάστασή της και το ολοκληρωμένο αποτέλεσμα μέσω του αναγνωριστικού της. Σύμφωνα με την xAI, η δημιουργία βίντεο μπορεί να διαρκεί αρκετά λεπτά· ο χρόνος εξαρτάται από τη δυσκολία σκηνής, τη διάρκεια, την ανάλυση και την επιλεγμένη λειτουργία.

Διάρκεια και κάδρο

Για δημιουργία βίντεο διατίθεται διάρκεια από 1 έως 15 δευτερόλεπτα. Τα σχήματα κάδρου περιλαμβάνουν 1:1, 16:9, 9:16, 4:3, 3:4, 3:2 και 2:3· το προεπιλεγμένο σχήμα είναι 16:9. Για αυτή την έκδοση προβλέπονται 480p και 720p, ενώ το 1080p αφορά την έκδοση 1.5.

Κίνηση από αρχική εικόνα

Στη λειτουργία της xAI με εικόνα, αυτή γίνεται το αρχικό καρέ και η οδηγία κειμένου καθορίζει την κίνηση. Από προεπιλογή, το σχήμα βίντεο ακολουθεί τις αναλογίες της αρχικής εικόνας. Μια ρητά καθορισμένη αναλογία πλευρών αλλάζει αυτό το σχήμα και μπορεί να τεντώσει την εικόνα.

Στοχευμένη επεξεργασία

Κατά την εργασία με έτοιμο βίντεο, το μοντέλο εφαρμόζει τις περιγραφόμενες αλλαγές διατηρώντας το υπόλοιπο περιεχόμενο της σκηνής. Αυτή η λειτουργία βοηθά στην αλλαγή του επιθυμητού στοιχείου με διατήρηση της σκηνοθεσίας του αρχικού βίντεο. Η διάρκεια και οι αναλογίες κληρονομούνται από το αρχικό· δεν καθορίζονται νέα διάρκεια ή σχήμα κάδρου.

Το αρχικό βίντεο για επεξεργασία περιορίζεται σε 8,7 δευτερόλεπτα και το αποτέλεσμα σε ανάλυση το πολύ 720p. Το υλικό 1080p μειώνεται σε 720p. Οι ρυθμίσεις δημιουργίας από κείμενο δεν μεταφέρονται αυτόματα στην επεξεργασία.

Συνέχιση έτοιμου βίντεο

Σε ξεχωριστή λειτουργία της xAI, αυτή η έκδοση συνεχίζει το αρχικό βίντεο από το τελευταίο καρέ του. Το αρχικό MP4 πρέπει να διαρκεί από 2 έως 15 δευτερόλεπτα· το πρόσθετο μέρος από 2 έως 10 δευτερόλεπτα, με προεπιλογή 6. Το αποτέλεσμα συνδυάζει το αρχικό βίντεο και τη συνέχειά του. Οι αναλογίες και η ανάλυση κληρονομούνται από το αρχικό, με όριο 720p· δεν μπορούν να αλλάζουν χωριστά σε αυτή τη λειτουργία. Αυτή η δυνατότητα του κατασκευαστή διαφέρει από τη δημοσιευμένη δημιουργία του Ailoot από κείμενο.

Αναφορές και όρια της έκδοσης

Η xAI προβλέπει χρήση οπτικών αναφορών για καθοδήγηση της εμφάνισης ανθρώπων, ρούχων και αντικειμένων στη σκηνή. Η αναφορά ορίζει οπτικά χαρακτηριστικά, όχι την ακριβή εικόνα του πρώτου καρέ. Στο κλασικό Grok Imagine Video δεν μπορεί να συνδυαστεί αρχικό καρέ με αναφορές.

Αυτή η έκδοση δεν δέχεται ακριβή καθορισμό τελευταίου καρέ και ενδιάμεσα βασικά καρέ. Αυτές οι δυνατότητες ανήκουν στο Grok Imagine Video 1.5. Η δημιουργία, η κίνηση από αρχική εικόνα και η αλλαγή έτοιμου βίντεο είναι διαφορετικές λειτουργίες· η δημοσιευμένη μέθοδος του Ailoot εδώ περιγράφει δημιουργία από κείμενο.

Ailoot · Βίντεο POST /v1/videos/generations grok-imagine-video

grok-imagine-video

xAI /grok-imagine-video

Εισαγωγή

Αποδεκτές είσοδοι: Κείμενο
Αποτελέσματα: Βίντεο

Διαθέσιμα στο Ailoot · είσοδοι και μέθοδοι

Ailoot · Βίντεο POST /v1/videos/generations

Είσοδος: text
Έξοδος: video
Μορφή εξόδου: mp4

Πεδίο	Τύπος	Απαίτηση	Τιμές και όρια	Προεπιλογή
Πεδίο`model`	Τύπος`string`	ΑπαίτησηΥποχρεωτικό	Τιμές και όρια grok-imagine-video	Προεπιλογή—
Πεδίο`prompt`	Τύπος`string`	ΑπαίτησηΠροαιρετικό	Τιμές και όρια Ελάχιστο μήκος: 1	Προεπιλογή—
Πεδίο`duration`	Τύπος`integer`	ΑπαίτησηΠροαιρετικό	Τιμές και όρια Ελάχιστο: 1 Μέγιστο: 15 Συνθήκες: Μην δίνετε ταυτόχρονα duration και seconds Μονάδα: δευτερόλεπτα	Προεπιλογή1
Πεδίο`seconds`	Τύπος`integer\|integer_string`	ΑπαίτησηΠροαιρετικό	Τιμές και όρια Ελάχιστο: 1 Μέγιστο: 15 Εναλλακτική: duration	Προεπιλογή—
Πεδίο`resolution`	Τύπος`string`	ΑπαίτησηΠροαιρετικό	Τιμές και όρια 480p, 720p	Προεπιλογή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

Ailoot ΒίντεοPOST /v1/videos/generations

Είσοδος: 0,002 $ ανά εικόνα εισόδου
Είσοδος: 0,01 $ ανά δευτερόλεπτο βίντεο εισόδου
Έξοδος: 0,05 $ ανά δευτερόλεπτο στα 480p
Έξοδος: 0,07 $ ανά δευτερόλεπτο στα 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", "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}/content
GET /v1/videos/generations/{request_id}/content

Έλεγχος κατάστασης εργασίας

Λήψη κατάστασης με GET

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"

Άλλες ανακτήσεις περιεχομένου

Λήψη περιεχομένου με GET

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

Εναλλακτικές διαδρομές μεθόδων

Χρησιμοποιήστε τις διαδρομές μεθόδων που εμφανίζονται παραπάνω.

Σχετικά ID μοντέλων

grok-imagine-video

FAQ · grok-imagine-video

Ποιες είσοδοι και αποτελέσματα διατίθενται;: POST /v1/videos/generations · grok-imagine-video: text → video
Ποια πεδία χρησιμοποιεί το αίτημα;: POST /v1/videos/generations · grok-imagine-video: model, prompt, duration, seconds, resolution, aspect_ratio, size, image
Ποια όρια ισχύουν;: POST /v1/videos/generations · grok-imagine-video: duration.minimum: 1; duration.maximum: 15; seconds.minimum: 1; seconds.maximum: 15

grok-imagine-video