Przejdź do głównej treści
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.

Użyj tego endpointu, aby rozpocząć zadanie wideo Grok na podstawie tekstu lub tekstu plus jednego obrazu źródłowego. Zwraca on od razu request_id, więc traktuj go jako pierwszy krok w asynchronicznym workflow.

​
Zacznij od małego żądania

  • Użyj model: grok-imagine-video
  • W przypadku pierwszego żądania ustaw duration na 1, a resolution na 480p
  • Dodaj image.url tylko wtedy, gdy chcesz użyć image-to-video
  • Jeśli wysyłasz base64, zachowaj formę z dokumentacji i przykładu OpenAPI jako data:image/png;base64,<BASE64_IMAGE_DATA>

​
Przepływ zadania

1

Utwórz zadanie

Wyślij prompt i zapisz zwrócony request_id.
2

Sprawdzaj ukończenie

Wywołuj Get Video Generation Results, aż zagnieżdżony status dostawcy zmieni się na done.
3

Zapisz wynik

Skopiuj końcowy video.url do własnego magazynu, jeśli potrzebujesz go po upływie tymczasowego okna dostarczenia po stronie dostawcy.

Autoryzacje

​
Authorization
string
header
wymagane

Bearer token authentication. Use your CometAPI key.

Treść

application/json
​
prompt
string
wymagane

Prompt for the video job.

Przykład:

"A candle flickers on a wooden table."

​
aspect_ratio
enum<string>

Output aspect ratio.

Dostępne opcje:
1:1,
16:9,
9:16,
4:3,
3:4,
3:2,
2:3
​
duration
integer
domyślnie: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
domyślnie:grok-imagine-video

xAI video model id.

Przykład:

"grok-imagine-video"

​
output
object
​
resolution
enum<string>

Output resolution.

Dostępne opcje:
480p,
720p
​
size
string

Deprecated size field. Prefer aspect_ratio and resolution.

​
user
string

Optional end-user identifier.

Odpowiedź

200 - application/json

Request accepted.

​
request_id
string
wymagane

Deferred request id used for polling.