Estensione video con /v1/videos/extensions
In questa pagina
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 davideo.urle 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.
| Aspetto | Modifica (/edits) | Estensione (/extensions) |
|---|---|---|
| Obiettivo | Modificare il contenuto | Aggiungere durata |
| Parametro video | Oggetto video (url o file_id) | Oggetto video (url o file_id) |
| Durata sorgente | Max 8,7 s | Da 2 a 15 s |
| Durata output | Uguale alla sorgente (Max 720p) | Sorgente + da 2 a 10 s |
| Contenuto originale | Modifica | Preserva |
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(urlofile_id), come per la modifica; l’SDK Python lo accetta comevideo_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