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

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.

Metinden veya metin artı bir kaynak görselden bir Grok video işi başlatmak için bu endpoint’i kullanın. Hemen bir request_id 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
  • İlk istek için duration değerini 1 ve resolution değerini 480p olarak tutun
  • image.url öğesini yalnızca image-to-video istediğinizde ekleyin
  • Base64 gönderiyorsanız, dokümanlardaki ve OpenAPI örneğindeki biçimi data:image/png;base64,<BASE64_IMAGE_DATA> olarak koruyun

​
Görev akışı

1

İşi oluşturun

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

Tamamlanma için sorgulayın

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

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

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

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.