Pereiti prie pagrindinio turinio
Lietuvių— Pasirinkite kalbą
Meniu

Pratęsti vaizdo įrašą naudojant /v1/videos/extensions

Paskaita 8 iš 12 Atnaujinta 2026 m. lapkričio 2 d. Vidutinis lygis
Šiame puslapyje
  1. Esamo vaizdo įrašo pratęsimas
  2. POST /v1/videos/extensions galinis punktas
  3. Trys būdai tęsti sceną
  4. Grandininis pratęsimas sekos kūrimui
  5. Generavimo ir pratęsimo duetas
  6. Svarbiausi punktai

Pamoka atnaujinta 2026 m. lapkričio 2 d. pagal xAI vaizdo API dokumentaciją: pratęsimo užklausa gauna vaizdo įrašą video objekte ({"url": ...}), lygiai taip pat kaip ir redaguojant – ankstesnis tekstas teigė priešingai – rezultatas nuskaitytas iš video.url, o šaltinio trukmė ribojama iki 15 sekundžių. Šaltiniai: Vaizdo pratęsimas · Vaizdo nuoroda.

Esamo vaizdo įrašo pratęsimas

Jei redaguojant sekos turinys keičiamas nekeičiant jos trukmės, tai pratęsiant daroma viskas atvirkščiai: vaizdo įrašas pailginamas sugeneruojant tęsinį, kuris dera prie to, kas buvo anksčiau. Tai išsprendžia dažniausią vaizdo įrašų kūrimo problemą – sėkmingas klipas yra per trumpas arba scena nusipelno vystymosi beyond pradinės trukmės. Užuot generavus viską iš naujo ir tikintis atkurti tą pačią išvaizdą, pradedi nuo to, kas jau sukurta, ir tęsi.

POST /v1/videos/extensions galinis punktas

Užklausa panaši į generavimo užklausą, tik pridėtas pradinis vaizdo įrašas.

{
  "model": "grok-imagine-video",
  "prompt": "Continue the scene with a zoom out revealing the full landscape",
  "video": {"url": "https://exemple.com/video-courte.mp4"},
  "duration": 5
}

Laukas model lieka grok-imagine-video, prompt aprašo, kas turi nutikti tęsinyje, video objektas nurodo pratęsiamą vaizdo įrašą (url arba įkeltos failo file_id, šaltinio trukmė nuo 2 iki 15 sekundžių), o duration nustato pratęsimo ilgį nuo 2 iki 10 sekundžių – numatytoji vertė yra 6 sekundės. Skirtingai nei redaguojant, čia vėl gauni kontrolę over trukmę. Grąžinamas vaizdo įrašas zawiera originalą ir pratęsimą: 10 sekundžių šaltinis, pratęstas 5 sekundėmis, duoda 15 sekundžių vaizdo įrašą.

Ši lentelė apibendrina, kas skiria šiuos du galinius punktus, nes painiava yra dažna.

AspektasRedagavimas (/edits)Pratęsimas (/extensions)
TikslasKeisti turinįPridėti trukmės
Vaizdo parametrasvideo objektas (url arba file_id)video objektas (url arba file_id)
Šaltinio trukmėMaks. 8,7 sNuo 2 iki 15 s
Išvesties trukmėTokia pati kaip šaltinio (Maks. 720p)Šaltinis + nuo 2 iki 10 s
Originalus turinysModifikuojamasIšsaugomas

Abu REST API galiniai punktai gauna vaizdo įrašą vienodai – video objekte su url savybe. Tačiau Python SDK jį priima kaip video_url parametrą: nekopijuok šio parametro pavadinimo į JSON kūną, nes API jo neatpažins. Tai, kas iš tikrųjų skiria šiuos du galinius punktus, yra trukmė.

Trys būdai tęsti sceną

Paprastiausias atvejis – leisti vykstančiam veiksmui tiesiog tęstis. Promptas perima dabartinį veiksmą ir pratęsia jį be pertraukos.

{
  "model": "grok-imagine-video",
  "prompt": "The character continues walking along the beach, waves rolling gently",
  "video": {"url": "https://exemple.com/promenade.mp4"},
  "duration": 6
}

Taip pat gali įvesti pokytį, tai yra, pridėti naują elementą arba pakeisti žiūrėjimo kryptį. Tai suteikia sekai naratyvinę progresiją.

{
  "model": "grok-imagine-video",
  "prompt": "The camera pivots right revealing a lighthouse in the distance, the lighthouse beam starts to rotate",
  "video": {"url": "https://exemple.com/plage.mp4"},
  "duration": 8
}

Trečiasis naudojimo atvejis – pabaiga: trumpas pratęsimas, kuris tvarkingai užbaigia seką, dažnai su išblukimu.

{
  "model": "grok-imagine-video",
  "prompt": "The scene ends with a gradual fade to black, the last glimmers of sunlight disappear on the horizon",
  "video": {"url": "https://exemple.com/coucher-soleil.mp4"},
  "duration": 4
}

Grandininis pratęsimas sekos kūrimui

Niekas netrukdo pratęsti vaizdo įrašo kelis kartus iš eilės. Kiekvienas pratęsimas sukuria naują vaizdo įrašą, kurio URL gali būti naudojamas kaip šaltinis kitam pratęsimui, leidžiant sukurti ilgą seką per nuoseklius segmentus, kurių kiekvienas valdomas savo promptu. Toliau pateiktas scenarijus sujungia tris pratęsimus, kiekviame žingsnyje iš naujo panaudojant gautą URL.

import httpx
import time

api_key = "your_key"
headers = {"Authorization": f"Bearer {api_key}", "Content-Type": "application/json"}

def attendre_video(request_id):
    """Poll status until completion."""
    while True:
        resp = httpx.get(
            f"https://api.x.ai/v1/videos/{request_id}",
            headers=headers
        ).json()
        if resp["status"] == "done":
            return resp["video"]["url"]
        if resp["status"] == "failed":
            raise RuntimeError(f"Generation failed: {resp.get('error')}")
        time.sleep(5)

# Base video
video_url = "https://exemple.com/video-initiale.mp4"

# Chain 3 extensions
prompts = [
    "The character crosses the bridge, profile view",
    "He stops in the middle and looks at the river below",
    "He resumes walking toward the other bank, the camera follows"
]

for prompt in prompts:
    resp = httpx.post(
        "https://api.x.ai/v1/videos/extensions",
        headers=headers,
        json={
            "model": "grok-imagine-video",
            "prompt": prompt,
            "video": {"url": video_url},
            "duration": 5
        }
    ).json()
    video_url = attendre_video(resp["request_id"])
    print(f"Extension complete: {video_url}")

Šis elegantiškumas turi savo kainą – tiek tiesiogine, tiek perkeltine prasme. Kiekvienas pratęsimas apmokestinamas atskirai. Šaltinis negali viršyti 15 sekundžių, o tai riboja grandinę: pradedant nuo 5 sekundžių, seka po trijų 5 sekundžių pratęsimų pasiekia 20 sekundžių, o ketvirtasis būtų atmestas. Vaizdinis nuoseklumas blogėja per grandies grandis, nes kiekvienas žingsnis remiasi jau interpretuota išvestimi: po trijų ar keturių sujungtų pratęsimų tampa matomi spalvų ir morfologijos nukrypimai. Ir kaip visur šiame API, URL adresai yra laikini – atsisiųsk kiekvieną tarpinę versiją, kitaip nesėkmė grandinės pabaigoje privers tave pradėti viską iš naujo nuo pradžių.

Generavimo ir pratęsimo duetas

Dažniausias gamybos modelis sujungia abu galinius punktus. Pirmiausia sugeneruoji trumpą 3 sekundžių bazę su labai tikslu promptu naudodamas POST /v1/videos/generations, tai leidžia iteruoti pradinę estetiką mažesnėmis išlaidomis. Tada pridedi 5 sekundes vystymosi per POST /v1/videos/extensions, o tada 4 sekundes pabaigos per antrąjį kreipimąsi į tą patį galinį punktą. Rezultatas – 12 sekundžių vaizdo įrašas, sukurtas segmentais, kur kiekviena dalis buvo patvirtinta prieš pradedant kitą – tokios kontrolės negalėtų suteikti vienkartinis 12 sekundžių generavimas.

Svarbiausi punktai

  • Pratęsimas pailgina 2–15 sekundžių vaizdo įrašą 2–10 sekundžių segmentu (numatyta 6) ir grąžina visą vaizdo įrašą
  • Šaltinio vaizdo įrašas dedamas į video objektą (url arba file_id), kaip ir redaguojant; Python SDK jį priima kaip video_url
  • Grandininis pratęsimas leidžia kurti ilgas sekas žingsnis po žingsnio
  • Nuoseklumas blogėja po 3–4 nuoseklių pratęsimų
  • Derink pradinį generavimą su pratęsimais, kad gautum tikslų turinio valdymą