Vai al contenuto principale
Italiano— Scegli una lingua
Menu

Estensione video con /v1/videos/extensions

Lezione 8 di 12 Aggiornata il 2 novembre 2026 Intermedio
In questa pagina
  1. Estendere un video esistente
  2. L’endpoint POST /v1/videos/extensions
  3. Tre modi per continuare una scena
  4. Concatenare le estensioni per costruire una sequenza
  5. Il duo generazione poi estensione
  6. Punti chiave

Lezione aggiornata il 2 novembre 2026 in base al riferimento API Video di xAI: l’estensione riceve il video in un oggetto video ({"url": ...}), esattamente come per la modifica—il testo precedente affermava il contrario—il risultato si legge da video.url e la sorgente è limitata a 15 secondi. Fonti: Estensione video · Riferimento video.

Estendere un video esistente

Mentre la modifica trasforma una sequenza senza cambiarne la durata, l’estensione fa esattamente l’opposto: allunga un video generando una continuazione coerente con quanto precede. Questo risolve il problema più comune nella generazione video: un clip riuscito ma troppo breve, o una scena che merita di svilupparsi oltre la sua durata iniziale. Invece di rigenerare tutto sperando di ricreare lo stesso stile, parti da ciò che esiste e continui.

L’endpoint POST /v1/videos/extensions

La richiesta assomiglia a quella di generazione, con l’aggiunta del video di partenza.

{
  "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 campo model rimane grok-imagine-video, prompt descrive cosa deve accadere nella continuazione, l’oggetto video specifica il video da estendere (un url o il file_id di un file caricato, per una sorgente da 2 a 15 secondi) e duration imposta la lunghezza dell’estensione tra 2 e 10 secondi—il default è 6 secondi. A differenza della modifica, qui riprendi il controllo sulla durata. Il video restituito contiene l’originale seguito dall’estensione: una sorgente di 10 secondi estesa di 5 secondi produce un video di 15 secondi.

La tabella seguente riassume cosa distingue i due endpoint, dato che la confusione è comune.

AspettoModifica (/edits)Estensione (/extensions)
ObiettivoModificare il contenutoAggiungere durata
Parametro videoOggetto video (url o file_id)Oggetto video (url o file_id)
Durata sorgenteMax 8,7 sDa 2 a 15 s
Durata outputUguale alla sorgente (Max 720p)Sorgente + da 2 a 10 s
Contenuto originaleModificaPreserva

Entrambi gli endpoint REST API ricevono il video allo stesso modo, in un oggetto video con una proprietà url. L’SDK Python, invece, lo accetta come parametro video_url: non copiare questo nome di parametro in un corpo JSON, l’API non lo riconoscerà. Ciò che distingue davvero i due endpoint è la durata.

Tre modi per continuare una scena

Il caso più semplice consiste nel lasciare che ciò che sta già accadendo continui. Il prompt riprende l’azione corrente e la estende senza interruzioni.

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

Puoi anche introdurre un cambiamento, ovvero inserire un nuovo elemento o modificare la direzione dello sguardo. Questo conferisce alla sequenza una progressione narrativa.

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

Terzo caso d’uso: la conclusione. Una breve estensione che chiude la sequenza in modo pulito, spesso con una 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
}

Concatenare le estensioni per costruire una sequenza

Nulla vieta di estendere un video più volte di seguito. Ogni estensione produce un nuovo video il cui URL può servire da sorgente per l’estensione successiva, permettendoti di costruire una lunga sequenza tramite segmenti successivi, ciascuno guidato dal proprio prompt. Lo script seguente concatena tre estensioni reiniettando l’URL ottenuto a ogni passo.

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

Questa eleganza ha un prezzo, letteralmente e figurativamente. Ogni estensione viene fatturata separatamente. La sorgente non può superare i 15 secondi, il che limita la catena: partendo da 5 secondi, la sequenza raggiunge i 20 secondi dopo tre estensioni da 5 secondi, e una quarta verrebbe rifiutata. La coerenza visiva si degrada attraverso i collegamenti, poiché ogni passo si basa su un output già interpretato: oltre tre o quattro estensioni concatenate, diventano visibili derive di colore e morfologia. E come ovunque in questa API, gli URL sono temporanei: scarica ogni versione intermedia, altrimenti un fallimento alla fine della catena ti costringerà a ricominciare dall’inizio.

Il duo generazione poi estensione

Il pattern più comune in produzione combina entrambi gli endpoint. Generi prima una base breve di 3 secondi con un prompt molto preciso, tramite POST /v1/videos/generations, permettendoti di iterare sull’estetica di partenza a costo ridotto. Aggiungi poi 5 secondi di sviluppo tramite POST /v1/videos/extensions, quindi 4 secondi di conclusione tramite una seconda chiamata allo stesso endpoint. Il risultato è un video di 12 secondi costruito segmento per segmento, dove ogni parte è stata validata prima di impegnare la successiva: un controllo che nessuna singola generazione di 12 secondi potrebbe offrire.

Punti chiave

  • L’estensione allunga un video da 2 a 15 secondi con un segmento da 2 a 10 secondi (default 6) e restituisce il video completo
  • Il video sorgente va in un oggetto video (url o file_id), come per la modifica; l’SDK Python lo accetta come video_url
  • La concatenazione permette di creare lunghe sequenze passo dopo passo
  • La coerenza si degrada oltre 3-4 estensioni successive
  • Combina generazione iniziale + estensioni per un controllo preciso del contenuto