Vai al contenuto principale
Italiano— Scegli una lingua
Menu

Combinare montaggio ed estensione

Lezione 9 di 12 Aggiornata il 3 novembre 2026 Intermedio
In questa pagina
  1. Pipeline di produzione avanzate
  2. Pipeline 1: Uno spot prodotto di 15 secondi
  3. Pipeline 2: Cinque contenuti, uno stile
  4. Pipeline 3: Derivare varianti da un video
  5. Rendere una catena resistente ai guasti
  6. Punti chiave

Aggiornato il 2 novembre 2026. In base al riferimento API video di xAI: l’immagine sorgente va inserita in un oggetto image, mentre il video da modificare o estendere va in un oggetto video ({"url": ...}), sia per l’estensione che per il montaggio. Fonti: Estensione video · Riferimento Video.

Pipeline di produzione avanzate

Usati singolarmente, ogni endpoint ha dei limiti: la generazione si ferma a 15 secondi, il montaggio a 8,7 secondi di sorgente e l’estensione a 10 secondi aggiunti. Combinandoli, crei pipeline di produzione che superano di gran lunga questi limiti e, cosa cruciale, ti offrono un punto di controllo dopo ogni segmento. Questa lezione copre tre pipeline reali, dai clip prodotto alle variazioni stilistiche, e come renderle affidabili.

Pipeline 1: Uno spot prodotto di 15 secondi

Lo scenario è classico: hai una foto di uno smartphone e devi consegnare un video promozionale di 15 secondi. La pipeline si costruisce in tre segmenti da 5 secondi, ciascuno validato prima di passare al successivo.

Il primo segmento anima la foto del prodotto—rotazione, gioco di riflessi—tramite l’image-to-video studiato nella sezione precedente.

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

Il secondo estende questa inquadratura con un’estensione che avvicina la camera allo schermo, reiniettando l’URL ottenuto nel passaggio precedente.

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

Il terzo chiude la sequenza su un’inquadratura ampia, partendo questa volta dall’output del secondo segmento.

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

Quindici secondi di nuovo contenuto, a $0.05 al secondo con grok-imagine-video: aspettati circa $0.75 escluse le iterazioni se ogni segmento viene fatturato per la sua durata. Il costo effettivo di ogni passo appare nel campo usage.cost_in_usd_ticks del suo risultato: verificalo su una pipeline di test prima di preventivare una serie.

Pipeline 2: Cinque contenuti, uno stile

Situazione diversa, logica diversa: devi produrre cinque video da 5 secondi per una campagna social con uno stile visivo coerente. Qui, non è la concatenazione a strutturare il lavoro, ma le immagini di riferimento, identiche per tutte le generazioni. I cinque prompt descrivono scene diverse; lo stile rimane coerente grazie agli stessi due visual.

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

Cinque clip da 5 secondi arrivano a $1.25. Nota il formato 9:16 applicato a tutte le richieste: per una campagna verticale, questo è il tipo di svista che costa una rigenerazione completa.

Pipeline 3: Derivare varianti da un video

Il terzo schema non concatena nulla: applica semplicemente diverse modifiche in parallelo allo stesso video sorgente. Ottieni così quattro versioni dello stesso clip, da proporre per test A/B o da distribuire su piattaforme con identità distinte.

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

Queste tre pipeline utilizzano quattro endpoint, riassunti qui sotto.

EndpointMetodoInputOutputDurata massima
/v1/videos/generationsPOSTPrompt + opzioniNuovo video1-15s
/v1/videos/editsPOSTVideo + promptVideo modificatoSorgente fino a 8,7s
/v1/videos/extensionsPOSTVideo + promptVideo esteso+2 a 10s, sorgente fino a 15s
/v1/videos/{id}GETrequest_idStato + URL-

Rendere una catena resistente ai guasti

Non appena concateni le operazioni, la probabilità che almeno una fallisca diventa significativa, e un fallimento al terzo anello fa perdere i primi due se non hai pianificato nulla. La funzione seguente incapsula ogni passo in un ciclo di retry e passa al successivo solo una volta ottenuto l’URL.

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

Attorno a questo scheletro, cinque abitudini fanno la differenza tra un prototipo e un servizio. Scarica il risultato a ogni passo, poiché gli URL sono temporanei e il recupero da un incidente richiede di avere le versioni intermedie. Valida visivamente ogni segmento prima di procedere al successivo, altrimenti paghi tre generazioni solo per scoprire che la prima non era adatta. Gestisci gli errori con tentativi spaziati da un backoff esponenziale. Calcola il budget completo prima di lanciare una catena lunga, contando le iterazioni probabili. E parallelizza ciò che puoi: nella pipeline 2 e nella pipeline 3, nessuna generazione dipende dall’altra, quindi possono essere eseguite simultaneamente.

Prezzi verificati il 3 novembre 2026 — i prezzi cambiano regolarmente: prima di qualsiasi calcolo di budget, controlla le tariffe attuali sulla pagina ufficiale dei modelli e prezzi xAI.

Punti chiave

  • I tre endpoint (generazione, montaggio, estensione) si combinano in pipeline
  • Le immagini di riferimento garantiscono la coerenza stilistica tra più video
  • Il montaggio iterativo permette di derivare un video in diverse versioni
  • Scarica i risultati intermedi e gestisci gli errori a ogni passo
  • Calcola il budget totale prima di lanciare pipeline complesse