Source: https://ailoot.ai/models/ms/grok-imagine-video/
Canonical: https://ailoot.ai/models/ms/grok-imagine-video/
Language: ms

# grok-imagine-video

[Markdown](https://ailoot.ai/models/ms/grok-imagine-video/index.md) · [JSON](https://ailoot.ai/models/ms/grok-imagine-video/facts.json)

## [grok-imagine-video](https://ailoot.ai/models/ms/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`](https://ailoot.ai/models/ms/grok-imagine-video/#method-0)

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`](https://ailoot.ai/models/ms/#m=grok-imagine-video&route=Core&caller=grok-imagine-video&fmt=videos)

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

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 →](https://ailoot.ai/docs/ms/billing/reserve/)

### Contoh permintaan

#### Ailoot · Penjanaan video

Contoh video

```bash
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

```bash
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

```bash
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`](https://ailoot.ai/models/ms/#m=grok-imagine-video&route=Core&caller=grok-imagine-video&fmt=videos)

#### Alias laluan kaedah

Gunakan laluan kaedah yang dipaparkan di atas.

#### ID pemanggil berkaitan

[`grok-imagine-video`](https://ailoot.ai/models/ms/#m=grok-imagine-video&route=Core&caller=grok-imagine-video&fmt=videos)

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`

Sambungkan Ailoot kepada Claude Code, OpenCode, Hermes atau aplikasi anda.

## Syarikat dan portfolio projeknya

Syarikat dan portfolio projeknya: jutaan pelanggan; jualan bernilai berbilion setiap bulan.

## Beli token dengan diskaun.

Diskaun langganan untuk penggunaan berkala. Kod promosi — sehingga 50% bagi pembelian token.

Langganan

Pilih pelan berdiskaun untuk permintaan berkala anda.

Kod promosi sehingga 50%

Masukkan kod semasa pembelian. Harga dikira semula mengikut promosi semasa.

Perbelanjaan dalam sejarah

Model, token dan jumlah disimpan bagi setiap permintaan.

[Pilih langganan](https://ailoot.ai/docs/ms/billing/subscriptions/) · [Lihat harga model](https://ailoot.ai/models/ms/)

## Sambungkan API kepada produk yang anda jual.

SaaS, aplikasi dan bot — di bawah tawaran rasmi serta perjanjian lesen Ailoot. Untuk jualan semula, mohon lesen penjual semula.

Aplikasi komersial

Tambahkan penjanaan teks, imej, video dan audio pada ciri berbayar perkhidmatan anda.

Lesen penjual semula

Hantar keterangan projek dan susunan akses. Minta terma penggunaan serta jualan semula secara bertulis.

Dokumen pada laman

Tawaran, perjanjian lesen dan dasar pemprosesan data tersedia sebelum sambungan.

[Mohon lesen penjual semula](mailto:support@ailoot.ai) · [Tawaran dan perjanjian lesen](https://ailoot.ai/legal/offer?lang=ms)

## Ailoot · Syarikat dan portfolio projeknya





Ailoot berteraskan pengalaman operasi yang mantap, pangkalan pelanggan yang besar, perkhidmatan yang stabil dan pemantauan KPI berterusan.





Syarikat dan portfolio projeknya: jutaan pelanggan; jualan bernilai berbilion setiap bulan.





Ailoot menggunakan pengalaman operasi ini untuk akses API kepada ciri AI dalam produk pelanggan, ejen, aplikasi dan automasi.
