Panduan Integrasi
Kesalahan
Harga & Penagihan
xAI
Generasi Video
Gunakan CometAPI POST /grok/v1/videos/generations untuk membuat video dengan Grok, menganimasikan gambar input melalui prompt, dan melakukan polling hasil melalui request_id.
POST
/
grok
/
v1
/
videos
/
generations
curl --request POST \
--url https://api.cometapi.com/grok/v1/videos/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"prompt": "A candle flickers on a wooden table."
}
'
{
"request_id": "4b2cd27e-0b0d-3dec-c31c-7572daf74bb3"
}Gunakan endpoint ini untuk memulai job video Grok dari teks, atau dari teks ditambah satu gambar sumber. Endpoint ini langsung mengembalikan
request_id, jadi perlakukan ini sebagai langkah pertama dalam alur kerja async.
Mulai dengan request kecil
- Gunakan
model: grok-imagine-video - Untuk smoke test, pertahankan
durationpada1danresolutionpada480p - Tambahkan
image.urlhanya saat Anda ingin image-to-video - Jika Anda mengirim base64, pertahankan bentuk dokumen dan contoh OpenAPI sebagai
data:image/png;base64,<BASE64_IMAGE_DATA>
Alur tugas
Polling hingga selesai
Panggil Get Video Generation Results sampai status provider yang bersarang menjadi
done.Apa yang berubah di CometAPI
xAI mendokumentasikan generasi video sebagai alur dua langkah start -> poll. CometAPI mempertahankan bentuk request yang sama dan id model inti yang sama, tetapi Anda melakukan autentikasi dengan kunci CometAPI Anda dan tetap menggunakan base URL CometAPI. Request live 1 detik 480p berhasil selesai pada 2026-03-12 dan mengembalikan URL hasil yang nyata.Otorisasi
Bearer token authentication. Use your CometAPI key.
Body
application/json
Prompt for the video job.
Contoh:
"A candle flickers on a wooden table."
Output aspect ratio.
Opsi yang tersedia:
1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3 Output duration in seconds. xAI documents a range of 1 to 15 seconds.
Optional source image for image-to-video.
Show child attributes
Show child attributes
xAI video model id.
Contoh:
"grok-imagine-video"
Show child attributes
Show child attributes
Output resolution.
Opsi yang tersedia:
480p, 720p Deprecated size field. Prefer aspect_ratio and resolution.
Optional end-user identifier.
Respons
200 - application/json
Request accepted.
Deferred request id used for polling.
⌘I
curl --request POST \
--url https://api.cometapi.com/grok/v1/videos/generations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"prompt": "A candle flickers on a wooden table."
}
'
{
"request_id": "4b2cd27e-0b0d-3dec-c31c-7572daf74bb3"
}