Veo propose un outil d'amélioration des requêtes basé sur un LLM, également appelé réécrivain de requêtes. Cet outil vous permet de réécrire vos requêtes pour y ajouter une description vidéo, des mouvements de caméra, une transcription et des effets sonores. Si vous rédigez des requêtes plus détaillées, vous obtiendrez des vidéos de meilleure qualité.
Si vous désactivez l'amélioration des requêtes, la qualité des vidéos et la fidélité du résultat à la requête fournie peuvent être affectées. Cette fonctionnalité est activée par défaut pour veo-2.0-generate-001.
Une requête réécrite n'est envoyée par la réponse de l'API que si la requête d'origine contient moins de 30 mots.
Pour en savoir plus sur la rédaction de requêtes textuelles efficaces pour la génération de vidéos, consultez le guide des requêtes Veo.
Avant de commencer
-
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.-
Configurez l'authentification pour votre environnement.
Sélectionnez l'onglet correspondant à la façon dont vous prévoyez d'utiliser les exemples de cette page :
Console
Lorsque vous utilisez la Cloud de Confiance console pour accéder aux Cloud de Confiance by S3NS services et aux API, vous n'avez pas besoin de configurer l'authentification.
REST
Pour utiliser les exemples API REST de cette page dans un environnement de développement local, vous devez utiliser les identifiants que vous fournissez à la gcloud CLI.
Installez la Google Cloud CLI, puis connectez-vous à la gcloud CLI avec votre identité fédérée.
Pour en savoir plus, consultez la section S'authentifier pour utiliser REST dans la documentation sur l' Cloud de Confiance authentification.
Désactiver le réécrivain de requêtes
Pour désactiver l'amélioration des requêtes, procédez comme suit :
Console
Dans la Cloud de Confiance console, accédez à la page Agent Platform Studio > Media Studio.
Cliquez sur Veo.
Dans Settings (Paramètres), cliquez sur le bouton Enable prompt enhancement (Activer l'amélioration des requêtes).
Dans la zone Write your prompt (Rédigez votre requête), saisissez votre requête, puis cliquez sur Generate (Générer).
Python
Installer
pip install --upgrade google-genai
Pour en savoir plus, consultez la documentation de référence du SDK.
Définissez des variables d'environnement pour utiliser le SDK Google Gen AI avec 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
Pour en savoir plus sur l'API Veo, consultez les ressources suivantes :
- Méthode :
endpoints.predict VideoGenerationModelInstanceVideoGenerationModelParamsVideoGenerationModelResult
- Utilisez la commande suivante pour envoyer une requête de génération de vidéo. Cette requête lance une opération de longue durée et stocke le résultat dans un bucket Cloud Storage que vous spécifiez.
Avant d'utiliser les données de requête, effectuez les remplacements suivants :
- PROJECT_ID : ID de votre projet Cloud de Confiance by S3NS .
- MODEL_ID : ID du modèle à utiliser. Valeurs disponibles :
veo-2.0-generate-001
- TEXT_PROMPT : prompt textuel utilisé pour guider la génération de vidéos.
-
OUTPUT_STORAGE_URI : (facultatif) bucket Cloud Storage dans lequel stocker les vidéos de sortie. Si cette valeur n'est pas fournie, les octets vidéo sont renvoyés dans la
réponse. Exemple :
gs://video-bucket/output/. - RESPONSE_COUNT : nombre de fichiers vidéo que vous souhaitez générer. Valeurs entières acceptées : 1 à 4.
- DURATION : durée des fichiers vidéo que vous souhaitez générer. Les valeurs entières acceptées sont comprises entre 5 et 8.
-
ENHANCED_PROMPT : indique si vous souhaitez utiliser des requêtes améliorées ou non. Vous pouvez utiliser l'une des valeurs suivantes :
-
True: (par défaut) utilisez Gemini pour améliorer vos requêtes. -
False: n'utilisez pas Gemini pour améliorer vos requêtes.
-
-
Paramètres facultatifs supplémentaires
Utilisez les variables facultatives suivantes en fonction de votre cas d'utilisation. Ajoutez l'ensemble ou une partie des paramètres suivants dans l'objet
"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: (facultatif) valeur de chaîne décrivant le format des vidéos générées. Vous pouvez utiliser les valeurs suivantes :"16:9"pour le format paysage"9:16"pour le format portrait
La valeur par défaut est
"16:9". -
NEGATIVE_PROMPT: (facultatif) valeur de chaîne décrivant le contenu que vous souhaitez empêcher le modèle de générer. -
PERSON_SAFETY_SETTING: (facultatif) valeur de chaîne contrôlant le paramètre de sécurité pour la génération de personnes ou de visages. Vous pouvez utiliser les valeurs suivantes :-
"allow_adult": n'autorise que la génération de personnes et de visages adultes. -
"disallow": ne génère pas de personnes ni de visages.
La valeur par défaut est
"allow_adult". -
-
RESOLUTION: (facultatif) valeur de chaîne contrôlant la résolution de la vidéo générée. Compatible uniquement avec les modèles Veo 3. Vous pouvez utiliser les valeurs suivantes :"720p""1080p""4k"(modèles Veo 3.1 Preview uniquement)
La valeur par défaut est
"720p". -
RESPONSE_COUNT: Facultatif. Valeur entière décrivant le nombre de vidéos à générer. La plage de valeurs acceptée est1-4. -
SEED_NUMBER: facultatif. Valeur uint32 que le modèle utilise pour générer des vidéos déterministes vidéos. Si vous spécifiez un numéro de seed dans votre requête sans modifier d'autres paramètres, le modèle génère les mêmes vidéos. La plage de valeurs acceptée est0-4294967295.
-
Méthode HTTP et URL :
POST https://us-central1-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/publishers/google/models/MODEL_ID:predictLongRunning
Corps JSON de la requête :
{
"instances": [
{
"prompt": "TEXT_PROMPT"
}
],
"parameters": {
"storageUri": "OUTPUT_STORAGE_URI",
"sampleCount": "RESPONSE_COUNT",
"durationSeconds": "DURATION",
"enhancePrompt": ENHANCED_PROMPT
}
}
Pour envoyer votre requête, choisissez l'une des options suivantes :
curl
Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :
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
Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :
$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"
}