Grok ile video oluşturun

POST

grok

videos

generations

curl https://api.cometapi.com/grok/v1/videos/generations \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -H "Content-Type: application/json" \
  --data-binary '{
  "model": "grok-imagine-video-1.5",
  "prompt": "A paper boat glides across a quiet pond at sunrise.",
  "duration": 1,
  "aspect_ratio": "16:9",
  "resolution": "480p"
}'

{
  "request_id": "<request_id>"
}

Metinden, kaynak görüntüden veya referans girdilerinden bir Grok video işi başlatmak için bu endpoint’i kullanın. Hemen bir request_id döndürdüğünden, bunu eşzamansız iş akışının ilk adımı olarak ele alın. model: grok-imagine-video-1.5 öğesini her zaman açıkça gönderin. model ve prompt, burada belgelenen 1.5 istek biçimleri için zorunludur.

Bir giriş modu seçin

Mod	İstek alanları	Kurallar
Metinden videoya	`prompt`	Şunları atlayın: `image`, `reference_images` ve `reference_audios`.
Görüntüden videoya	`prompt`, `image.url`	`image.url` genel erişime açık bir görüntü URL’sini veya görüntü veri URI’sini kabul eder. `image` ifadesini referans girdileriyle birleştirmeyin.
Referanstan videoya	`prompt` ve şu seçeneklerden en az birini: `reference_images` veya `reference_audios`	En fazla 7 referans görüntüsü ve en fazla 3 önceden ayarlanmış ses gönderin. Referanstan videoya çıktısı en fazla `720p`.

Veri URI’si için data:image/png;base64,<BASE64_IMAGE_DATA> kullanın. Her reference_images öğesi aynı url alanını kullanır. Bir referans ses öğesi, örneğin voice_id gibi önceden ayarlanmış bir eve kullanır. Prompt içinde <IMAGE_0> ve <AUDIO_0> gibi etiketler karşılık gelen referansı belirleyebilir.

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

model: grok-imagine-video-1.5 kullanın
İlk istek için duration değerini 1 olarak ve resolution değerini 480p olarak tutun
Sahne ve hareketin net olması için prompt öğesini açıkça belirtin
Referans görüntülerini ve sesleri birleştirmeden önce her seferinde bir giriş modu ekleyin

Süre ve çözünürlük

Ayar	Desteklenen değerler	Varsayılan	Sınır davranışı
`duration`	tamsayı `1`-`15`	`8`	İlk testler için daha kısa klipler kullanın; daha uzun klipler daha pahalıdır ve tamamlanmaları daha uzun sürer.
`resolution`	`480p`, `720p`, `1080p`	`480p`	Daha yüksek çözünürlüklü istekler daha pahalıdır ve tamamlanmaları daha uzun sürer. Referanstan videoya en fazla `720p`.
`aspect_ratio`	`1:1`, `16:9`, `9:16`, `4:3`, `3:4`, `3:2`, `2:3`	`16:9` metinden videoya için	Görüntüden videoya için, belirtilmemesi kaynak görüntünün en-boy oranını korur.

Oluşturulan videolar bir ses parçası içerir. Uygulamanız belirli bir çıktı biçimine bağlıysa duration, resolution ve aspect_ratio öğelerini açıkça ayarlayın.

Görev akışı

İşi oluşturun

Modeli, Prompt’u ve tüm girdileri gönderin, ardından döndürülen request_id değerini kaydedin.

Tamamlanma için yoklayın

Şunu çağırın: xAI video sonuçlarını alın üst düzey status değeri done, failed veya expired olana kadar. Görev meta verileri hazırlanırken ilk yanıt yalnızca yansıtılan request_id değerini içerebilir.

Çıktıyı kalıcı olarak saklayın

Geçici teslim penceresinden sonra ihtiyacınız olacaksa nihai video.url değerini kendi depolama alanınıza kopyalayın.

Yetkilendirmeler

Authorization

string

header

gerekli

Use your CometAPI API key as the bearer value.

Gövde

application/json

model

enum<string>

gerekli

The Grok video model ID. Send this field explicitly so the request uses Grok Imagine Video 1.5.

Mevcut seçenekler:

grok-imagine-video-1.5

Örnek:

"grok-imagine-video-1.5"

prompt

string

gerekli

A description of the scene, motion, and audio. Reference-to-video prompts can identify inputs with tags such as <IMAGE_0> and <AUDIO_0>.

Minimum string length: 1

Örnek:

"A paper boat glides across a quiet pond at sunrise."

duration

integer

varsayılan:8

The output duration in seconds. Use an integer from 1 through 15.

Gerekli aralık: 1 <= x <= 15

aspect_ratio

enum<string>

The output aspect ratio. Text-to-video uses 16:9 when omitted. Image-to-video uses the source image's aspect ratio when omitted.

Mevcut seçenekler:

1:1,

16:9,

9:16,

4:3,

3:4,

3:2,

2:3

Örnek:

"16:9"

resolution

enum<string>

varsayılan:480p

The output resolution. Reference-to-video requests support 480p and 720p; text-to-video and image-to-video also support 1080p.

Mevcut seçenekler:

480p,

720p,

1080p

image

object

The source image for image-to-video. Do not combine this field with reference_images or reference_audios.

Show child attributes

reference_images

object[]

Visual references for reference-to-video. Each item accepts a public image URL or image data URI. Do not combine this field with image.

Required array length: 1 - 7 elements

Show child attributes

reference_audios

object[]

Preset voice references for reference-to-video. Do not combine this field with image.

Required array length: 1 - 3 elements

Show child attributes

Yanıt

200 - application/json

Request accepted.

request_id

string

gerekli

The deferred request ID used to poll GET /grok/v1/videos/{request_id}.

Son değiştirilme tarihi 21 Ağustos 2026

curl https://api.cometapi.com/grok/v1/videos/generations \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -H "Content-Type: application/json" \
  --data-binary '{
  "model": "grok-imagine-video-1.5",
  "prompt": "A paper boat glides across a quiet pond at sunrise.",
  "duration": 1,
  "aspect_ratio": "16:9",
  "resolution": "480p"
}'

{
  "request_id": "<request_id>"
}

İçerik moderasyonu

API anahtarları

Bir giriş modu seçin

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

Süre ve çözünürlük

Görev akışı

Yetkilendirmeler

Gövde

Yanıt

​Bir giriş modu seçin

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

​Süre ve çözünürlük

​Görev akışı

Yetkilendirmeler

Gövde

Yanıt

Bir giriş modu seçin

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

Süre ve çözünürlük

Görev akışı