grok-imagine-video

Grok Imagine Video menghasilkan video pendek berdasarkan penerangan teks dengan pilihan tempoh dan bentuk bingkai. Model xAI itu sendiri turut menyokong animasi imej dan penyuntingan video terarah.

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

Tentang model

Huraian ini merangkumi keupayaan model. Input, output dan pilihan yang tersedia di Ailoot disenaraikan di bawah untuk kaedah yang dipilih.

Daripada penerangan kepada video

Grok Imagine Video menghasilkan video daripada teks. Model xAI itu sendiri turut mempunyai mod dengan imej dan video asal. Dalam kaedah penjanaan Ailoot yang diterbitkan, input berupa penerangan teks dan hasilnya ialah video.

Penjanaan dilakukan secara tak segerak: tugasan dicipta dahulu, kemudian status dan hasil siap diperoleh melalui pengecamnya. Menurut xAI, penciptaan video boleh mengambil masa beberapa minit; masa bergantung pada kerumitan adegan, tempoh, resolusi dan mod yang dipilih.

Tempoh dan bingkai

Tempoh antara 1 hingga 15 saat tersedia untuk penciptaan video. Bentuk bingkai merangkumi 1:1, 16:9, 9:16, 4:3, 3:4, 3:2 dan 2:3; format lalai ialah 16:9. Versi ini menyediakan 480p dan 720p, manakala 1080p merujuk kepada versi 1.5.

Animasi imej asal

Dalam mod xAI dengan imej, imej itu menjadi bingkai awal dan arahan teks menentukan pergerakan. Secara lalai, bentuk video mengikut nisbah imej asal. Nisbah bidang yang ditetapkan secara jelas mengubah bentuk ini dan boleh meregangkan imej.

Penyuntingan terarah

Apabila mengendalikan video sedia ada, model melaksanakan perubahan yang diterangkan sambil mengekalkan kandungan adegan yang lain. Mod ini membantu mengubah unsur yang dikehendaki sambil mengekalkan penataan video asal. Tempoh dan nisbah diwarisi daripada video asal; tempoh atau bentuk bingkai baharu tidak ditetapkan.

Video asal untuk penyuntingan dihadkan kepada 8,7 saat, manakala hasilnya dihadkan kepada resolusi tidak melebihi 720p. Bahan 1080p diturunkan kepada 720p. Tetapan penjanaan teks tidak terpakai secara automatik pada penyuntingan.

Menyambung video sedia ada

Dalam mod xAI yang berasingan, versi ini menyambung video asal daripada bingkai terakhirnya. MP4 asal mestilah sepanjang 2 hingga 15 saat; bahagian tambahan antara 2 hingga 10 saat, secara lalai 6. Hasil menggabungkan video asal dengan sambungannya. Nisbah dan resolusi diwarisi daripada bahan asal, dengan had 720p; kedua-duanya tidak boleh diubah secara berasingan dalam mod ini. Keupayaan pengeluar ini berbeza daripada penjanaan Ailoot berdasarkan teks yang diterbitkan.

Rujukan dan batas versi

xAI menyediakan penggunaan rujukan visual untuk memandu rupa orang, pakaian dan objek dalam adegan. Rujukan menentukan ciri visual, bukan imej tepat bingkai pertama. Grok Imagine Video klasik tidak membenarkan penggabungan bingkai awal dengan rujukan.

Versi ini tidak menerima penetapan tepat bingkai terakhir atau bingkai utama perantaraan. Keupayaan tersebut dimiliki oleh Grok Imagine Video 1.5. Penjanaan, animasi imej asal dan perubahan video sedia ada ialah mod berbeza; kaedah Ailoot yang diterbitkan di sini menerangkan penjanaan berdasarkan teks.

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

grok-imagine-video

xAI /grok-imagine-video

Pengenalan

Grok Imagine Video menghasilkan video pendek berdasarkan penerangan teks dengan pilihan tempoh dan bentuk bingkai. Model xAI itu sendiri turut menyokong animasi imej dan penyuntingan video terarah.

Input yang diterima: Teks
Hasil: Video

Tersedia di Ailoot · input & kaedah

Ailoot · Penjanaan video POST /v1/videos/generations

Input: text
Output: video
Format output: mp4

Medan	Jenis	Keperluan	Nilai & had	Lalai
Medan`model`	Jenis`string`	KeperluanDiperlukan	Nilai & had grok-imagine-video	Lalai—
Medan`prompt`	Jenis`string`	KeperluanPilihan	Nilai & had Panjang minimum: 1	Lalai—
Medan`duration`	Jenis`integer`	KeperluanPilihan	Nilai & had Minimum: 1 Maksimum: 15 Syarat: Jangan berikan kedua-dua duration dan seconds Unit: saat	Lalai1
Medan`seconds`	Jenis`integer\|integer_string`	KeperluanPilihan	Nilai & had Minimum: 1 Maksimum: 15 Alternatif: duration	Lalai—
Medan`resolution`	Jenis`string`	KeperluanPilihan	Nilai & had 480p, 720p	Lalai480p
Medan`aspect_ratio`	Jenis`string`	KeperluanPilihan	Nilai & had 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3 Syarat: Jika input imej diberikan dan nisbah digugurkan, pembekal mewarisi nisbah bidang imej	Lalai16:9
Medan`size`	Jenis`string`	KeperluanPilihan	Nilai & had 1280x720, 720x1280, 1920x1080, 1080x1920 Syarat: Mesti sepadan dengan resolution/aspect_ratio jika kedua-duanya ditetapkan	Lalai—
Medan`image`	Jenis`object`	KeperluanPilihan	Nilai & had Syarat: Imej input sebenar yang disokong; membenarkan prompt digugurkan	Lalai—

Gabungan bahan input

Teks kepada video · Diperlukan: prompt

Imej kepada video · Diperlukan: image

Parameter kaedah dan kitar hayat

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

Kitar hayat: 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 kaedah dan ID adalah tepat; keupayaan pembekal berasingan daripada penerimaan permintaan.

Pelan harga

Kadar kaedah Ailoot

Ailoot Penjanaan videoPOST /v1/videos/generations

Input: USD 0.002 bagi setiap imej masukan
Input: USD 0.01 bagi setiap saat video masukan
Output: USD 0.05 bagi setiap saat pada 480p
Output: USD 0.07 bagi setiap saat pada 720p

Ailoot merizabkan anggaran amaun sebelum permintaan. Selepas hasil diterima, caj akhir diselesaikan berdasarkan penggunaan terukur. Penyelesaian caj penstriman menggunakan rekod penggunaan akhir. Cara rizab dan penyelesaian caj berfungsi →

Contoh permintaan

Ailoot · Penjanaan 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 · Penjanaan 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

Semak 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 kandungan lain

GET kandungan

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 fail yang dikembalikan; dapatkan setiap URL aset yang benar-benar dikembalikan.

Simpan JSON status lengkap dan request_id sebenar. Respons lengkap dengan status=done mengandungi video.url dengan URL kandungan milik anda. Kekalkan tempoh yang dilaporkan dan setiap medan hasil yang dikembalikan.

Jika respons asal perlu disemak

Baca tugas asal yang sedia ada; jangan sekali-kali hantar semula penghantaran yang tidak diketahui hasilnya.

Medan respons

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

Ralat dan langkah seterusnya

Respons	Syarat	Langkah seterusnya
Respons400 · `invalid_request_error`	SyaratMedan wajib, perwakilan bahan atau nilai parameter tidak sah	Langkah seterusnyaBetulkan medan yang ditunjukkan sebelum permintaan penciptaan baharu.
Respons409 · `video_not_ready`	SyaratKandungan hasil asal belum tersedia	Langkah seterusnyaSemak ID asal yang dikembalikan secara berkala dan patuhi Retry-After.
Respons`server_error`	SyaratRespons yang dikembalikan menyatakan bahawa operasi atau hasil memerlukan semakan	Langkah seterusnyaSimpan ID operasi/tugas asal yang dikembalikan, pengepala permintaan dan respons; teruskan pembacaan yang disokong bagi operasi asal tersebut. Jangan hantar semula permintaan penciptaan.

Alias

Alias model

Ailoot grok-imagine-video

Alias laluan kaedah

Gunakan laluan kaedah yang dipaparkan di atas.

ID pemanggil berkaitan

grok-imagine-video

FAQ · grok-imagine-video

Apakah input dan hasil yang tersedia?: POST /v1/videos/generations · grok-imagine-video: text → video
Apakah medan yang digunakan oleh permintaan?: POST /v1/videos/generations · grok-imagine-video: model, prompt, duration, seconds, resolution, aspect_ratio, size, image
Apakah had yang terpakai?: POST /v1/videos/generations · grok-imagine-video: duration.minimum: 1; duration.maximum: 15; seconds.minimum: 1; seconds.maximum: 15

grok-imagine-video