Przejdź do głównej treści
Polski— Wybierz język
Menu

Edycja wideo za pomocą /v1/videos/edits

Lekcja 7 z 12 Zaktualizowano 3 listopada 2026 Średnio zaawansowani
Na tej stronie
  1. Edycja istniejącego wideo
  2. Punkt końcowy POST /v1/videos/edits
  3. O co prosić podczas edycji
  4. Cykl asynchroniczny, identyczny jak przy generowaniu
  5. Określ, co się zmienia, a co pozostaje bez zmian
  6. Kluczowe wnioski

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 video co 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ć.

8.7 s
Maksymalny czas źródła
720p
Maksymalna rozdzielczość
H.265
Akceptowany kodek (np. H.264, AV1)
MP4
Wymagany format

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/edits modyfikuje istniejące wideo na podstawie promptu, używając wyłącznie grok-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_ratio ani resolution
  • Określ, co ma się zmienić, a następnie co musi pozostać identyczne