Skip to main content
POST
cURL
Użyj tego endpointu, aby edytować istniejący plik MP4 za pomocą instrukcji tekstowej. Wynik pozostaje bliższy synchronizacji i kompozycji klipu źródłowego niż w przypadku nowego żądania generowania.

Zanim wyślesz żądanie

  • Podaj dostępny video.url
  • Źródłowy klip powinien być krótki; własne wytyczne xAI ograniczają edycje do około 8,7 sekundy
  • Użyj precyzyjnej instrukcji opisującej jedną, jasno określoną zmianę
  • Zachowaj zwrócony request_id, ponieważ edycje używają tego samego mechanizmu odpytywania co generowanie

Przepływ edycji

1

Prześlij żądanie edycji

Wyślij URL źródłowego wideo, prompt edycji oraz model: grok-imagine-video.
2

Odpytywanie o końcowy wynik

Wywołuj Pobierz wyniki wideo xAI, aż zadanie zostanie zakończone.
3

Zapisz edytowany zasób

Pobierz gotowy wynik lub przenieś zwrócony URL do własnego pipeline’u przechowywania.

Co zmienia się w CometAPI

xAI opisuje edycję wideo jako ten sam asynchroniczny cykl życia co generowanie, tylko z użyciem źródłowego wideo zamiast opcjonalnego obrazu źródłowego. CometAPI zachowuje to działanie i ten sam endpoint odpytywania, więc Twój workflow edycji nadal wygląda tak: start -> poll -> download.

Autoryzacje

Authorization
string
header
wymagane

Bearer token authentication. Use your CometAPI key.

Treść

application/json
prompt
string
wymagane

Edit instruction describing the change you want.

Przykład:

"Add snow to the scene."

video
object
wymagane

Source video to edit. xAI documents an input limit of about 8.7 seconds.

model
string
domyślnie:grok-imagine-video

xAI video model id.

Przykład:

"grok-imagine-video"

output
object

Optional output delivery configuration.

user
string

Optional end-user identifier.

Odpowiedź

200 - application/json

Request accepted.

request_id
string
wymagane

Deferred request id used for polling.