grok-imagine-video

Grok Imagine Video membuat video pendek dari deskripsi teks dengan pilihan durasi dan format bingkai. Model xAI itu sendiri juga mendukung animasi gambar dan penyuntingan video terarah.

Ailoot · Pemrosesan video POST /v1/videos/generations grok-imagine-video

Tentang model

Deskripsi ini mencakup kemampuan model. Masukan, keluaran, dan opsi yang tersedia di Ailoot tercantum di bawah untuk metode yang dipilih.

Dari deskripsi menuju video

Grok Imagine Video membuat video dari teks. Model xAI itu sendiri juga memiliki mode dengan gambar dan video sumber. Dalam metode generasi Ailoot yang dipublikasikan, masukan berupa deskripsi teks, sedangkan hasil berupa video.

Generasi berjalan secara asinkron: tugas dibuat terlebih dahulu, lalu keadaan dan hasil jadi diperoleh melalui pengenalnya. Menurut xAI, pembuatan video dapat memerlukan beberapa menit; waktunya bergantung pada kerumitan adegan, durasi, resolusi, dan mode yang dipilih.

Durasi dan bingkai

Pembuatan video menyediakan durasi dari 1 hingga 15 detik. Format bingkai mencakup 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, dan 2:3; format standar adalah 16:9. Versi ini menyediakan 480p dan 720p, sedangkan 1080p berlaku bagi versi 1.5.

Animasi gambar sumber

Dalam mode xAI dengan gambar, gambar menjadi bingkai awal, sedangkan instruksi teks menentukan gerakan. Secara default, bentuk video mengikuti rasio gambar sumber. Rasio aspek yang ditentukan secara eksplisit mengubah bentuk tersebut dan dapat meregangkan gambar.

Penyuntingan terarah

Saat video jadi digunakan, model menerapkan perubahan yang dijelaskan sambil mempertahankan isi adegan lainnya. Mode ini membantu mengubah unsur yang diperlukan sambil mempertahankan penataan video sumber. Durasi dan rasio diwarisi dari sumber; durasi atau bentuk bingkai baru tidak ditentukan.

Video sumber untuk penyuntingan dibatasi hingga 8,7 detik, sedangkan hasilnya pada resolusi paling tinggi 720p. Materi 1080p diperkecil menjadi 720p. Pengaturan generasi teks tidak otomatis berlaku bagi penyuntingan.

Kelanjutan video jadi

Dalam mode xAI tersendiri, versi ini melanjutkan video sumber dari bingkai terakhirnya. MP4 sumber harus berdurasi 2 hingga 15 detik; bagian tambahan 2 hingga 10 detik, dengan default 6. Hasil menggabungkan video sumber dan kelanjutannya. Rasio serta resolusi diwarisi dari sumber, dengan batas 720p; keduanya tidak dapat diubah secara terpisah dalam mode ini. Kemampuan produsen tersebut berbeda dari generasi Ailoot dari teks yang dipublikasikan.

Referensi dan batasan versi

xAI menyediakan penggunaan referensi visual untuk mengarahkan penampilan orang, pakaian, dan objek dalam adegan. Referensi menentukan ciri visual, bukan gambar bingkai pertama yang tepat. Grok Imagine Video klasik tidak dapat menggabungkan bingkai awal dengan referensi.

Versi ini tidak menerima penetapan bingkai terakhir yang tepat dan bingkai kunci di antaranya. Kemampuan tersebut dimiliki Grok Imagine Video 1.5. Generasi, animasi gambar sumber, dan perubahan video jadi merupakan mode yang berbeda; metode Ailoot yang dipublikasikan di sini menjelaskan generasi dari teks.

Ailoot · Pemrosesan video POST /v1/videos/generations grok-imagine-video

grok-imagine-video

xAI /grok-imagine-video

Mulai

Grok Imagine Video membuat video pendek dari deskripsi teks dengan pilihan durasi dan format bingkai. Model xAI itu sendiri juga mendukung animasi gambar dan penyuntingan video terarah.

Masukan yang diterima: Teks
Hasil: Video

Tersedia di Ailoot · masukan & metode

Ailoot · Pemrosesan video POST /v1/videos/generations

Masukan: text
Keluaran: video
Format keluaran: mp4

Kolom	Jenis	Persyaratan	Nilai & batasan	Bawaan
Kolom`model`	Jenis`string`	PersyaratanWajib	Nilai & batasan grok-imagine-video	Bawaan—
Kolom`prompt`	Jenis`string`	PersyaratanOpsional	Nilai & batasan Panjang minimum: 1	Bawaan—
Kolom`duration`	Jenis`integer`	PersyaratanOpsional	Nilai & batasan Minimum: 1 Maksimum: 15 Kondisi: Jangan berikan duration dan seconds sekaligus Satuan: detik	Bawaan1
Kolom`seconds`	Jenis`integer\|integer_string`	PersyaratanOpsional	Nilai & batasan Minimum: 1 Maksimum: 15 Alternatif: duration	Bawaan—
Kolom`resolution`	Jenis`string`	PersyaratanOpsional	Nilai & batasan 480p, 720p	Bawaan480p
Kolom`aspect_ratio`	Jenis`string`	PersyaratanOpsional	Nilai & batasan 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3 Kondisi: Jika gambar masukan diberikan dan rasio dihilangkan, penyedia mewarisi rasio aspek gambar	Bawaan16:9
Kolom`size`	Jenis`string`	PersyaratanOpsional	Nilai & batasan 1280x720, 720x1280, 1920x1080, 1080x1920 Kondisi: Harus sesuai dengan resolution/aspect_ratio jika keduanya ditentukan	Bawaan—
Kolom`image`	Jenis`object`	PersyaratanOpsional	Nilai & batasan Kondisi: Gambar masukan aktual yang didukung; memungkinkan prompt dihilangkan	Bawaan—

Kombinasi bahan masukan

Teks ke video · Wajib: prompt

Gambar ke video · Wajib: image

Parameter metode dan siklus hidup

Parameter	Kontrak
Parameter`material_types`	Kontraktext
Parameter`required`	Kontraknull
Parameter`optional_controls`	Kontraknull

Siklus hidup: 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

Struktur metode dan ID bersifat eksak; kemampuan pemasok terpisah dari penerimaan permintaan.

Paket

Tarif metode Ailoot

Ailoot Pemrosesan videoPOST /v1/videos/generations

Masukan: US$0,002 per gambar masukan
Masukan: US$0,01 per detik video masukan
Keluaran: US$0,05 per detik pada 480p
Keluaran: US$0,07 per detik pada 720p

Ailoot mencadangkan perkiraan dana sebelum permintaan. Setelah hasil diterima, tagihan akhir diselesaikan berdasarkan penggunaan yang terukur. Penyelesaian tagihan streaming menggunakan catatan penggunaan akhir. Cara kerja cadangan dan penyelesaian tagihan →

Contoh permintaan

Ailoot · Pemrosesan video

Contoh video

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."}'

Terima dan simpan hasil

Ailoot · Pemrosesan video

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

Periksa status tugas

GET status

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"

Pembacaan konten lain

GET konten

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

Simpan semua hasil yang selesai

Simpan setiap video yang selesai atau berkas yang dikembalikan; ambil setiap URL aset yang benar-benar dikembalikan.

Simpan JSON status secara utuh dan request_id aktual. Respons yang selesai dengan status=done memuat video.url dengan URL konten milik Ailoot. Pertahankan durasi yang dilaporkan dan setiap bidang hasil yang dikembalikan.

Jika respons asli perlu diperiksa

Baca tugas awal yang sudah ada; jangan pernah kirim ulang pengiriman yang statusnya tidak diketahui.

Kolom respons

Kolom	Jenis
Kolom`request_id`	Jenisstring
Kolom`id`	Jenisstring
Kolom`status`	Jenisstring
Kolom`video.url`	Jenisowned signed content URL
Kolom`video.duration`	Jenisnumber
Kolom`video.respect_moderation`	Jenisboolean

Kesalahan dan langkah berikutnya

Respons	Kondisi	Langkah berikutnya
Respons400 · `invalid_request_error`	KondisiBidang wajib, representasi materi, atau nilai parameter tidak valid	Langkah berikutnyaPerbaiki bidang yang ditunjukkan sebelum permintaan pembuatan baru.
Respons409 · `video_not_ready`	KondisiKonten hasil awal belum tersedia	Langkah berikutnyaPeriksa ID awal yang dikembalikan secara berkala dan patuhi Retry-After.
Respons`server_error`	KondisiRespons yang dikembalikan menyatakan bahwa operasi atau hasil perlu diperiksa	Langkah berikutnyaSimpan ID operasi/tugas asli yang dikembalikan, header permintaan, dan respons; lanjutkan pembacaan yang didukung untuk operasi asli tersebut. Jangan kirim ulang permintaan pembuatan.

Alias

Alias model

Ailoot grok-imagine-video

Alias jalur metode

Gunakan jalur metode yang ditampilkan di atas.

ID pemanggil terkait

grok-imagine-video

FAQ · grok-imagine-video

Input dan hasil apa yang tersedia?: POST /v1/videos/generations · grok-imagine-video: text → video
Kolom apa yang digunakan permintaan?: POST /v1/videos/generations · grok-imagine-video: model, prompt, duration, seconds, resolution, aspect_ratio, size, image
Batasan apa yang berlaku?: POST /v1/videos/generations · grok-imagine-video: duration.minimum: 1; duration.maximum: 15; seconds.minimum: 1; seconds.maximum: 15

grok-imagine-video