Spring til hovedindhold
Dansk— Vælg et sprog
Menu

Videoudvidelse med /v1/videos/extensions

Lektion 8 af 12 Opdateret 2. november 2026 Mellem
På denne side
  1. Udvidelse af en eksisterende video
  2. POST /v1/videos/extensions-endpointen
  3. Tre måder at fortsætte en scene på
  4. Kædning af udvidelser for at opbygge en sekvens
  5. Duoen generation efterfulgt af udvidelse
  6. Vigtige pointer

Lektionen opdateret 2. november 2026 baseret på xAI Video API-referencen: udvidelsen modtager videoen i et video-objekt ({"url": ...}), præcis som ved redigering – den tidligere tekst påstod det modsatte – resultatet læses fra video.url, og kilden er begrænset til 15 sekunder. Kilder: Video Extension · Video Reference.

Udvidelse af en eksisterende video

Hvor redigering transformerer en sekvens uden at ændre dens længde, gør udvidelse det stik modsatte: den forlænger en video ved at generere en fortsættelse, der er konsistent med det, der gik forud. Dette løser det mest almindelige problem ved videogenerering – et vellykket klip, der er for kort, eller en scene, der fortjener at udvikle sig ud over sin oprindelige varighed. I stedet for at regenerere alt og håbe på at genskabe samme udtryk, tager du udgangspunkt i det eksisterende og fortsætter derfra.

POST /v1/videos/extensions-endpointen

Anmodningen ligner en generationsanmodning, blot med startvideoen tilføjet.

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

Feltet model forbliver grok-imagine-video, prompt beskriver, hvad der skal ske i fortsættelsen, video-objektet specificerer videoen, der skal udvides (en url eller file_id for en uploadet fil, for en kilde på 2 til 15 sekunder), og duration sætter udvidelsens længde mellem 2 og 10 sekunder – standarden er 6 sekunder. I modsætning til redigering får du her kontrol over varigheden igen. Den returnerede video indeholder originalen efterfulgt af udvidelsen: en 10-sekunders kilde udvidet med 5 sekunder giver en 15-sekunders video.

Følgende tabel opsummerer, hvad der adskiller de to endpoints, da forvirring er almindelig.

AspektRedigering (/edits)Udvidelse (/extensions)
MålÆndre indholdTilføje varighed
Videoparametervideo-objekt (url eller file_id)video-objekt (url eller file_id)
KildevarighedMaks. 8,7 s2 til 15 s
Output-varighedSamme som kilde (Maks. 720p)Kilde + 2 til 10 s
Originalt indholdÆndrerBevarer

Begge REST API-endpoints modtager videoen på samme måde, i et video-objekt med en url-egenskab. Python SDK’en tager den dog som parameteren video_url: kopier ikke dette parameternavn ind i en JSON-body, da API’en ikke vil genkende det. Det, der virkelig adskiller de to endpoints, er varigheden.

Tre måder at fortsætte en scene på

Det enkleste tilfælde består i at lade det, der allerede sker, fortsætte. Promptet griber den aktuelle handling og udvider den uden afbrydelse.

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

Du kan også introducere en ændring, hvilket betyder at bringe et nyt element ind eller modificere synsvinklen. Dette giver en sekvens dens narrative fremdrift.

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

Tredje brugstilfælde er konklusionen: en kort udvidelse, der afslutter sekvensen rent, ofte med en udtoning.

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

Kædning af udvidelser for at opbygge en sekvens

Intet forhindrer dig i at udvide en video flere gange i træk. Hver udvidelse producerer en ny video, hvis URL kan tjene som kilde til den næste udvidelse, så du kan opbygge en lang sekvens via successive segmenter, hvor hver drives af sit eget prompt. Scriptet nedenfor kæder tre udvidelser ved at genindsætte den opnåede URL ved hvert trin.

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

Denne elegance har en pris, både bogstaveligt og overført. Hver udvidelse faktureres separat. Kilden må ikke overstige 15 sekunder, hvilket begrænser kæden: starter du med 5 sekunder, når sekvensen 20 sekunder efter tre 5-sekunders udvidelser, og en fjerde vil blive afvist. Visuel koherens forringes på tværs af leddene, da hvert trin hviler på et allerede fortolket output: ud over tre eller fire kædede udvidelser bliver farve- og morfologidrift synlig. Og som overalt i denne API er URLs midlertidige – download hver mellemliggende version, ellers vil en fejl i slutningen af kæden tvinge dig til at starte forfra fra begyndelsen.

Duoen generation efterfulgt af udvidelse

Det mest almindelige mønster i produktion kombinerer begge endpoints. Du genererer først en kort base på 3 sekunder med et meget præcist prompt via POST /v1/videos/generations, hvilket giver dig mulighed for at iterere på startæstetikken til en lavere omkostning. Derefter tilføjer du 5 sekunders udvikling via POST /v1/videos/extensions og derefter 4 sekunders konklusion via et andet kald til samme endpoint. Resultatet er en 12-sekunders video bygget segment for segment, hvor hver del blev valideret, før den næste blev påbegyndt – en kontrol, som ingen enkelt 12-sekunders generation ville kunne tilbyde.

Vigtige pointer

  • Udvidelse forlænger en video på 2 til 15 sekunder med et segment på 2 til 10 sekunder (standard 6) og returnerer den komplette video
  • Kildevideoen placeres i et video-objekt (url eller file_id), ligesom ved redigering; Python SDK’en tager den som video_url
  • Kædning muliggør oprettelse af lange sekvenser trin for trin
  • Koherensen forringes efter 3-4 successive udvidelser
  • Kombiner indledende generation + udvidelser for præcis indholdskontrol