Aqbeż għall-kontenut ewlieni
Malti— Agħżel lingwa
Menu

Estensjoni tal-Video b'/v1/videos/extensions

Lezzjoni 8 / 12 Aġġornat 2 ta’ Novembru 2026 Livell Medju
F'din il-paġna
  1. L-estensjoni ta’ video eżistenti
  2. L-endpoint POST /v1/videos/extensions
  3. Tliet modi biex tkompli x-xena
  4. Il-katina tal-estensjonijiet biex tibni sekwenza
  5. Id-duo ġenerazzjoni mbagħad estensjoni
  6. Punti Ewlenin

Lezzjoni aġġornata fit-2 ta’ Novembru, 2026 abbażi tar-referenza tal-API tal-Video ta’ xAI: l-estensjoni tirċievi l-video f’oġġett video ({"url": ...}), eżattament bħall-editjar—it-test preċedenti kien iqarraq bil-kuntrarju—ir-riżultat jinqara minn video.url, u s-sors huwa limitat għal 15-il sekonda. Sorsi: Video Extension · Video Reference.

L-estensjoni ta’ video eżistenti

Fejn l-editjar jibdel sekwenza mingħajr ma jbiddel it-tul tagħha, l-estensjoni tagħmel l-eżatt oppost: ittawwal video billi tiġġenera kontinwazzjoni konsistenti ma’ dak li ġie qabel. Dan isolvi l-aktar problema komuni fil-ġenerazzjoni tal-video: klipp ta’ suċċess li huwa qasir wisq, jew xena li tistħoqqilha tiżvilupp lil hinn mit-tul inizjali tagħha. Minflok ma terġa’ tiġġenera kollox u tittama li terġa’ toħloq l-istess dehra, tibda minn dak li jeżisti u tkompli.

L-endpoint POST /v1/videos/extensions

It-talba tixbah talba ta’ ġenerazzjoni, bl-awżola tal-video tal-bidu.

{
  "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
}

Il-qasam model jibqa’ grok-imagine-video, il-prompt jiddeskrivi x’għandu jiġri fil-kontinwazzjoni, l-oġġett video jispeċifika l-video li għandha tiġi estiża (URL jew file_id ta’ fajl imtella’, għal sors bejn 2 u 15-il sekonda), u duration jistabbilixxi t-tul tal-estensjoni bejn 2 u 10 sekondi—id-default huwa 6 sekondi. Kuntrarjament għall-editjar, hawnhekk terġa’ tikseb il-kontroll fuq it-tul. Il-video rritornata fiha l-oriġinali segwita mill-estensjoni: sors ta’ 10 sekondi estiż b’5 sekondi jagħti video ta’ 15-il sekonda.

It-tabella li ġejja tikkondensa x’jifred iż-żewġ endpoints, peress li l-konfużjoni hija komuni.

AspettEditjar (/edits)Estensjoni (/extensions)
ObjettivTimmodifika l-kontenutŻid it-tul
Parametru tal-VideoOġġett video (url jew file_id)Oġġett video (url jew file_id)
Tul tas-sorsMassimu 8.7 s2 sa 15-il s
Tul tal-outputL-istess bħas-sors (Massimu 720p)Sors + 2 sa 10 s
Kontenut oriġinaliJimmodifikaJippreserva

Iż-żewġ endpoints tal-API REST jirċievu l-video bl-istess mod, f’oġġett video b’proprjetà url. L-SDK tal-Python, madankollu, jieħdu bħala l-parametru video_url: tikkopjax dan l-isem tal-parametru f’korp JSON, l-API ma jirrikonoxxihx. Dak li verament jiddistingwi ż-żewġ endpoints huwa d-durata.

Tliet modi biex tkompli x-xena

L-aktar każ sempliċi jikkonsisti f’li tħalli dak li diġà qed jiġri jkompli. Il-prompt jieħu l-azzjoni attwali u jestendih mingħajr waqfa.

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

Tista’ wkoll tintroduċi bidla, jiġifieri ġġib element ġdid jew timmodifika d-direzzjoni tal-vista. Dan jagħti lis-sekwenza l-progressjoni narrattiva tagħha.

{
  "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
}

It-tielet każ ta’ użu, il-konklużjoni: estensjoni qasira li tgħalaq is-sekwenza b’mod nadif, spiss b’dissolvenza.

{
  "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
}

Il-katina tal-estensjonijiet biex tibni sekwenza

Xejn ma jipprevjenek milli testendi video diversi drabi fuq xulxin. Kull estensjoni tipproduċi video ġdida li l-URL tagħha tista’ sservi bħala sors għall-estensjoni li jmiss, u b’hekk tippermettilek tibni sekwenza twila permezz ta’ segmenti suċċessivi, kull wieħed immexxi mill-prompt tiegħu stess. L-iskript li ġej iħabbat tliet estensjonijiet billi jerġa’ jdaħħal l-URL miksuba f’kull pass.

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}")

Din l-eleganza għandha prezz, kemm litteralment kif ukoll figurattivament. Kull estensjoni tiġi fatturata separatament. Is-sors ma jistax jaqbeż il-15-il sekonda, li jillimita l-katina: jekk tibda minn 5 sekondi, is-sekwenza tilħaq 20 sekonda wara tliet estensjonijiet ta’ 5 sekondi, u r-raba’ waħda tiġi miċħuda. Il-koerenza viżiva tiddeterjora matul il-links, peress li kull pass jiddependi fuq output diġà interpretat: wara tlieta jew erba’ estensjonijiet imħabbta flimkien, id-devjazzjonijiet fil-kulur u fil-morfoloġija jsiru viżibbli. U bħal kullimkien f’din l-API, l-URLs huma temporanji—niżżel kull verżjoni intermedjarja, inkella falliment fl-aħħar tal-katina jfurzak tibda mill-bidu.

Id-duo ġenerazzjoni mbagħad estensjoni

L-aktar mudell komuni fil-produzzjoni jgħaqqad iż-żewġ endpoints. L-ewwel tiġġenera bażi qasira ta’ 3 sekondi b’prompt preċiż ħafna, permezz ta’ POST /v1/videos/generations, li jippermettilek titeraw fuq l-estetika tal-bidu b’kost aktar baxx. Imbagħad iżżid 5 sekondi ta’ żvilupp permezz ta’ POST /v1/videos/extensions, u mbagħad 4 sekondi ta’ konklużjoni permezz ta’ sejħa t-tieni għall-istess endpoint. Ir-riżultat huwa video ta’ 12-il sekonda mibnija segment b’segment, fejn kull parti ġiet ivvalidata qabel ma nbidlet li jmiss—kontroll li l-ebda ġenerazzjoni waħda ta’ 12-il sekonda ma toffri.

Punti Ewlenin

  • L-estensjoni ttawwal video ta’ 2 sa 15-il sekonda b’segment ta’ 2 sa 10 sekondi (default 6), u tirritorna l-video sħiħa
  • Il-video sors tmur f’oġġett video (url jew file_id), bħall-editjar; l-SDK tal-Python jieħdu bħala video_url
  • Il-katina tippermetti l-ħolqien ta’ sekwenzi twajjen pass pass
  • Il-koerenza tiddeterjora wara 3-4 estensjonijiet suċċessivi
  • Għaqqad il-ġenerazzjoni inizjali + estensjonijiet għal kontroll preċiż tal-kontenut