A partire dal 29 aprile 2025, i modelli Gemini 1.5 Pro e Gemini 1.5 Flash non sono disponibili nei progetti che non li hanno mai utilizzati, inclusi i nuovi progetti. Per maggiori dettagli, vedi Versioni e ciclo di vita dei modelli.

Questa pagina è stata tradotta dall'API Cloud Translation.

Veo | Generatore di video con l'IA

Puoi utilizzare Veo su Vertex AI per generare nuovi video da un prompt di testo o un prompt di immagine che fornisci nella console Google Cloud o invii in una richiesta all'API Vertex AI.

Prova Veo su Vertex AI Media Studio

Prova Veo in Colab

Richiedere l'accesso: funzionalità avanzate e lista d'attesa di Veo

Versioni modello

Puoi utilizzare diversi modelli di generazione di video. Per ulteriori informazioni, consulta Modelli Veo.

Località

Una località è una regione che puoi specificare in una richiesta per controllare dove vengono archiviati i dati at-rest. Per un elenco delle regioni disponibili, consulta Località dell'AI generativa su Vertex AI.

AI responsabile

Veo genera video realistici e di alta qualità da prompt di testo e immagini in linguaggio naturale, incluse immagini di persone di tutte le età. Veo potrebbe restituire un errore che indica che il tuo Google Cloud progetto deve essere approvato per la generazione di persone o bambini, a seconda del contesto del prompt di testo o immagine.

Se è necessaria un'approvazione, contatta il rappresentante del tuo account Google.

Prima di iniziare

Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Go to project selector

Enable the Vertex AI API.

Enable the API

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Go to project selector

Enable the Vertex AI API.

Enable the API

Configura l'autenticazione per il tuo ambiente.

Select the tab for how you plan to use the samples on this page:

Console

When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.

REST

Per utilizzare gli esempi di API REST in questa pagina in un ambiente di sviluppo locale, utilizzi le credenziali che fornisci a gcloud CLI.

After installing the Google Cloud CLI, initialize it by running the following command:

gcloud init

If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.

Per saperne di più, consulta la sezione Autenticarsi per l'utilizzo di REST nella documentazione sull'autenticazione di Google Cloud .

Generare video da testo

Puoi generare nuovi video utilizzando solo testo descrittivo come input. Gli esempi seguenti mostrano le istruzioni di base per generare video.

Console

Nella console Google Cloud , vai alla pagina Vertex AI Studio > Media Studio.

Media Studio
Fai clic su Video.
(Facoltativo) Nel riquadro Impostazioni, configura le seguenti impostazioni:
- Modello: scegli un modello tra le opzioni disponibili.
- Proporzioni: scegli 16:9 o 9:16.
  
  Nota: le proporzioni 9:16 non sono supportate da veo-3.0-generate-preview.
- Numero di risultati: regola il cursore o inserisci un valore compreso tra 1 e 4.
- Durata video: seleziona una durata compresa tra 5 secondi e 8 secondi.
- Directory di output: fai clic su Sfoglia per creare o selezionare un bucket Cloud Storage in cui archiviare i file di output.
(Facoltativo) Nella sezione Sicurezza, seleziona una delle seguenti impostazioni di generazione di persone:
- Consenti (solo per adulti): valore predefinito. Genera solo persone o volti adulti. Non generare persone o volti di giovani o bambini.
- Non consentire: non generare persone o volti.
(Facoltativo) Nella sezione Opzioni avanzate, inserisci un valore Seed per randomizzare la generazione dei video.
Nella casella Scrivi il prompt, inserisci il prompt di testo che descrive i video da generare.
Fai clic su Genera.

REST

Dopo aver configurato l'ambiente, puoi utilizzare REST per testare un prompt di testo. Il seguente esempio invia una richiesta all'endpoint del modello del publisher.

Per saperne di più sull'API Veo, consulta la documentazione dell'API Veo su Vertex AI.

Utilizza il seguente comando per inviare una richiesta di generazione di video. Questa richiesta avvia un'operazione a lunga esecuzione e archivia l'output in un bucket Cloud Storage specificato.

Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:
- PROJECT_ID: il tuo Google Cloud ID progetto.
- MODEL_ID: l'ID modello da utilizzare. Valori disponibili:
  - veo-2.0-generate-001 (GA)
  - veo-3.0-generate-preview (anteprima)
- TEXT_PROMPT: Il prompt di testo utilizzato per guidare la generazione del video.
- OUTPUT_STORAGE_URI: (Facoltativo) Il bucket Cloud Storage in cui archiviare i video di output. Se non vengono forniti, i byte video vengono restituiti nella risposta. Ad esempio: gs://video-bucket/output/.
- RESPONSE_COUNT: Il numero di file video che vuoi generare. Valori interi accettati: 1-4.
- DURATION: La durata dei file video che vuoi generare. I valori interi accettati sono 5-8.
- Parametri facoltativi aggiuntivi
  
  Utilizza le seguenti variabili facoltative a seconda del tuo caso d'uso. Aggiungi alcuni o tutti i seguenti parametri nell'oggetto "parameters": {}.
```
"parameters": {
  "aspectRatio": "ASPECT_RATIO",
  "negativePrompt": "NEGATIVE_PROMPT",
  "personGeneration": "PERSON_SAFETY_SETTING",
  "sampleCount": RESPONSE_COUNT,
  "seed": SEED_NUMBER
}
```
  - ASPECT_RATIO: stringa. Facoltativo. Definisce le proporzioni dei video generati. Valori: 16:9 (predefinito, orizzontale) o 9:16 (verticale).
  - NEGATIVE_PROMPT: stringa. Facoltativo. Una stringa di testo che descrive ciò che vuoi scoraggiare il modello a generare.
  - PERSON_SAFETY_SETTING: stringa. Facoltativo. L'impostazione di sicurezza che controlla se è consentita la generazione di persone o volti. Valori:
    - allow_adult (valore predefinito): consente la generazione solo per adulti.
    - disallow: Non consente l'inclusione di persone o volti nelle immagini.
  - RESPONSE_COUNT: int. Facoltativo. Il numero di immagini di output richieste. Valori: 1-4.
  - SEED_NUMBER: uint32. Facoltativo. Un numero per rendere deterministici i video generati. Se specifichi un numero seed nella richiesta senza modificare altri parametri, il modello genererà gli stessi video. Valori: 0 - 4294967295.
Metodo HTTP e URL:
```
POST https://us-central1-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/publishers/google/models/MODEL_ID:predictLongRunning
```
Corpo JSON della richiesta:
```
{
  "instances": [
    {
      "prompt": "TEXT_PROMPT"
    }
  ],
  "parameters": {
    "storageUri": "OUTPUT_STORAGE_URI",
    "sampleCount": "RESPONSE_COUNT"
  }
}
```
Per inviare la richiesta, scegli una di queste opzioni:
curl

Nota: il seguente comando presuppone che tu abbia eseguito l'accesso all'interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login oppure utilizzando Cloud Shell, che consente di accedere automaticamente all'interfaccia a riga di comando gcloud. Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Salva il corpo della richiesta in un file denominato request.json, quindi esegui il comando seguente:
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://us-central1-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/publishers/google/models/MODEL_ID:predictLongRunning"
PowerShell

Nota: il comando seguente presuppone che tu abbia eseguito l'accesso all'interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login . Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Salva il corpo della richiesta in un file denominato request.json, quindi esegui il comando seguente:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://us-central1-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/publishers/google/models/MODEL_ID:predictLongRunning" | Select-Object -Expand Content
Questa richiesta restituisce un nome completo dell'operazione con un ID operazione univoco. Utilizza questo nome completo dell'operazione per eseguire il polling dello stato della richiesta di generazione del video.
```
{
  "name": "projects/PROJECT_ID/locations/us-central1/publishers/google/models/MODEL_ID/operations/a1b07c8e-7b5a-4aba-bb34-3e1ccb8afcc8"
}
```
(Facoltativo) Controlla lo stato dell'operazione a lunga esecuzione di generazione del video.

Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:
- PROJECT_ID: il tuo Google Cloud ID progetto.
- MODEL_ID: l'ID modello da utilizzare. Valori disponibili:
  - veo-2.0-generate-001 (GA)
  - veo-3.0-generate-preview (anteprima)
- OPERATION_ID: L'ID operazione univoco restituito nella richiesta originale di generazione del video.
Metodo HTTP e URL:
```
POST https://us-central1-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/publishers/google/models/MODEL_ID:fetchPredictOperation
```
Corpo JSON della richiesta:
```
{
  "operationName": "projects/PROJECT_ID/locations/us-central1/publishers/google/models/MODEL_ID/operations/OPERATION_ID"
}
```
Per inviare la richiesta, scegli una di queste opzioni:
curl

Nota: il seguente comando presuppone che tu abbia eseguito l'accesso all'interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login oppure utilizzando Cloud Shell, che consente di accedere automaticamente all'interfaccia a riga di comando gcloud. Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Salva il corpo della richiesta in un file denominato request.json, quindi esegui il comando seguente:
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://us-central1-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/publishers/google/models/MODEL_ID:fetchPredictOperation"
PowerShell

Nota: il comando seguente presuppone che tu abbia eseguito l'accesso all'interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login . Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Salva il corpo della richiesta in un file denominato request.json, quindi esegui il comando seguente:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://us-central1-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/publishers/google/models/MODEL_ID:fetchPredictOperation" | Select-Object -Expand Content
Questa richiesta restituisce informazioni sull'operazione, incluso se è ancora in esecuzione o è stata completata.
Risposta
```
{
  "name": "projects/PROJECT_ID/locations/us-central1/publishers/google/models/MODEL_ID/operations/OPERATION_ID",
  "done": true,
  "response": {
    "@type": "type.googleapis.com/cloud.ai.large_models.vision.GenerateVideoResponse",
    "videos": [
      {
        "gcsUri":"gs://BUCKET_NAME/TIMESTAMPED_FOLDER/sample_0.mp4",
        "mimeType": "video/mp4"
      }
    ]
  }
}
```

Gen AI SDK for Python

Installa

pip install --upgrade google-genai

Per saperne di più, consulta la documentazione di riferimento dell'SDK.

Imposta le variabili di ambiente per utilizzare l'SDK Gen AI con Vertex AI:

# Replace the `GOOGLE_CLOUD_PROJECT` and `GOOGLE_CLOUD_LOCATION` values
# with appropriate values for your project.
export GOOGLE_CLOUD_PROJECT=GOOGLE_CLOUD_PROJECT
export GOOGLE_CLOUD_LOCATION=global
export GOOGLE_GENAI_USE_VERTEXAI=True

import time
from google import genai
from google.genai.types import GenerateVideosConfig

client = genai.Client()

# TODO(developer): Update and un-comment below line
# output_gcs_uri = "gs://your-bucket/your-prefix"

operation = client.models.generate_videos(
    model="veo-3.0-generate-preview",
    prompt="a cat reading a book",
    config=GenerateVideosConfig(
        aspect_ratio="16:9",
        output_gcs_uri=output_gcs_uri,
    ),
)

while not operation.done:
    time.sleep(15)
    operation = client.operations.get(operation)
    print(operation)

if operation.response:
    print(operation.result.generated_videos[0].video.uri)

# Example response:
# gs://your-bucket/your-prefix

Generare video da un'immagine

Input di esempio	Esempio di output
Immagine di input¹ Prompt di testo: the elephant moves around naturally

¹ Immagine generata utilizzando Imagen su Vertex AI dal prompt: Un elefante all'uncinetto con motivi intricati che cammina nella savana

Puoi generare nuovi video utilizzando solo un'immagine come input oppure un'immagine e un testo descrittivo come input. Gli esempi riportati di seguito mostrano le istruzioni di base per generare video da immagini e testo.

Console

Nella console Google Cloud , vai alla pagina Vertex AI Studio > Media Studio.

Media Studio
Fai clic su Video.
(Facoltativo) Nel riquadro Impostazioni, configura le seguenti impostazioni:
- Modello: scegli un modello tra le opzioni disponibili.
- Proporzioni: scegli 16:9 o 9:16.
  
  Nota: le proporzioni 9:16 non sono supportate da veo-3.0-generate-preview.
- Numero di risultati: regola il cursore o inserisci un valore compreso tra 1 e 4.
- Durata video: seleziona una durata compresa tra 5 secondi e 8 secondi.
- Directory di output: fai clic su Sfoglia per creare o selezionare un bucket Cloud Storage in cui archiviare i file di output.
(Facoltativo) Nella sezione Sicurezza, seleziona una delle seguenti impostazioni di generazione di persone:
- Consenti (solo per adulti): valore predefinito. Genera solo persone o volti adulti. Non generare persone o volti di giovani o bambini.
- Non consentire: non generare persone o volti.
(Facoltativo) Nella sezione Opzioni avanzate, inserisci un valore Seed per randomizzare la generazione dei video.
Nella casella Scrivi il tuo prompt, fai clic su Carica.
Scegli un'immagine locale da caricare e fai clic su Seleziona.
Nella casella Scrivi il prompt, inserisci il prompt di testo che descrive i video da generare.
Fai clic su Genera.

REST

Dopo aver configurato l'ambiente, puoi utilizzare REST per testare un prompt di testo. Il seguente esempio invia una richiesta all'endpoint del modello del publisher.

Per saperne di più sull'API Veo, consulta la documentazione dell'API Veo su Vertex AI.

Utilizza il seguente comando per inviare una richiesta di generazione di video. Questa richiesta avvia un'operazione a lunga esecuzione e archivia l'output in un bucket Cloud Storage specificato.

Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:
- PROJECT_ID: il tuo Google Cloud ID progetto.
- MODEL_ID: l'ID modello da utilizzare. Valori disponibili:
  - veo-2.0-generate-001 (GA)
  - veo-3.0-generate-preview (anteprima)
- TEXT_PROMPT: Il prompt di testo utilizzato per guidare la generazione del video.
- INPUT_IMAGE: stringa di byte con codifica Base64 che rappresenta l'immagine di input. Per garantire la qualità, l'immagine di input deve essere a 720p o superiore (1280 x 720 pixel) e avere proporzioni 16:9 o 9:16. Le immagini con proporzioni o dimensioni diverse potrebbero essere ridimensionate o ritagliate centralmente durante il processo di caricamento.
- MIME_TYPE: Il tipo MIME dell'immagine di input. Sono supportate solo le immagini dei seguenti tipi MIME: image/jpeg o image/png.
- OUTPUT_STORAGE_URI: (Facoltativo) Il bucket Cloud Storage in cui archiviare i video di output. Se non vengono forniti, i byte video vengono restituiti nella risposta. Ad esempio: gs://video-bucket/output/.
- RESPONSE_COUNT: Il numero di file video che vuoi generare. Valori interi accettati: 1-4.
- DURATION: La durata dei file video che vuoi generare. I valori interi accettati sono 5-8.
- Parametri facoltativi aggiuntivi
  
  Utilizza le seguenti variabili facoltative a seconda del tuo caso d'uso. Aggiungi alcuni o tutti i seguenti parametri nell'oggetto "parameters": {}.
```
"parameters": {
  "aspectRatio": "ASPECT_RATIO",
  "negativePrompt": "NEGATIVE_PROMPT",
  "personGeneration": "PERSON_SAFETY_SETTING",
  "sampleCount": RESPONSE_COUNT,
  "seed": SEED_NUMBER
}
```
  - ASPECT_RATIO: stringa. Facoltativo. Definisce le proporzioni dei video generati. Valori: 16:9 (predefinito, orizzontale) o 9:16 (verticale).
  - NEGATIVE_PROMPT: stringa. Facoltativo. Una stringa di testo che descrive ciò che vuoi scoraggiare il modello a generare.
  - PERSON_SAFETY_SETTING: stringa. Facoltativo. L'impostazione di sicurezza che controlla se è consentita la generazione di persone o volti. Valori:
    - allow_adult (valore predefinito): consente la generazione solo per adulti.
    - disallow: Non consente l'inclusione di persone o volti nelle immagini.
  - RESPONSE_COUNT: int. Facoltativo. Il numero di immagini di output richieste. Valori: 1-4.
  - SEED_NUMBER: uint32. Facoltativo. Un numero per rendere deterministici i video generati. Se specifichi un numero seed nella richiesta senza modificare altri parametri, il modello genererà gli stessi video. Valori: 0 - 4294967295.
Metodo HTTP e URL:
```
POST https://us-central1-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/publishers/google/models/MODEL_ID:predictLongRunning
```
Corpo JSON della richiesta:
```
{
  "instances": [
    {
      "prompt": "TEXT_PROMPT",
      "image": {
        "bytesBase64Encoded": "INPUT_IMAGE",
        "mimeType": "MIME_TYPE"
      }
    }
  ],
  "parameters": {
    "storageUri": "OUTPUT_STORAGE_URI",
    "sampleCount": RESPONSE_COUNT
  }
}
```
Per inviare la richiesta, scegli una di queste opzioni:
curl

Nota: il seguente comando presuppone che tu abbia eseguito l'accesso all'interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login oppure utilizzando Cloud Shell, che consente di accedere automaticamente all'interfaccia a riga di comando gcloud. Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Salva il corpo della richiesta in un file denominato request.json, quindi esegui il comando seguente:
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://us-central1-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/publishers/google/models/MODEL_ID:predictLongRunning"
PowerShell

Nota: il comando seguente presuppone che tu abbia eseguito l'accesso all'interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login . Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Salva il corpo della richiesta in un file denominato request.json, quindi esegui il comando seguente:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://us-central1-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/publishers/google/models/MODEL_ID:predictLongRunning" | Select-Object -Expand Content
Questa richiesta restituisce un nome completo dell'operazione con un ID operazione univoco. Utilizza questo nome completo dell'operazione per eseguire il polling dello stato della richiesta di generazione del video.
```
{
  "name": "projects/PROJECT_ID/locations/us-central1/publishers/google/models/MODEL_ID/operations/a1b07c8e-7b5a-4aba-bb34-3e1ccb8afcc8"
}
```
(Facoltativo) Controlla lo stato dell'operazione a lunga esecuzione di generazione del video.

Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:
- PROJECT_ID: il tuo Google Cloud ID progetto.
- MODEL_ID: l'ID modello da utilizzare. Valori disponibili:
  - veo-2.0-generate-001
- TEXT_PROMPT: Il prompt di testo utilizzato per guidare la generazione del video.
- OUTPUT_STORAGE_URI: (Facoltativo) Il bucket Cloud Storage in cui archiviare i video di output. Se non vengono forniti, i byte video vengono restituiti nella risposta. Ad esempio: gs://video-bucket/output/.
- RESPONSE_COUNT: Il numero di file video che vuoi generare. Valori interi accettati: 1-4.
- Parametri facoltativi aggiuntivi
  
  Utilizza le seguenti variabili facoltative a seconda del tuo caso d'uso. Aggiungi alcuni o tutti i seguenti parametri nell'oggetto "parameters": {}.
```
"parameters": {
  "aspectRatio": "ASPECT_RATIO",
  "negativePrompt": "NEGATIVE_PROMPT",
  "personGeneration": "PERSON_SAFETY_SETTING",
  "sampleCount": RESPONSE_COUNT,
  "seed": SEED_NUMBER
}
```
  - ASPECT_RATIO: stringa. Facoltativo. Definisce le proporzioni dei video generati. Valori: 16:9 (predefinito, orizzontale) o 9:16 (verticale).
  - NEGATIVE_PROMPT: stringa. Facoltativo. Una stringa di testo che descrive ciò che vuoi scoraggiare il modello a generare.
  - PERSON_SAFETY_SETTING: stringa. Facoltativo. L'impostazione di sicurezza che controlla se è consentita la generazione di persone o volti. Valori:
    - allow_adult (valore predefinito): consente la generazione solo per adulti.
    - disallow: Non consente l'inclusione di persone o volti nelle immagini.
  - RESPONSE_COUNT: int. Facoltativo. Il numero di immagini di output richieste. Valori: 1-4.
  - SEED_NUMBER: uint32. Facoltativo. Un numero per rendere deterministici i video generati. Se specifichi un numero seed nella richiesta senza modificare altri parametri, il modello genererà gli stessi video. Valori: 0 - 4294967295.
Metodo HTTP e URL:
```
POST https://us-central1-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/publishers/google/models/MODEL_ID:predictLongRunning
```
Corpo JSON della richiesta:
```
{
  "instances": [
    {
      "prompt": "TEXT_PROMPT"
    }
  ],
  "parameters": {
    "storageUri": "OUTPUT_STORAGE_URI",
    "sampleCount": "RESPONSE_COUNT"
  }
}
```
Per inviare la richiesta, scegli una di queste opzioni:
curl

Nota: il seguente comando presuppone che tu abbia eseguito l'accesso all'interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login oppure utilizzando Cloud Shell, che consente di accedere automaticamente all'interfaccia a riga di comando gcloud. Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Salva il corpo della richiesta in un file denominato request.json, quindi esegui il comando seguente:
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://us-central1-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/publishers/google/models/MODEL_ID:predictLongRunning"
PowerShell

Nota: il comando seguente presuppone che tu abbia eseguito l'accesso all'interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login . Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Salva il corpo della richiesta in un file denominato request.json, quindi esegui il comando seguente:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://us-central1-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/publishers/google/models/MODEL_ID:predictLongRunning" | Select-Object -Expand Content
Questa richiesta restituisce un nome completo dell'operazione con un ID operazione univoco. Utilizza questo nome completo dell'operazione per eseguire il polling dello stato della richiesta di generazione del video.
```
{
  "name": "projects/PROJECT_ID/locations/us-central1/publishers/google/models/MODEL_ID/operations/a1b07c8e-7b5a-4aba-bb34-3e1ccb8afcc8"
}
```

Gen AI SDK for Python

Installa

pip install --upgrade google-genai

Per saperne di più, consulta la documentazione di riferimento dell'SDK.

Imposta le variabili di ambiente per utilizzare l'SDK Gen AI con Vertex AI:

# Replace the `GOOGLE_CLOUD_PROJECT` and `GOOGLE_CLOUD_LOCATION` values
# with appropriate values for your project.
export GOOGLE_CLOUD_PROJECT=GOOGLE_CLOUD_PROJECT
export GOOGLE_CLOUD_LOCATION=global
export GOOGLE_GENAI_USE_VERTEXAI=True

import time
from google import genai
from google.genai.types import GenerateVideosConfig, Image

client = genai.Client()

# TODO(developer): Update and un-comment below line
# output_gcs_uri = "gs://your-bucket/your-prefix"

operation = client.models.generate_videos(
    model="veo-3.0-generate-preview",
    image=Image(
        gcs_uri="gs://cloud-samples-data/generative-ai/image/flowers.png",
        mime_type="image/png",
    ),
    config=GenerateVideosConfig(
        aspect_ratio="16:9",
        output_gcs_uri=output_gcs_uri,
    ),
)

while not operation.done:
    time.sleep(15)
    operation = client.operations.get(operation)
    print(operation)

if operation.response:
    print(operation.result.generated_videos[0].video.uri)

# Example response:
# gs://your-bucket/your-prefix

Riscrittura dei prompt

Veo offre uno strumento di miglioramento dei prompt basato su LLM, noto anche come riscrittura dei prompt. Il riscrittore di prompt offre la possibilità di riscrivere i prompt per aggiungere descrizione del video, movimenti della videocamera, trascrizione ed effetti sonori al prompt. Prompt più dettagliati generano video di qualità superiore.

Se disattivi il miglioramento dei prompt, la qualità dei video e la somiglianza dell'output con il prompt fornito potrebbero risentirne. Questa funzionalità è attivata per impostazione predefinita per le seguenti versioni del modello:

veo-2.0-generate-001
veo-3.0-generate-preview (Anteprima)

Importante: non puoi disattivare la riscrittura dei prompt quando utilizzi veo-3.0-generate-preview

Il prompt riscritto viene fornito dalla risposta API solo se il prompt originale contiene meno di 30 parole.

Per disattivare il miglioramento dei prompt:

Console

Nella console Google Cloud , vai alla pagina Vertex AI Studio > Media Studio.

Vai a Media Studio
Fai clic su Veo.
In Impostazioni, fai clic sul pulsante di attivazione/disattivazione Miglioramento prompt.
Nella casella Scrivi il prompt, inserisci il prompt e fai clic su Genera.

REST

Per saperne di più sull'API Veo, consulta la documentazione dell'API Veo su Vertex AI.

Utilizza il seguente comando per inviare una richiesta di generazione di video. Questa richiesta avvia un'operazione a lunga esecuzione e archivia l'output in un bucket Cloud Storage specificato.

Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:
- PROJECT_ID: il tuo Google Cloud ID progetto.
- MODEL_ID: l'ID modello da utilizzare. Valori disponibili:
  - veo-2.0-generate-001 (lista consentita di GA)
  - veo-3.0-generate-preview (anteprima)
- TEXT_PROMPT: Il prompt di testo utilizzato per guidare la generazione del video.
- OUTPUT_STORAGE_URI: (Facoltativo) il bucket Cloud Storage in cui archiviare i video di output. Se non vengono forniti, i byte video vengono restituiti nella risposta. Ad esempio: gs://video-bucket/output/.
- RESPONSE_COUNT: Il numero di file video che vuoi generare. Valori interi accettati: 1-4.
- DURATION: La durata dei file video che vuoi generare. I valori interi accettati sono compresi tra 5 e 8.
- ENHANCED_PROMPT: se utilizzare o meno i prompt avanzati. Puoi utilizzare uno dei seguenti metodi:
  - True: (impostazione predefinita) utilizza Gemini per migliorare i tuoi prompt.
  - False: non utilizzare Gemini per migliorare i tuoi prompt.
- Parametri facoltativi aggiuntivi
  
  Utilizza le seguenti variabili facoltative a seconda del tuo caso d'uso. Aggiungi alcuni o tutti i seguenti parametri nell'oggetto "parameters": {}.
```
"parameters": {
  "aspectRatio": "ASPECT_RATIO",
  "negativePrompt": "NEGATIVE_PROMPT",
  "personGeneration": "PERSON_SAFETY_SETTING",
  "sampleCount": RESPONSE_COUNT,
  "seed": SEED_NUMBER
}
```
  - ASPECT_RATIO: stringa. Facoltativo. Definisce le proporzioni dei video generati. Valori: 16:9 (predefinito, orizzontale) o 9:16 (verticale).
  - NEGATIVE_PROMPT: stringa. Facoltativo. Una stringa di testo che descrive ciò che vuoi scoraggiare il modello a generare.
  - PERSON_SAFETY_SETTING: stringa. Facoltativo. L'impostazione di sicurezza che controlla se è consentita la generazione di persone o volti. Valori:
    - allow_adult (valore predefinito): consente la generazione solo per adulti.
    - disallow: Non consente l'inclusione di persone o volti nelle immagini.
  - RESPONSE_COUNT: int. Facoltativo. Il numero di immagini di output richieste. Valori: 1-4.
  - SEED_NUMBER: uint32. Facoltativo. Un numero per rendere deterministici i video generati. Se specifichi un numero seed nella richiesta senza modificare altri parametri, il modello genererà gli stessi video. Valori: 0 - 4294967295.
Metodo HTTP e URL:
```
POST https://us-central1-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/publishers/google/models/MODEL_ID:predictLongRunning
```
Corpo JSON della richiesta:
```
{
  "instances": [
    {
      "prompt": "TEXT_PROMPT"
    }
  ],
  "parameters": {
    "storageUri": "OUTPUT_STORAGE_URI",
    "sampleCount": "RESPONSE_COUNT",
    "durationSeconds": "DURATION",
    "enhancePrompt": ENHANCED_PROMPT
  }
}
```
Per inviare la richiesta, scegli una di queste opzioni:
curl

Nota: il seguente comando presuppone che tu abbia eseguito l'accesso all'interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login oppure utilizzando Cloud Shell, che consente di accedere automaticamente all'interfaccia a riga di comando gcloud. Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Salva il corpo della richiesta in un file denominato request.json, quindi esegui il comando seguente:
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://us-central1-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/publishers/google/models/MODEL_ID:predictLongRunning"
PowerShell

Nota: il comando seguente presuppone che tu abbia eseguito l'accesso all'interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login . Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Salva il corpo della richiesta in un file denominato request.json, quindi esegui il comando seguente:
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://us-central1-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/publishers/google/models/MODEL_ID:predictLongRunning" | Select-Object -Expand Content
Questa richiesta restituisce un nome completo dell'operazione con un ID operazione univoco. Utilizza questo nome completo dell'operazione per eseguire il polling dello stato della richiesta di generazione del video.
```
{
  "name": "projects/PROJECT_ID/locations/us-central1/publishers/google/models/MODEL_ID/operations/a1b07c8e-7b5a-4aba-bb34-3e1ccb8afcc8"
}
```

Passaggi successivi

Leggi le informazioni di Google DeepMind sul modello Veo.
Leggi il post del blog "Veo e Imagen 3: annuncio di nuovi modelli di generazione di video e immagini su Vertex AI".
Leggi il post del blog "New generative media models and tools, built with and for creators".

Veo | Generatore di video con l'IA Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

Versioni modello

Località

AI responsabile

Prima di iniziare

Console

REST

Generare video da testo

Console

REST

curl

PowerShell

curl

PowerShell

Risposta

Gen AI SDK for Python

Installa

Generare video da un'immagine

Console

REST

curl

PowerShell

curl

PowerShell

Gen AI SDK for Python

Installa

Riscrittura dei prompt

Console

REST

curl

PowerShell

Passaggi successivi

Veo | Generatore di video con l'IA