Langsung ke konten utama
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"
}

Documentation Index

Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt

Use this file to discover all available pages before exploring further.

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 request pertama, pertahankan duration pada 1 dan resolution pada 480p
  • Tambahkan image.url hanya saat Anda ingin image-to-video
  • Jika Anda mengirim base64, pertahankan bentuk contoh docs dan OpenAPI sebagai data:image/png;base64,<BASE64_IMAGE_DATA>

​
Alur tugas

1

Create the job

Kirim prompt dan simpan request_id yang dikembalikan.
2

Poll for completion

Panggil Get Video Generation Results sampai status provider bersarang menjadi done.
3

Persist the output

Salin video.url akhir ke penyimpanan Anda sendiri jika Anda membutuhkannya setelah jendela pengiriman sementara milik provider berakhir.

Otorisasi

​
Authorization
string
header
wajib

Bearer token authentication. Use your CometAPI key.

Body

application/json
​
prompt
string
wajib

Prompt for the video job.

Contoh:

"A candle flickers on a wooden table."

​
aspect_ratio
enum<string>

Output aspect ratio.

Opsi yang tersedia:
1:1,
16:9,
9:16,
4:3,
3:4,
3:2,
2:3
​
duration
integer
default:1

Output duration in seconds. xAI documents a range of 1 to 15 seconds.

​
image
object

Optional source image for image-to-video.

​
model
string
default:grok-imagine-video

xAI video model id.

Contoh:

"grok-imagine-video"

​
output
object
​
resolution
enum<string>

Output resolution.

Opsi yang tersedia:
480p,
720p
​
size
string

Deprecated size field. Prefer aspect_ratio and resolution.

​
user
string

Optional end-user identifier.

Respons

200 - application/json

Request accepted.

​
request_id
string
wajib

Deferred request id used for polling.