Edycja wideo

Użyj POST /grok/v1/videos/edits, aby edytować źródłowe wideo za pomocą tekstowego promptu, zachować ruch i uzyskać request_id do asynchronicznego odpytywania o wyniki.

POST /grok/v1/videos/edits

Create an xAI video edit job

cURL

curl --request POST \
  --url https://api.cometapi.com/grok/v1/videos/edits \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "Add snow to the scene.",
  "video": {
    "url": "https://example.com/source.mp4"
  }
}
'

200

{
  "request_id": "e55813f7-911f-cfa8-208c-9c8e693b4d38"
}

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
• Zachowaj krótki klip źródłowy; własne wytyczne xAI ograniczają edycje do około 8,7 sekundy
• Użyj konkretnej instrukcji, która opisuje jedną wyraźną zmianę
• Zachowaj zwrócony request_id, ponieważ edycje korzystają z 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 wynik końcowy

   Wywołuj Get Video Generation Results, 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 przepływ pracy edycji nadal wygląda tak: start -> odpytywanie -> pobranie.

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.

Show child attributes

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.