Video Oluşturma

Grok ile video oluşturmak, bir giriş görüntüsünü prompt ile canlandırmak ve sonuçları request_id üzerinden sorgulamak için CometAPI POST /grok/v1/videos/generations uç noktasını kullanın.

POST /grok/v1/videos/generations

cURL

Validated request

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

200

{
  "request_id": "4b2cd27e-0b0d-3dec-c31c-7572daf74bb3"
}

Metinden veya metne ek olarak bir kaynak görselden bir Grok video işi başlatmak için bu uç noktayı kullanın. request_id değerini hemen döndürür; bu yüzden bunu async bir iş akışının ilk adımı olarak ele alın.

​

Küçük bir istekle başlayın

• model: grok-imagine-video kullanın
• Hızlı bir test için duration değerini 1, resolution değerini ise 480p olarak tutun
• image.url alanını yalnızca image-to-video istediğinizde ekleyin
• Base64 gönderiyorsanız, belgelerde ve OpenAPI örnek biçiminde bunu data:image/png;base64,<BASE64_IMAGE_DATA> olarak koruyun

​

Görev akışı

1. İşi oluştur

   Prompt’u gönderin ve dönen request_id değerini kaydedin.

2. Tamamlanmayı sorgula

   İç içe provider status done olana kadar Get Video Generation Results çağrısını yapın.

3. Çıktıyı kalıcı olarak sakla

   Provider’ın geçici teslim penceresinden sonra da ihtiyacınız olacaksa, son video.url değerini kendi depolamanıza kopyalayın.

​

CometAPI üzerinde değişenler

xAI, video oluşturmayı iki adımlı bir başlat -> sorgula akışı olarak belgelendirir. CometAPI aynı istek şeklini ve aynı temel model kimliğini korur, ancak kimlik doğrulamayı CometAPI anahtarınızla yaparsınız ve CometAPI temel URL’sinde kalırsınız. Canlı bir 1 saniyelik 480p istek 2026-03-12 tarihinde başarıyla tamamlandı ve gerçek bir sonuç URL’si döndürdü.

Yetkilendirmeler

Authorization · string · header · gerekli

Bearer token authentication. Use your CometAPI key.

Gövde

application/json

prompt · string · gerekli

Prompt for the video job.

Örnek:

"A candle flickers on a wooden table."

aspect_ratio · enum<string>

Output aspect ratio.

Mevcut seçenekler: 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3

duration · integer · varsayılan: 1

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

image · object

Optional source image for image-to-video.

Show child attributes

model · string · varsayılan: grok-imagine-video

xAI video model id.

Örnek:

"grok-imagine-video"

output · object

Show child attributes

resolution · enum<string>

Output resolution.

Mevcut seçenekler: 480p, 720p

size · string

Deprecated size field. Prefer aspect_ratio and resolution.

user · string

Optional end-user identifier.

Yanıt

200 - application/json

Request accepted.

request_id · string · gerekli

Deferred request id used for polling.