Veo offre uno strumento di miglioramento dei prompt basato su LLM, noto anche come riscrittore di prompt. Il riscrittore di prompt offre la possibilità di riscrivere i prompt per aggiungere descrizione del video, movimenti della videocamera, trascrizione ed effetti sonori. Prompt più dettagliati generano video di qualità superiore.
Se disabiliti il miglioramento dei prompt, la qualità dei video e la somiglianza dell'output con il prompt fornito potrebbero risentirne. Questa funzionalità è abilitata per impostazione predefinita per veo-2.0-generate-001.
Un prompt riscritto viene fornito dalla risposta dell'API solo se il prompt originale contiene meno di 30 parole.
Per saperne di più su come scrivere prompt di testo efficaci per la generazione di video, consulta la guida ai prompt di Veo.
Prima di iniziare
-
In the Cloud de Confiance console, on the project selector page, select or create a Cloud de Confiance project.
Roles required to select or create a project
- Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
-
Create a project: To create a project, you need the Project Creator role
(
roles/resourcemanager.projectCreator), which contains theresourcemanager.projects.createpermission. Learn how to grant roles.
Enable the Agent Platform API.
Roles required to enable APIs
To enable APIs, you need the Service Usage Admin IAM role (
roles/serviceusage.serviceUsageAdmin), which contains theserviceusage.services.enablepermission. Learn how to grant roles.-
Configura l'autenticazione per il tuo ambiente.
Seleziona la scheda relativa alla modalità di utilizzo degli esempi in questa pagina:
Console
Quando utilizzi la Cloud de Confiance console per accedere a Cloud de Confiance by S3NS servizi e API, non devi configurare l'autenticazione.
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.
Installa Google Cloud CLI, quindi accedi a gcloud CLI con la tua identità federata.
Per saperne di più, consulta Autenticati per usare REST nella Cloud de Confiance documentazione sull'autenticazione di.
Disattivare il riscrittore di prompt
Per disattivare il miglioramento dei prompt:
Console
Nella Cloud de Confiance console, vai alla pagina Agent Platform Studio > Media Studio.
Fai clic su Veo.
In Impostazioni, fai clic sul pulsante di attivazione/disattivazione Abilita miglioramento dei prompt.
Nella casella Scrivi il prompt, inserisci il prompt e fai clic su Genera.
Python
Installazione
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 Google 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_ENTERPRISE=True
REST
Per saperne di più sull'API Veo, consulta le seguenti risorse:
- Metodo:
endpoints.predict VideoGenerationModelInstanceVideoGenerationModelParamsVideoGenerationModelResult
- Utilizza il comando seguente 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 da te specificato.
Prima di utilizzare i dati della richiesta, apporta le sostituzioni seguenti:
- PROJECT_ID: il tuo Cloud de Confiance by S3NS 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 di video.
-
OUTPUT_STORAGE_URI: facoltativo, il bucket Cloud Storage in cui
archiviare i video di output. Se non viene fornito, 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.
-
ENHANCED_PROMPT: indica se utilizzare o meno i prompt migliorati. Puoi utilizzare uno dei
seguenti:
-
True: (impostazione predefinita) utilizza Gemini per migliorare i prompt. -
False: non utilizzare Gemini per migliorare i 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", // "resolution": RESOLUTION, // Veo 3 models only "sampleCount": RESPONSE_COUNT, "seed": SEED_NUMBER }-
ASPECT_RATIO: facoltativo, un valore stringa che descrive le proporzioni dei video generati. Puoi utilizzare i seguenti valori:"16:9"per l'orientamento orizzontale"9:16"per l'orientamento verticale
Il valore predefinito è
"16:9". -
NEGATIVE_PROMPT: facoltativo, un valore stringa che descrive i contenuti che vuoi impedire al modello di generare. -
PERSON_SAFETY_SETTING: facoltativo, un valore stringa che controlla l'impostazione di sicurezza per la generazione di persone o volti. Puoi utilizzare i seguenti valori:-
"allow_adult": consente solo la generazione di persone e volti adulti. -
"disallow": non genera persone o volti.
Il valore predefinito è
"allow_adult". -
-
RESOLUTION: facoltativo, un valore stringa che controlla la risoluzione del video generato. Supportato solo dai modelli Veo 3. Puoi utilizzare i seguenti valori:"720p""1080p""4k"(solo modelli di anteprima di Veo 3.1)
Il valore predefinito è
"720p". -
RESPONSE_COUNT: facoltativo. Un valore intero che descrive il numero di video da generare. L'intervallo di valori accettati è1-4. -
SEED_NUMBER: facoltativo. Un valore uint32 che il modello utilizza per generare video deterministici video. Se specifichi un numero di seed nella richiesta senza modificare altri parametri, il modello genererà gli stessi video. L'intervallo di valori accettati è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
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
Salva il corpo della richiesta in un file denominato request.json,
e 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
{
"name": "projects/PROJECT_ID/locations/us-central1/publishers/google/models/MODEL_ID/operations/a1b07c8e-7b5a-4aba-bb34-3e1ccb8afcc8"
}