Vai al contenuto principale
Italiano— Scegli una lingua
Menu

Montaggio video con /v1/videos/edits

Lezione 7 di 12 Aggiornata il 3 novembre 2026 Intermedio
In questa pagina
  1. Modificare un video esistente
  2. L’endpoint POST /v1/videos/edits
  3. Cosa chiedere in un montaggio
  4. Il ciclo asincrono, identico alla generazione
  5. Dichiara cosa cambia e cosa resta
  6. Punti chiave

Aggiornato il 3 novembre 2026. Basato sulla pagina Video Editing di xAI: il video sorgente è lungo al massimo 8,7 secondi, l’output ne mantiene la durata, il rapporto d’aspetto e la risoluzione (max 720p), e l’estensione utilizza lo stesso oggetto video del montaggio. L’affermazione precedente secondo cui il montaggio era inaffidabile per elementi specifici contraddice gli esempi di xAI, che si concentrano proprio su modifiche precise. Fonti: Video Editing · Video Overview.

Modificare un video esistente

La generazione è solo una parte del lavoro. L’API di xAI espone anche un endpoint di montaggio video che prende una sequenza esistente e la modifica basandosi su prompt testuali. È l’equivalente video del fotoritocco, ma con vincoli di formato più severi. Prima di scrivere la tua prima richiesta, prendi nota dei quattro limiti che determinano cosa puoi inviare.

8,7 s
Durata massima sorgente
720p
Risoluzione massima
H.265
Codec accettati (come H.264, AV1)
MP4
Formato richiesto

L’endpoint POST /v1/videos/edits

La richiesta abbina un video sorgente a un prompt che descrive la modifica desiderata.

{
  "model": "grok-imagine-video",
  "prompt": "Cambia lo sfondo con un tramonto sull'oceano",
  "video": {
    "url": "https://example.com/original-video.mp4"
  }
}

Tre campi sono sufficienti: model, che rimane grok-imagine-video; prompt, che contiene la descrizione della modifica; e video.url, che punta al file MP4 da elaborare. Nota che il video è incapsulato in un oggetto video, che accetta un url o il file_id di un file caricato: l’endpoint di estensione, nella prossima lezione, adotta la stessa convenzione.

I vincoli tecnici sono qui più severi rispetto alla generazione. La sorgente non deve superare gli 8,7 secondi e il video prodotto ne mantiene la durata; la pagina Video Generation menziona una durata “limitata a 8,7 secondi” senza dettagliare la gestione di una sorgente più lunga: quindi ritaglia le tue sorgenti in anticipo. La risoluzione è limitata a 720p. Il file di input deve essere un MP4 con un codec supportato, come H.264, H.265 o AV1. Il punto più confuso per chi proviene dalla generazione: non hai alcun controllo sulla durata, sul rapporto d’aspetto o sulla risoluzione dell’output, tutti determinati dal video sorgente. La richiesta di montaggio non include alcun campo duration, aspect_ratio o resolution.

Cosa chiedere in un montaggio

La sostituzione dello sfondo è il caso da manuale: il soggetto resta, l’ambientazione cambia.

{
  "model": "grok-imagine-video",
  "prompt": "Sostituisci lo sfondo con un paesaggio spaziale con stelle e nebulose. Mantieni lo stesso soggetto e lo stesso movimento.",
  "video": {"url": "https://example.com/video.mp4"}
}

I cambiamenti di stile influenzano l’intera immagine e trasformano lo stile della clip senza modificarne l’azione: pratico per adattare la stessa sequenza in universi diversi.

{
  "model": "grok-imagine-video",
  "prompt": "Trasforma questo video in uno stile cartone animato giapponese con colori vivaci",
  "video": {"url": "https://example.com/video.mp4"}
}

L’aggiunta di elementi arricchisce la scena con strati che non esistevano durante le riprese, solitamente atmosferici.

{
  "model": "grok-imagine-video",
  "prompt": "Aggiungi neve che cade e un effetto gelo sui bordi",
  "video": {"url": "https://example.com/video.mp4"}
}

Infine, la modifica dell’illuminazione equivale a un regrading della sequenza: stesse inquadrature, atmosfera radicalmente diversa.

{
  "model": "grok-imagine-video",
  "prompt": "Cambia l'illuminazione in un'atmosfera notturna con luci al neon blu e viola",
  "video": {"url": "https://example.com/video.mp4"}
}

Il ciclo asincrono, identico alla generazione

Il montaggio segue esattamente lo stesso protocollo in quattro fasi della generazione: invii la richiesta, ricevi un request_id, interroghi periodicamente GET /v1/videos/{request_id} e recuperi il video modificato quando lo stato cambia in done. In Python, i primi due passi stanno in poche righe.

import httpx

# 1. Invia il montaggio
response = httpx.post(
    "https://api.x.ai/v1/videos/edits",
    headers={"Authorization": f"Bearer {api_key}"},
    json={
        "model": "grok-imagine-video",
        "prompt": "Aggiungi un effetto pioggia su tutta la scena",
        "video": {"url": "https://example.com/source.mp4"}
    }
)
request_id = response.json()["request_id"]

# 2. Interroga lo stato (semplificato)
status = httpx.get(
    f"https://api.x.ai/v1/videos/{request_id}",
    headers={"Authorization": f"Bearer {api_key}"}
).json()

Dichiara cosa cambia e cosa resta

xAI descrive il comportamento del modello in una frase: grok-imagine-video applica la modifica richiesta e mantiene tutto il resto il più vicino possibile alla sorgente. La sua documentazione ne deriva una linea guida: dì anche cosa deve rimanere identico. I suoi stessi esempi si concentrano su modifiche precise di una singola clip: aggiungere una collana d’argento, cambiare un outfit in rosso, mettere un cappello nero a tesa larga a un personaggio, eseguiti in parallelo sulla stessa sorgente.

{
  "model": "grok-imagine-video",
  "prompt": "Cambia la giacca della donna in rosso. Mantieni lo stesso viso, la stessa ambientazione, la stessa inquadratura e lo stesso movimento.",
  "video": {"url": "https://example.com/video.mp4"}
}

La guida ai prompt per immagini di xAI, scritta per immagini fisse, specifica l’ordine che funziona: prima la modifica, poi una frase che blocca ciò che resta statico. Un montaggio che inizia con “mantieni tutto” non cambia quasi nulla, e un montaggio che copia un prompt di generazione completo reinventa la scena.

Quattro abitudini evitano la maggior parte delle insidie: mantieni le tue sorgenti sotto gli 8,7 secondi, in un codec supportato (H.264, H.265 o AV1); nomina ciò che deve rimanere intatto; testa una modifica su una clip breve prima di scalarla; e ricorda che il montaggio usa grok-imagine-video, la cui griglia tariffaria mostra un’unica tariffa, 0,050 $ al secondo: una serie di prove costa quanto la generazione.

Punti chiave

  • L’endpoint POST /v1/videos/edits modifica un video esistente basandosi su un prompt, utilizzando solo grok-imagine-video
  • La sorgente dura al massimo 8,7 secondi; l’output ne mantiene durata, rapporto e risoluzione (max 720p)
  • Il video sorgente deve essere un MP4 con un codec supportato (H.264, H.265, AV1)
  • La richiesta non ha alcun campo duration, aspect_ratio o resolution
  • Dì cosa deve cambiare, poi cosa deve rimanere identico