Utwórz wideo xAI

POST

grok

videos

generations

curl https://api.cometapi.com/grok/v1/videos/generations \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine-video-1.5",
    "prompt": "Animate the still image with a slow camera move and natural motion.",
    "image": {"url": "https://your-image-host/source.jpg"},
    "duration": 1,
    "aspect_ratio": "16:9",
    "resolution": "720p"
  }'

{
  "request_id": "<request_id>"
}

Użyj tego endpointu, aby uruchomić zadanie Grok image-to-video z jednego obrazu źródłowego i promptu. Zwraca on natychmiast request_id, więc traktuj go jako pierwszy krok w asynchronicznym workflow.

Zacznij od małego żądania

Użyj model: grok-imagine-video-1.5
Ustaw image.url na publiczny URL JPEG, PNG lub WebP
W przypadku pierwszego żądania pozostaw duration na 1, a resolution na 720p
Zachowaj jednoznaczny prompt, aby kierunek animacji był jasny
Jeśli wysyłasz base64, zachowaj formę z dokumentacji i przykładu OpenAPI jako data:image/png;base64,<BASE64_IMAGE_DATA>

Czas trwania i rozdzielczość

Ustawienie	Obsługiwane wartości	Domyślnie	Zachowanie graniczne
`duration`	liczba całkowita `1`-`15`	`8`	W pierwszych testach używaj krótszych klipów; dłuższe klipy kosztują więcej i dłużej się wykonują.
`resolution`	`480p`, `720p`, `1080p`	`720p` w przykładach	Żądania o wyższej rozdzielczości kosztują więcej i dłużej się wykonują.
`aspect_ratio`	oznaczenia proporcji, takie jak `1:1`, `16:9` lub `9:16`	`16:9` w przykładach	Ten endpoint używa `resolution` razem z `aspect_ratio`; nie wysyłaj osobnego pola `size` do dokładnego sterowania `WxH`.

Kombinacja żądania	Docelowe wyjście `WxH`
`resolution: 480p`, `aspect_ratio: 1:1`	`480x480`
`resolution: 720p`, `aspect_ratio: 16:9`	`1280x720`
`resolution: 720p`, `aspect_ratio: 9:16`	`720x1280`

Przepływ zadania

Utwórz zadanie

Wyślij prompt i obraz źródłowy, a następnie zapisz zwrócone request_id.

Odpytywanie o zakończenie

Wywołuj Pobierz wyniki wideo xAI, aż zagnieżdżony status providera przyjmie wartość done.

Zapisz wynik

Skopiuj końcowy video.url do własnego storage, jeśli potrzebujesz go po zakończeniu tymczasowego okna dostarczania u providera.

Autoryzacje

Authorization

string

header

wymagane

Bearer token authentication. Use your CometAPI key.

Treść

application/json

prompt

string

wymagane

Prompt describing how the source image should animate. CometAPI requires this field for this route.

Przykład:

"Animate the still image with a slow camera move and natural motion."

aspect_ratio

enum<string>

Output aspect ratio. Combine with resolution to choose the target frame; for example 480p with 1:1 targets 480x480, 720p with 16:9 targets 1280x720, and 720p with 9:16 targets 720x1280. This endpoint does not expose an exact size field.

Dostępne opcje:

1:1,

16:9,

9:16,

4:3,

3:4,

3:2,

2:3

duration

integer

domyślnie:8

Output duration in seconds. Use an integer from 1 through 15. If omitted, CometAPI treats the request as an 8-second generation for billing and default handling.

image

object

Source image for image-to-video. Use a public JPEG, PNG, or WebP URL, or a data URI such as data:image/png;base64,<BASE64_IMAGE_DATA>.

Show child attributes

model

string

domyślnie:grok-imagine-video-1.5

xAI video model id. The default example uses Grok Imagine 1.5 for image-to-video.

Przykład:

"grok-imagine-video-1.5"

output

object

Show child attributes

resolution

enum<string>

domyślnie:720p

Output resolution. Use 720p for a small image-to-video test, or 1080p when you need a higher resolution tier.

Dostępne opcje:

480p,

720p,

1080p

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.

Pobieranie treści wideo Wan

Poprzedni

Utwórz edycję wideo xAI

Następny

curl https://api.cometapi.com/grok/v1/videos/generations \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-imagine-video-1.5",
    "prompt": "Animate the still image with a slow camera move and natural motion.",
    "image": {"url": "https://your-image-host/source.jpg"},
    "duration": 1,
    "aspect_ratio": "16:9",
    "resolution": "720p"
  }'

{
  "request_id": "<request_id>"
}

Moderacja treści

Klucze API

Zacznij od małego żądania

Czas trwania i rozdzielczość

Przepływ zadania

Autoryzacje

Treść

Odpowiedź

​Zacznij od małego żądania

​Czas trwania i rozdzielczość

​Przepływ zadania

Autoryzacje

Treść

Odpowiedź

Zacznij od małego żądania

Czas trwania i rozdzielczość

Przepływ zadania