Introduzione
Invia video_url, un’istruzione di modifica mirata e la risoluzione di output. Il modello rielabora le riprese esistenti senza impostazioni di durata o proporzioni.
| Campo | Valore |
|---|---|
| Input | Video |
| Output | Video |
| Editore | |
| Disponibilità nella Gemini API | Disponibile per tutti dal 5 novembre 2026, secondo Google |
| Codice del modello | gemini-omni-1.2-flash |
| Durata della generazione | 3–15 secondi interi; 8 secondi come valore predefinito |
| Durata con fotogramma finale | 3–10 secondi se fornisci un’immagine finale |
| Tempi della modifica | Segue la durata del video originale; le riprese oltre 10 secondi vengono tagliate |
| Risoluzioni di output | Google indica 360p e 720p diretti; 1080p e 4K sono ottenuti per upscaling da Google |
| Formati di generazione | 16:9 o 9:16; 16:9 come valore predefinito |
| Formato video e audio | MP4 a 24 fps con una traccia audio AAC |
| Riferimenti in ingresso | Fino a 6 immagini; fino a 3 clip video di non più di 3 secondi ciascuna |
| Output lunghi da riferimenti | Google indica un riferimento video per output da 11–15 secondi |
| Filigrana | Google inserisce una filigrana SynthID invisibile |
| Conservazione dei video generati | Eliminati dopo 14 giorni |
Caratteristiche principali
Un momento al mercato con il suo audio
Nei nostri test, la scena al mercato di 6 secondi a 720p mostrava un cuoco che saltava i noodles in un wok in fiamme e pronunciava la battuta richiesta. Lo sfrigolio dell’olio, la pioggia e il brusio del mercato accompagnavano l’azione.
Metti in moto la partenza di una barca
L’esempio al pontile dura 5 secondi e parte da una singola foto notturna. Nei nostri test, il motoscafo in legno si allontanava lentamente dall’hotel mentre la passeggera salutava, con il ronzio del motore, l’acqua e una band in lontananza.
Decidi dove termina il movimento
Un’immagine iniziale in studio e una posa finale guidano questa animazione di 5 secondi. Nei nostri test, la ballerina passava da una posa all’altra con un sottofondo di piano delicato e la camera fissa.
Porta due persone in una scena in treno
Nei nostri test, due ritratti di riferimento sono diventati una scena di 6 secondi in un vagone ristorante. Un viaggiatore passava un biglietto piegato sul tavolo; l’altra lo leggeva e sorrideva, con il ritmo del treno e i rumori delle posate.
Sposta l’esibizione su un palco in riva al lago
Nei nostri test, la modifica ha sostituito lo studio grigio con un palco illuminato dalla luna accanto all’acqua velata di foschia. La ballerina e i suoi movimenti sono rimasti nella scena mentre cambiava l’ambientazione.
Parametri della richiesta
| Parametro | Obbligatorio | Nota |
|---|---|---|
prompt | Sì | Breve istruzione obbligatoria che descrive il cambiamento visivo. Google consiglia una formulazione semplice che termini con «Mantieni tutto il resto uguale». almeno 1 caratteri · al massimo 20000 caratteri |
video_url | Sì | URL obbligatorio della clip originale. L’output segue la durata dell’originale; i video oltre 10 secondi vengono tagliati a 10 secondi. almeno 1 caratteri |
resolution | No | Usa 360p, 720p predefinito, 1080p o 4K. Google indica 360p/720p come output diretto; 1080p e 4K sono ottenuti per upscaling da Google e costano di più. |
Prezzi
La modifica addebita i secondi dell’originale arrotondati per eccesso, con un minimo di 3 e un massimo di 10 secondi. La risoluzione determina la tariffa; quella di modifica è superiore a quella di generazione. Gli originali oltre 10 secondi vengono tagliati a 10 secondi. Le modifiche fallite o rifiutate non comportano addebiti.
| Specifiche | Prezzo |
|---|---|
| $0.0576 / secondo |
| $0.1248 / secondo |
| $0.1752 / secondo |
| $0.3264 / secondo |
Casi d’uso
Una scena al mercato con una battuta
Delinea un cuoco, un’azione e una breve battuta tra virgolette, poi richiedi lo sfrigolio dell’olio e l’atmosfera piovosa del mercato.
Un arrivo o una partenza dall’hotel
Anima un’immagine iniziale del pontile con la partenza di una barca, oppure aggiungi un’immagine finale se hai già deciso la composizione conclusiva.
Una scena con personaggi ricorrenti
Usa ritratti di riferimento per inserire due persone già definite in una nuova ambientazione, come un vagone ristorante al crepuscolo.
Un palco diverso per un’esibizione
Chiedi alla modalità di modifica video di trasformare lo studio in un’ambientazione sul lago mantenendo il movimento registrato.
Consigli avanzati
Scegli l’endpoint in base al materiale di partenza
Parti dal testo per una scena nuova, da una foto iniziale per un’animazione, da riferimenti per una guida visiva o da un video per una modifica mirata.
Chiarisci la struttura della scena
Google segnala che il modello può creare più inquadrature per impostazione predefinita. Aggiungi «nessun taglio di scena» se vuoi una sola ripresa e metti tra virgolette le battute richieste.
Assegna un compito a ogni riferimento
Scrivi «usa il luogo in Image 2» o «muoviti come in Video 1», così il prompt spiega il ruolo di ogni file caricato.
Valuta una bozza prima di aumentare la risoluzione
Usa il 360p per esplorare un’idea alla tariffa più bassa disponibile. Google ottiene 1080p e 4K per upscaling e queste opzioni costano di più.
Concentra l’istruzione su una modifica
Google consiglia modifiche semplici seguite da «Mantieni tutto il resto uguale». Controlla la durata dell’originale prima di inviarlo: la modifica taglia le riprese a 10 secondi.
Introduzione
La modalità di modifica video di Gemini Omni 1.2 Flash parte da riprese che hai già. Fornisci video_url, un prompt obbligatorio e una risoluzione di output. Nei nostri test, trasformare uno studio grigio in un palco in riva al lago illuminato dalla luna ha mantenuto la ballerina e i movimenti, sostituendo l’ambientazione.
La modifica segue i tempi dell’originale, eliminando le riprese oltre 10 secondi. Nei nostri test, un originale di 12 secondi ha prodotto un risultato di 10.03 secondi. Per la modifica non esistono campi di durata o proporzioni. L’addebito arrotonda i secondi dell’originale per eccesso, con un minimo di tre e un massimo di dieci; la risoluzione scelta determina una tariffa di modifica superiore a quella di generazione.
Funzioni e caratteristiche principali
- Applica un cambiamento visivo scritto a un video esistente, invece di generare da una foto.
- Segui la durata dell’originale, con un taglio a 10 secondi per riprese più lunghe.
- Seleziona output diretto a 360p o 720p, oppure upscaling 1080p/4K di Google a una tariffa superiore.
- Ricevi un risultato MP4 a 24 fps con una traccia audio AAC.
- Mantieni la richiesta mirata seguendo il consiglio di Google di preservare tutto ciò che esula dalla modifica.
Casi d’uso
- Sostituisci uno studio prove grigio con un palco in riva al lago illuminato dalla luna.
- Valuta una variante dell’ambientazione con foschia chiedendo di conservare il movimento di danza registrato.
- Prova un ambiente visivo diverso per una breve esibizione esistente prima di scegliere la versione.
Guida al prompt e consigli pratici
- Parti da un solo cambiamento, come «trasforma lo studio in un palco in riva al lago», seguendo le indicazioni di Google sui prompt di modifica semplici.
- Descrivi una qualità visiva precisa, come «una lieve foschia sull’acqua», per dare una direzione chiara alla nuova ambientazione.
- Usa la conclusione suggerita da Google «Mantieni tutto il resto uguale» per delimitare la modifica richiesta.
- Indica un elemento da conservare, come «mantieni il movimento originale», per valutare se l’esibizione è stata preservata.
- Prepara il segmento desiderato prima del caricamento; con un’indicazione come «illumina questa scena con la luce della luna», i contenuti dopo i primi 10 secondi verranno tagliati.
Avvio rapido dell’API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "google/gemini-omni-1.2-flash/video-edit",
"input": {
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "720p",
"video_url": "https://example.com/reference.mp4"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
Nel riferimento dell’API trovi autenticazione, schema completo, polling e gestione degli errori.
