Ana içeriğe atla
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"
}
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.

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

xAI video model id.

Örnek:

"grok-imagine-video"

​
output
object
​
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.