Combineren van bewerking en uitbreiding
Op deze pagina
Bijgewerkt op 2 november 2026. Gebaseerd op de xAI video API-referentie: de bronafbeelding gaat in een
image-object en de video die moet worden bewerkt of uitgebreid gaat in eenvideo-object ({"url": ...}), zowel voor uitbreiding als voor bewerking. Bronnen: Video Extension · Videos Reference.
Geavanceerde productiepijplijnen
Afzonderlijk gebruikt heeft elk eindpunt zijn beperkingen: generatie stopt bij 15 seconden, bewerking bij 8,7 seconden bronmateriaal en uitbreiding bij 10 seconden toegevoegde tijd. Gecombineerd vormen ze productiepijplijnen die deze grenzen ruimschoots overschrijden en, cruciaal, u na elk segment een controlepunt bieden. Deze les behandelt drie pijplijnen uit de praktijk, van productclips tot stilistische variaties, en hoe u deze betrouwbaar maakt.
Pijplijn 1: Een productpromo van 15 seconden
Het scenario is klassiek: u heeft een smartphonefoto en moet een promovideo van 15 seconden leveren. De pijplijn bouwt drie segmenten van 5 seconden op, waarbij elk gevalideerd wordt voordat het volgende begint.
Het eerste segment animeert de productfoto—rotatie, spel van reflecties—via de image-to-video-functie die in de vorige sectie aan bod kwam.
{
"model": "grok-imagine-video",
"prompt": "Elegant rotation of the smartphone on a dark background, light reflections on the screen",
"image": {"url": "https://exemple.com/smartphone.jpg"},
"duration": 5,
"aspect_ratio": "16:9",
"resolution": "720p"
}
Het tweede breidt dit shot uit met een extensie die de camera dichter naar het scherm brengt, waarbij de URL die in de vorige stap is verkregen opnieuw wordt ingevoerd.
{
"model": "grok-imagine-video",
"prompt": "Progressive zoom towards the smartphone screen turning on, displaying a colorful interface",
"video": {"url": "{url_video_etape_1}"},
"duration": 5
}
Het derde sluit de sequentie af met een wijd shot, dit keer startend vanuit de output van het tweede segment.
{
"model": "grok-imagine-video",
"prompt": "Zoom out revealing the smartphone placed on a design desk, soft light, slight background blur",
"video": {"url": "{url_video_etape_2}"},
"duration": 5
}
Vijftien seconden nieuwe content, tegen $0,05 per seconde met grok-imagine-video: reken op ongeveer $0,75 exclusief iteraties als elk segment op basis van zijn duur wordt gefactureerd. De werkelijke kosten van elke stap verschijnen in het veld usage.cost_in_usd_ticks van het resultaat: verifieer dit op een testpijplijn voordat u een reeks begroot.
Pijplijn 2: Vijf contentstukken, één stijl
Andere situatie, andere logica: u moet vijf video’s van 5 seconden produceren voor een sociale campagnemet een consistente visuele stijl. Hier structureert ketening het werk niet; referentieafbeeldingen doen dat, identiek voor alle generaties. De vijf prompts beschrijven verschillende scènes; de stijl blijft consistent dankzij dezelfde twee visuals.
references = [
{"url": "https://exemple.com/style-campagne-1.jpg"},
{"url": "https://exemple.com/style-campagne-2.jpg"}
]
prompts = [
"Coffee pouring into a white ceramic cup, rising steam",
"Hands typing on a keyboard, blurred screen in background",
"An open notebook with a pen writing, natural light",
"A green plant growing in timelapse in a clay pot",
"A book whose pages turn in the wind on a terrace"
]
for prompt in prompts:
resp = httpx.post(
"https://api.x.ai/v1/videos/generations",
headers=headers,
json={
"model": "grok-imagine-video",
"prompt": prompt,
"reference_images": references,
"duration": 5,
"aspect_ratio": "9:16",
"resolution": "720p"
}
)
Vijf clips van 5 seconden komen uit op $1,25. Let op het 9:16-formaat dat op alle verzoeken wordt toegepast: voor een verticale campagne is dit het soort over het hoofd geziene detail dat een volledige regeneratie kost.
Pijplijn 3: Variaties afleiden van een video
Het derde schema ketent helemaal niets aan elkaar: het past meerdere verschillende bewerkingen parallel toe op dezelfde bronvideo. Zo verkrijgt u vier versies van dezelfde clip, om voor te stellen voor A/B-testen of om te distribueren over platforms met verschillende identiteiten.
video_source = "https://exemple.com/video-base.mp4"
variations = [
"Cinematic black and white style, film grain",
"Pop art saturated colors, strong contrasts",
"Night ambiance, purple and blue neon lights",
"Watercolor style, soft outlines and washed colors"
]
for variation in variations:
resp = httpx.post(
"https://api.x.ai/v1/videos/edits",
headers=headers,
json={
"model": "grok-imagine-video",
"prompt": variation,
"video": {"url": video_source}
}
)
Deze drie pijplijnen gebruiken vier eindpunten, hieronder samengevat.
| Endpoint | Method | Input | Output | Max duration |
|---|---|---|---|---|
/v1/videos/generations | POST | Prompt + options | New video | 1-15s |
/v1/videos/edits | POST | Video + prompt | Modified video | Source up to 8.7s |
/v1/videos/extensions | POST | Video + prompt | Extended video | +2 to 10s, source up to 15s |
/v1/videos/{id} | GET | request_id | Status + URL | - |
Een keten storingsbestendig maken
Zodra u bewerkingen aan elkaar koppelt, wordt de kans dat er minstens één mislukt aanzienlijk, en bij een mislukking op de derde schakel gaan de eerste twee verloren als er niets is gepland. De volgende functie kapselt elke stap in in een retry-lus en gaat pas naar de volgende stap zodra de URL is verkregen.
async def pipeline_with_retry(steps, max_retries=2):
video_url = None
for i, step in enumerate(steps):
for attempt in range(max_retries + 1):
try:
if step["type"] == "generation":
result = await generate_video(step["params"])
elif step["type"] == "extension":
step["params"]["video"] = {"url": video_url}
result = await extend_video(step["params"])
elif step["type"] == "edition":
step["params"]["video"] = {"url": video_url}
result = await edit_video(step["params"])
video_url = await wait_for_result(result["request_id"])
break
except Exception as e:
if attempt == max_retries:
raise Exception(f"Step {i+1} failed: {e}")
await asyncio.sleep(10)
return video_url
Rondom dit skelet maken vijf gewoonten het verschil tussen een prototype en een dienst. Download het resultaat bij elke stap, aangezien URLs tijdelijk zijn en herstel na een incident vereist dat u tussentijdse versies heeft. Valideer elk segment visueel voordat u doorgaat naar het volgende, anders betaalt u voor drie generaties om pas daarna te ontdekken dat de eerste niet geschikt was. Handel fouten af met pogingen die gescheiden zijn door exponentiële backoff. Bereken het volledige budget voordat u een lange keten start, waarbij u waarschijnlijke iteraties meetelt. En parallelleer wat u kunt: in pijplijn 2 en pijplijn 3 hangt geen enkele generatie af van een andere, dus deze kunnen gelijktijdig draaien.
Prijzen geverifieerd op 3 november 2026 — prijzen veranderen regelmatig: controleer voor elke budgetberekening de actuele tarieven op de officiële xAI-modellen en prijzenpagina.
Belangrijkste punten
- De drie eindpunten (generatie, bewerking, uitbreiding) combineren tot pijplijnen
- Referentieafbeeldingen zorgen voor stilistische consistentie over meerdere video’s
- Iteratieve bewerking maakt het mogelijk om van één video meerdere versies af te leiden
- Download tussentijdse resultaten en handel fouten bij elke stap af
- Bereken het totale budget voordat u complexe pijplijnen start