Google

Veo 3.1 Fast

veo-3.1-fast/image-to-video

Il modello di generazione video da immagine della serie Veo 3.1 pensato per una produzione rapida, con generazione sincronizzata di video e audio, ideale per la produzione di contenuti finiti come marketing, presentazioni e social media

veo-3.1-fast/image-to-video veo-3.1-fast/text-to-video

Prova veo-3.1-fast/image-to-video

Input

Creazioni

Vedi tutte le creazioni

Output

video

Compila i parametri e genera: i risultati appariranno qui.

Prezzi

veo-3.1-fast/image-to-video per second

Specifiche	720P	1080P	4K
Sound On	$0.250	$0.250	$0.600
Sound Off	$0.170	$0.170	$0.500

Panoramica della posizione

veo-3.1-fast/image-to-video è una linea di generazione video da immagine della serie Google Veo 3.1, richiamabile tramite l'interfaccia unificata di HiAPI.ai. Basta inserire un'immagine di riferimento e un prompt che descriva la scena per estendere un'immagine statica in un video finito con audio nativo. La risoluzione dell'immagine è selezionabile da 720p a 4k, con durate di 4, 6 e 8 secondi; i dettagli dei ritratti e l'aderenza al prompt sono i suoi principali ambiti d'uso, adatto a sviluppatori che necessitano di produrre rapidamente video finiti senza dover creare separatamente voci fuori campo ed effetti sonori, per brevi video di marketing, dimostrazioni e materiali per i social.

Punti di forza principali

Generazione di immagini e audio in un'unica soluzione — video e traccia audio nativa vengono prodotti nella stessa generazione, eliminando il passaggio intermedio di applicare strumenti separati per voci fuori campo ed effetti sonori.
Risoluzione e durata regolabili in base alle esigenze — l'output supporta tre livelli di risoluzione (720p, 1080p, 4k) e durate di 4, 6 e 8 secondi, con scelta flessibile in base alle specifiche del video e al budget.
Punto di partenza dell'immagine bloccato tramite immagine di riferimento — l'immagine inserita funge da base per il primo fotogramma, mentre il prompt descrive solo il movimento, rendendo più stabile l'aspetto del soggetto rispetto alla generazione da solo testo.

Descrizione delle capacità

Estensione video guidata da immagine: riceve un'immagine di riferimento in 16:9 o 9:16 e un prompt, convertendo la scena statica in un segmento in movimento; gli altri rapporti vengono adattati tramite ritaglio, e il rapporto d'aspetto può essere specificato manualmente o seguito dall'immagine di input.

Interruttore audio nativo: tramite il parametro generate_audio si decide se generare la traccia audio insieme al video, attivo per impostazione predefinita; se serve solo l'immagine per la post-produzione è possibile disattivarlo direttamente.

Vincolo tramite prompt negativo: è possibile compilare un negative_prompt che descriva i contenuti da evitare, per sopprimere elementi indesiderati nella scena.

Riproducibilità tramite seed: è disponibile il campo seed; fissando il seed è possibile ripetere la generazione con lo stesso input e lo stesso prompt, utile per debug e confronti.

Scenari applicativi

Team di marketing: immagine di prodotto + descrizione dei punti di forza — trasformare immagini di prodotti o scene in brevi video con effetti sonori, da usare direttamente per campagne a flusso, post sui social e immagini di testata delle landing page.
Creator di contenuti: immagine di persona o scena + testo narrativo — produrre materiali video con senso di narrazione, per la pubblicazione su piattaforme di short video o la produzione in serie di contenuti.
Presentazioni aziendali: schema + testo esplicativo — convertire le immagini statiche dei materiali di presentazione in segmenti dinamici, da inserire in slide o pagine di presentazione del sito per rafforzare l'espressione.
Creatori di materiali didattici: grafici o immagini dimostrative + descrizione esplicativa — generare segmenti esplicativi come integrazione visiva in corsi o materiali di formazione, riducendo i costi di ripresa e montaggio.

Limiti e consigli per la scelta

La durata massima di una singola generazione è di 8 secondi; per narrazioni più lunghe è necessario generare in segmenti e poi unirli, controllando separatamente la continuità visiva di ciascun segmento. Le immagini di riferimento devono essere di almeno 720p e fornite in 16:9 o 9:16, altrimenti verranno ritagliate. Durata e risoluzione influiscono sulla fatturazione; il 4k e l'attivazione della traccia audio rientrano nelle fasce di costo più elevate. Questi segmenti sono più adatti a contenuti di tipo video finito che a simulazioni fisiche o di movimento ad alta precisione; se la necessità è una rigorosa simulazione fisica o riprese continue di lunga durata, è opportuno considerare altri modelli o soluzioni.

Domande frequenti

Vedi tutte le domande →

Veo 3.1 Fast Image to Video richiede il caricamento di un'immagine?

Sì. Attualmente veo-3.1-fast/image-to-video è una pipeline image-to-video: l'immagine di input definisce il soggetto e la composizione iniziale, mentre il Prompt definisce le azioni, la telecamera e i cambiamenti dell'ambiente.
Quali durate e risoluzioni supporta Veo 3.1 Fast Image to Video?

L'attuale contratto di richiesta HiAPI supporta 4s / 6s / 8s, con risoluzioni di output 720p, 1080p, 4k. I valori disponibili sono quelli indicati nel pannello dei parametri della pagina e nella documentazione API.
Come viene addebitato Veo 3.1 Fast Image to Video?

Le attività vengono addebitate in base alla durata dell'output e al livello selezionato. La pagina mostra il prezzo in tempo reale seguendo l'unità monetaria globale; l'addebito effettivo fa fede al record delle attività completate con successo.
Come migliorare la stabilità del soggetto nella generazione di video da immagine?

Utilizza un'immagine di input con un soggetto chiaro, poche occlusioni e una composizione completa; nel Prompt descrivi prima l'azione principale e la ripresa, poi elenca l'aspetto, i materiali e le relazioni con lo sfondo che devono essere preservati. Per il primo test si consiglia una durata breve.

Crea un'attività di generazione

POST https://api.hiapi.ai/v1/tasks

Header

AuthorizationstringObbligatorio

Chiave API dell'account. Obbligatoria in ogni richiesta. Esempio: Bearer YOUR_HIAPI_API_KEY. Ottieni una chiave API

Content-TypestringOpzionale

Il corpo della richiesta viene sempre interpretato come JSON; se inviato, è accettato solo application/json (charset facoltativo) — qualsiasi altro valore restituisce 415. Esempio: application/json.

Idempotency-KeystringOpzionale

Chiave di idempotenza, fino a 255 byte. I retry con la stessa chiave dello stesso account creano l'attività una sola volta; i replay restituiscono il taskId originale.

Chiave di idempotenza

In caso di timeout di rete o retry automatici del client, la stessa chiave crea l'attività una sola volta, senza doppi addebiti (ambito = l'account della chiave API). Usa un identificatore univoco di business (es. "order-42"); i replay restituiscono il taskId originale e le chiavi scadono 24 ore dopo la prima richiesta. La matrice completa degli scenari è nell'introduzione dell'API asincrona unificata.

Corpo

modelstringObbligatorio

Valore fisso attuale: veo-3.1-fast/image-to-video

routestringOpzionale

Valore fisso attuale: default

inputobjectObbligatorio

Oggetto di parametri di business per veo-3.1-fast/image-to-video e la route default — vedi la tabella dei parametri sotto.

seedintegerOpzionale

Seme casuale per ottenere risultati di generazione riproducibili; il valore è un numero intero, se non fornito viene generato casualmente dal server.

promptstringObbligatoriominLength 1maxLength 20000

Prompt testuale che descrive in che modo l'immagine di input debba animarsi; è una stringa.

durationintegerObbligatorioPredefinito: 8min 4max 8

Durata del video generato, in secondi, valore intero, predefinito 8; il costo aumenta con la durata.

Opzioni:468

image_urlstringObbligatorio

URL dell'immagine di input da animare; si consiglia risoluzione 720p o superiore e proporzioni 16:9 o 9:16, le altre proporzioni vengono ritagliate per adattarsi.

resolutionstringObbligatorioPredefinito: "720p"

Risoluzione del video di output, valore stringa, predefinito 720p; maggiore è la risoluzione, maggiore è il costo.

Opzioni:720p1080p4k

aspect_ratiostringOpzionalePredefinito: "auto"

Proporzioni del video di output, valore stringa, predefinito auto, ovvero segue le proporzioni dell'immagine di input.

Opzioni:auto16:99:16

generate_audiobooleanOpzionalePredefinito: true

Indica se generare una traccia audio nativa, valore booleano, predefinito true; se attivato il prezzo è più alto.

negative_promptstringOpzionale

Prompt negativo, utilizzato per descrivere i contenuti da evitare nel video generato; il valore è una stringa.

callbackobjectOpzionale

Configurazione di notifica dello stato terminale. Se omessa, nessun callback: interroga l'attività per conto tuo.

Callback (Webhook)

Fornisci callback.url in creazione e HiAPI invierà un POST al tuo servizio allo stato terminale, senza polling. Il corpo del callback replica la struttura del dettaglio attività; verifica firma, retry e idempotenza sono descritti nell'introduzione dell'API asincrona unificata.

urlstringObbligatorio

Obbligatoria se è presente callback. Allo stato terminale viene inviato un POST a questo URL; deve essere un URL http(s) valido.

whenstringOpzionalePredefinito: "final"

Al momento è supportato solo final: notifica sia su success sia su fail.

Opzioni:final

storagestringOpzionalePredefinito: "temp"

Livello di archiviazione degli artefatti: temp (predefinito, ~7 giorni) o persistent (a lungo termine, fatturato per dimensione). Saldo insufficiente o superamento del limite ⇒ declassamento silenzioso a temp; il livello effettivo è visibile nella risposta di dettaglio.

Opzioni:temppersistent

Esempi di richiesta

# Invia un'attività asincrona; restituisce subito un taskId (senza attendere la generazione)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "veo-3.1-fast/image-to-video",
  "input": {
    "prompt": "…",
    "duration": 8,
    "image_url": "…",
    "resolution": "720p",
    "aspect_ratio": "auto",
    "generate_audio": true
  }
}'

const res = await fetch("https://api.hiapi.ai/v1/tasks", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "veo-3.1-fast/image-to-video",
    input: {
      "prompt": "…",
      "duration": 8,
      "image_url": "…",
      "resolution": "720p",
      "aspect_ratio": "auto",
      "generate_audio": true
    }
  }),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } }

import os, requests

res = requests.post(
    "https://api.hiapi.ai/v1/tasks",
    headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
    json={
        "model": "veo-3.1-fast/image-to-video",
        "input": {
          "prompt": "…",
          "duration": 8,
          "image_url": "…",
          "resolution": "720p",
          "aspect_ratio": "auto",
          "generate_audio": True
        }
    },
)
print(res.json())  # { code, message, data: { taskId } }

200 OK

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
  }
}

400 Bad Request

{
  "code": 400,
  "message": "invalid request",
  "data": null,
  "error_code": "INVALID_REQUEST"
}

Ottieni i dettagli dell'attività

GET https://api.hiapi.ai/v1/tasks/:id

Campi della risposta

taskIdstringObbligatorio

ID attività, sempre con prefisso tk-hiapi-.

modelstringObbligatorio

Nome completo risolto del modello. Le attività inviate con il parametro route restituiscono base@route (es. gpt-image-2/text-to-image@ext); altrimenti coincide con il nome inviato.

routestringOpzionale

Presente solo se è stato usato il parametro route esplicito; restituisce il valore inviato.

statusstringObbligatorio

Stato dell'attività.

Valori di stato

queued In coda, non avviata. handling In elaborazione. archiving Elaborazione conclusa, preparazione artefatti. success Terminale: completato, artefatti disponibili (restituisce output). fail Terminale: errore (restituisce error). Dopo l'invio, segui status: success e fail sono terminali, il resto no. Esegui polling ogni 1–3 s fino allo stato terminale. In caso di successo scarica gli artefatti da output[].url e trasferiscili prima di expireAt; per conservazione lunga usa storage: "persistent" in creazione.

creatednumberObbligatorio

Istante di creazione dell'attività (secondi Unix).

completednumberObbligatorio

Secondi Unix dello stato terminale; 0 finché non terminale.

outputarrayOpzionale

Presente solo con status == success. Elenco artefatti — sempre un array; un'attività può restituire più type contemporaneamente (es. video + first_frame).

Array [ object ]

Elementi dell'array

urlstringObbligatorio

URL dell'artefatto, scaricabile direttamente.

typestringObbligatorio

Valori attualmente possibili: video, image, audio, first_frame, last_frame, thumbnail; potrebbero essere ampliati in futuro.

expireAtnumberObbligatorio

Secondi Unix di disponibilità dell'artefatto; scarica o trasferisci prima della scadenza.

errorobjectOpzionale

Presente solo con status == fail.

codestringObbligatorio

Codice errore di business.

messagestringObbligatorio

Descrizione dell'errore.

Esempi di risposta

Successo

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
    "model": "happyhorse-1-0",
    "status": "success",
    "created": 1777282033,
    "completed": 1777282099,
    "output": [
      {
        "url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
        "type": "video",
        "expireAt": 1777886899
      }
    ]
  }
}

In elaborazione (non terminale)

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "archiving",
    "created": 1777282033,
    "completed": 0
  }
}

Non riuscito

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "fail",
    "created": 1777282033,
    "completed": 1777282099,
    "error": {
      "code": "TASK_FAILED",
      "message": "task failed"
    }
  }
}