Dokumentacja referencyjna API
Przewodniki integracji
Cennik i rozliczenia
xAI
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 --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"
}
}
'{
"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
Odpytywanie o wynik końcowy
Wywołuj Get Video Generation Results, aż zadanie zostanie zakończone.
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
Bearer token authentication. Use your CometAPI key.
Treść
application/json
Edit instruction describing the change you want.
Przykład:
"Add snow to the scene."
Source video to edit. xAI documents an input limit of about 8.7 seconds.
Show child attributes
Show child attributes
xAI video model id.
Przykład:
"grok-imagine-video"
Optional output delivery configuration.
Optional end-user identifier.
Odpowiedź
200 - application/json
Request accepted.
Deferred request id used for polling.
⌘I
Create an xAI video edit job
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"
}
}
'{
"request_id": "e55813f7-911f-cfa8-208c-9c8e693b4d38"
}