Edycja wideo za pomocą /v1/videos/edits
Na tej stronie
Zaktualizowano 3 listopada 2026 r. Na podstawie strony Video Editing od xAI: wideo źródłowe może mieć maksymalnie 8,7 sekundy, wynik zachowuje jego czas trwania, proporcje i rozdzielczość (maks. 720p), a rozszerzanie korzysta z tego samego obiektu
videoco edycja. Poprzednie twierdzenie, że edycja jest niewiarygodna dla konkretnych elementów, stoi w sprzeczności z przykładami xAI, które skupiają się właśnie na precyzyjnych zmianach. Źródła: Video Editing · Video Overview.
Edycja istniejącego wideo
Generowanie to tylko część pracy. API xAI udostępnia również punkt końcowy edycji wideo, który przyjmuje istniejącą sekwencję i modyfikuje ją na podstawie poleceń tekstowych. Jest to wideo odpowiednik edycji obrazu, ale z bardziej rygorystycznymi ograniczeniami formatu. Zanim napiszesz swoje pierwsze żądanie, zapoznaj się z czterema granicami określającymi, co możesz przesłać.
Punkt końcowy POST /v1/videos/edits
Żądanie łączy wideo źródłowe z poleceniem opisującym pożądaną modyfikację.
{
"model": "grok-imagine-video",
"prompt": "Change the background to a sunset over the ocean",
"video": {
"url": "https://example.com/original-video.mp4"
}
}
Wystarczą trzy pola: model, które pozostaje grok-imagine-video; prompt, zawierające opis modyfikacji; oraz video.url, wskazujące na plik MP4 do przetworzenia. Zauważ, że wideo jest zamknięte w obiekcie video, który akceptuje url lub file_id przesłanego pliku: punkt końcowy rozszerzania, omawiany w następnej lekcji, stosuje tę samą konwencję.
Ograniczenia techniczne są tutaj surowsze niż w przypadku generowania. Źródło nie może przekraczać 8,7 sekundy, a wygenerowane wideo zachowuje jego czas trwania; strona Video Generation wspomina o czasie trwania „ograniczonym do 8,7 sekundy“, nie precyzując obsługi dłuższego źródła: dlatego przycinaj swoje materiały źródłowe wcześniej. Rozdzielczość jest ograniczona do 720p. Plik wejściowy musi być plikiem MP4 w obsługiwanym kodeku, takim jak H.264, H.265 lub AV1. Najbardziej mylącym punktem dla osób przychodzących z generowania jest fakt, że nie masz kontroli nad czasem trwania, proporcjami ani rozdzielczością wyniku – wszystkie te parametry są determinowane przez wideo źródłowe. Żądanie edycji nie zawiera pola duration, aspect_ratio ani resolution.
O co prosić podczas edycji
Zamiana tła to klasyczny przypadek: obiekt pozostaje, zmienia się otoczenie.
{
"model": "grok-imagine-video",
"prompt": "Replace the background with a space landscape with stars and nebulae. Keep the same subject and the same movement.",
"video": {"url": "https://example.com/video.mp4"}
}
Zmiany stylu wpływają na cały obraz i przekształcają styl klipu bez modyfikowania jego akcji – jest to praktyczne rozwiązanie do adaptacji tej samej sekwencji do różnych uniwersów.
{
"model": "grok-imagine-video",
"prompt": "Transform this video into a Japanese cartoon style with vivid colors",
"video": {"url": "https://example.com/video.mp4"}
}
Dodawanie elementów wzbogaca scenę o warstwy, których nie było podczas nagrywania, zazwyczaj o charakterze atmosferycznym.
{
"model": "grok-imagine-video",
"prompt": "Add falling snow and a frost effect on the edges",
"video": {"url": "https://example.com/video.mp4"}
}
Na koniec modyfikacja oświetlenia sprowadza się do ponownego gradingu sekwencji: te same ujęcia, radykalnie inna atmosfera.
{
"model": "grok-imagine-video",
"prompt": "Change the lighting to a night ambiance with blue and purple neon lights",
"video": {"url": "https://example.com/video.mp4"}
}
Cykl asynchroniczny, identyczny jak przy generowaniu
Edycja podlega dokładnie temu samemu czteroetapowemu protokołowi co generowanie: wysyłasz żądanie, otrzymujesz request_id, odpytujesz GET /v1/videos/{request_id} w regularnych odstępach czasu i pobierasz edytowane wideo, gdy status zmieni się na done. W Pythonie pierwsze dwa kroki mieszczą się w kilku liniach kodu.
import httpx
# 1. Prześlij edycję
response = httpx.post(
"https://api.x.ai/v1/videos/edits",
headers={"Authorization": f"Bearer {api_key}"},
json={
"model": "grok-imagine-video",
"prompt": "Add a rain effect over the entire scene",
"video": {"url": "https://example.com/source.mp4"}
}
)
request_id = response.json()["request_id"]
# 2. Odpytuj status (uproszczone)
status = httpx.get(
f"https://api.x.ai/v1/videos/{request_id}",
headers={"Authorization": f"Bearer {api_key}"}
).json()
Określ, co się zmienia, a co pozostaje bez zmian
xAI opisuje zachowanie modelu w jednym zdaniu: grok-imagine-video wprowadza żądaną zmianę i utrzymuje wszystko inne jak najbliżej oryginału. Dokumentacja wyprowadza z tego wytyczną: powiedz również, co musi pozostać identyczne. Własne przykłady xAI koncentrują się również na precyzyjnych edycjach pojedynczego klipu – dodanie srebrnego naszyjnika, zmiana stroju na czerwony, założenie czarnego kapelusza z szerokim rondem na postać – uruchamiane równolegle na tym samym źródle.
{
"model": "grok-imagine-video",
"prompt": "Change the woman's jacket to red. Keep the same face, the same setting, the same framing, and the same movement.",
"video": {"url": "https://example.com/video.mp4"}
}
Przewodnik po promptach obrazowych xAI, napisany dla obrazów statycznych, określa kolejność, która działa: najpierw modyfikacja, a następnie zdanie blokujące to, co ma pozostać statyczne. Edycja zaczynająca się od „zachowaj wszystko“ prawie nic nie zmienia, a edycja kopiująca pełny prompt generujący na nowo wymyśla scenę.
Cztery nawyki pozwalają uniknąć większości pułapek: utrzymuj źródła poniżej 8,7 sekundy w obsługiwanym kodeku (H.264, H.265 lub AV1); nazywaj to, co musi pozostać nienaruszone; testuj modyfikację na krótkim klipie przed skalowaniem; i pamiętaj, że edycja korzysta z grok-imagine-video, którego cennik pokazuje jedną stawkę: 0,050 USD za sekundę – seria prób kosztuje tyle samo co generowanie.
Kluczowe wnioski
- Punkt końcowy
POST /v1/videos/editsmodyfikuje istniejące wideo na podstawie promptu, używając wyłączniegrok-imagine-video - Źródło trwa maksymalnie 8,7 sekundy; wynik zachowuje jego czas trwania, proporcje i rozdzielczość (maks. 720p)
- Wideo źródłowe musi być plikiem MP4 w obsługiwanym kodeku (H.264, H.265, AV1)
- Żądanie nie zawiera pola
duration,aspect_ratioaniresolution - Określ, co ma się zmienić, a następnie co musi pozostać identyczne