Pāriet uz galveno saturu
Latviešu— Izvēlēties valodu
Izvēlne

Pagarināt video ar /v1/videos/extensions

Nodarbība 8 no 12 Atjaunota 2026. gada 2. novembris Vidējs
Šajā lapā
  1. Esoša video pagarināšana
  2. POST /v1/videos/extensions galapunkts
  3. Trīs veidi, kā turpināt scēnu
  4. Pagarinājumu ķēdēšana secības veidošanai
  5. Ģenerēšanas un pēc tam pagarināšanas duets
  6. Galvenās atziņas

Nodarbība atjaunināta 2026. gada 2. novembrī, pamatojoties uz xAI Video API dokumentāciju: pagarināšanas pieprasījumā video tiek saņemts video objektā ({"url": ...}), tieši tāpat kā rediģējot — iepriekšējais teksts apgalvoja pretējo — rezultāts tiek nolasīts no video.url, un avota garums ir ierobežots līdz 15 sekundēm. Avoti: Video Extension · Video Reference.

Esoša video pagarināšana

Ja rediģēšana pārveido secību, nemainot tās garumu, tad pagarināšana dara tieši pretējo: tā pagarina video, ģenerējot turpinājumu, kas ir saskaņots ar iepriekš redzēto. Tas atrisina visbiežāk sastopamo video ģenerēšanas problēmu — veiksmīgs klips ir par īsu vai scena ir pelnījusi attīstīties tālāk par sākotnējo ilgumu. Tā vietā, lai ģenerētu visu no jauna un cerētu atveidot to pašu izskatu, tu sāc no esošā un turpini.

POST /v1/videos/extensions galapunkts

Pieprasījums atgādina ģenerēšanas pieprasījumu, tikai tam tiek pievienots sākuma video.

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

Lauks model paliek grok-imagine-video, prompt apraksta, kam jānotiek turpinājumā, video objekts norāda video, ko pagarināt (tas var būt url vai augšupielādēta faila file_id, avota ilgumam esot no 2 līdz 15 sekundēm), bet duration nosaka pagarinājuma garumu no 2 līdz 10 sekundēm — noklusējums ir 6 sekundes. Atšķirībā no rediģēšanas, šeit tu atgūsti kontroli pār ilgumu. Atgrieztais video satur oriģinālu, kam seko pagarinājums: 10 sekunžu avots, pagarināts par 5 sekundēm, rezultējas 15 sekunžu video.

Zemāk esošajā tabulā apkopotas atšķirības starp abiem galapunktiem, jo neskaidrības rodas bieži.

AspektsRediģēšana (/edits)Pagarināšana (/extensions)
MērķisSaturā izmaiņasIlguma pievienošana
Video parametrsvideo objekts (url vai file_id)video objekts (url vai file_id)
Avota ilgumsMaks. 8,7 s2 līdz 15 s
Izvades ilgumsTāds pats kā avotam (Maks. 720p)Avots + 2 līdz 10 s
Oriģinālais satursTiek modificētsTiek saglabāts

Abi REST API galapunkti saņem video vienādi — video objektā ar url īpašību. Tomēr Python SDK to pieņem kā video_url parametru: nekopē šo parametra nosaukumu JSON ķermenī, jo API to neatpazīs. To, kas patiesībā atšķir abus galapunktus, nosaka ilgums.

Trīs veidi, kā turpināt scēnu

Vienkāršākais gadījums ir ļaut notiekošajam turpināties. Prompta turpina pašreizējo darbību un pagarina to bez pārtraukuma.

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

Tu vari arī ieviest izmaiņas, proti, pievienot jaunu elementu vai mainīt skata virzienu. Tas nodrošina secības naratīvo attīstību.

{
  "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šais lietojuma gadījums ir noslēgums: īss pagarinājums, kas tīri noslēdz secību, bieži vien ar izbalēšanu.

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

Pagarinājumu ķēdēšana secības veidošanai

Nekas neliedz video pagarināt vairākas reizes pēc kārtas. Katrs pagarinājums rada jaunu video, kura URL var kalpot kā avots nākamajam pagarinājumam, ļaujot veidot garu secību, izmantojot secīgus segmentus, no kuriem katru virza savs prompta. Zemāk esošais skripts ķēdē trīs pagarinājumus, katrā solī atkārtoti ievadot iegūto 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}")

Šai eleganci ir sava cena, gan burtiskā, gan pārnestā nozīmē. Katrs pagarinājums tiek apmaksāts atsevišķi. Avots nedrīkst pārsniegt 15 sekundes, kas ierobežo ķēdi: sākot no 5 sekundēm, secība sasniedz 20 sekundes pēc trim 5 sekunžu pagarinājumiem, un ceturtais tiks noraidīts. Vizuālā koherence pasliktinās, ejot cauri posmiem, jo katrs solis balstās uz jau interpretētu izvadi: aiz trim vai četriem ķēdētiem pagarinājumiem kļūst redzamas krāsu un morfoloģijas novirzes. Un tāpat kā visur šajā API, URL ir pagaidu — lejupielādē katru starpposma versiju, pretējā gadījumā kļūme ķēdes beigās liks tev sākt visu no jauna.

Ģenerēšanas un pēc tam pagarināšanas duets

Visizplatītākais ražošanas modelis apvieno abus galapunktus. Vispirms tu ģenerē īsu 3 sekunžu bāzi ar ļoti precīzu promptu, izmantojot POST /v1/videos/generations, kas ļauj iterēt uz sākuma estētiku ar mazākām izmaksām. Pēc tam tu pievieno 5 sekunžu attīstību, izmantojot POST /v1/videos/extensions, un tad 4 sekunžu noslēgumu, veicot otro izsaukumu tam pašam galapunktam. Rezultāts ir 12 sekunžu video, kas veidots pa segmentiem, kur katra daļa tika apstiprināta pirms nākamās uzsākšanas — kontrole, ko neviena viena 12 sekunžu ģenerēšana nepiedāvātu.

Galvenās atziņas

  • Pagarināšana pagarina 2 līdz 15 sekunžu video par 2 līdz 10 sekunžu segmentu (noklusējums 6) un atgriež pilnu video
  • Avota video tiek ievietots video objektā (url vai file_id), tāpat kā rediģējot; Python SDK to pieņem kā video_url
  • Ķēdēšana ļauj soli pa solim veidot garas secības
  • Koherence pasliktinās pēc 3–4 secīgiem pagarinājumiem
  • Apvieno sākotnējo ģenerēšanu ar pagarinājumiem, lai iegūtu precīzu satura kontroli