Vous pouvez utiliser Gemini Omni Flash ou Veo sur Gemini Enterprise Agent Platform pour guider la génération de vidéos à l'aide d'images de référence.
Gemini Omni Flash
Gemini Omni Flash vous permet d'utiliser des images de référence pour fournir des informations supplémentaires au modèle lors de la génération d'une vidéo. Les modèles Gemini Omni Flash suivants sont compatibles avec les images de référence :
Cliquer pour développer les modèles compatibles
Veo
Veo sur Gemini Enterprise Agent Platform vous permet d'utiliser des images de référence pour orienter le contenu et le style artistique de vos vidéos générées. Lorsque vous utilisez des images de référence avec Veo, vous pouvez choisir l'une des options suivantes :
Image du sujet : vous fournissez jusqu'à trois images d'une même personne, d'un même personnage ou d'un même produit. Veo préserve l'apparence du sujet dans la vidéo générée.
Les modèles suivants sont compatibles avec la conversion d'images de composants de référence en vidéos :
Cliquer pour développer les modèles compatibles
Image de style : vous fournissez une seule image de style. Veo applique le style de l'image que vous avez importée à la vidéo de sortie.
Les modèles suivants sont compatibles avec la génération de vidéos à partir d'images de référence :
Cliquer pour développer les modèles compatibles
Pour en savoir plus sur l'écriture de requêtes de texte efficaces pour la génération de vidéos, consultez le guide des requêtes pour la génération de vidéos.
Essayer Gemini Omni Flash dans un notebook Colab
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 console Cloud de Confiance pour accéder aux services Cloud de Confiance by S3NS et aux API, vous n'avez pas besoin de configurer l'authentification.
Python
Pour utiliser les exemples Python de cette page dans un environnement de développement local, installez et initialisez la gcloud CLI, puis configurez les Identifiants par défaut de l'application avec vos identifiants utilisateur.
-
Installez la Google Cloud CLI.
-
Configurez la gcloud CLI afin d'utiliser votre identité fédérée.
Pour en savoir plus, consultez Se connecter à la gcloud CLI avec votre identité fédérée.
-
Créez des identifiants d'authentification locaux pour votre compte utilisateur :
gcloud auth application-default login
Si une erreur d'authentification est renvoyée et que vous utilisez un fournisseur d'identité (IdP) externe, vérifiez que vous vous êtes connecté à la gcloud CLI avec votre identité fédérée.
Pour en savoir plus, consultez Configurer les ADC pour un environnement de développement local dans la documentation sur l'authentification Cloud de Confiance .
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'authentification Cloud de Confiance .
-
Générer des vidéos avec Gemini Omni Flash et des références
REST
Pour en savoir plus sur l'utilisation de l'API Gemini Omni Flash, consultez API Interactions.
La génération de la vidéo peut prendre plus d'une minute. Pour générer une vidéo à télécharger immédiatement après sa création, utilisez une requête synchrone. Pour générer une vidéo qui pourra être téléchargée ultérieurement, envoyez une requête asynchrone en définissant le paramètre background sur true. Les interactions asynchrones sont conservées pendant 14 jours maximum.
Requête synchrone
Avant d'utiliser les données de requête, effectuez les remplacements suivants :
-
PROJECT_ID: chaîne représentant l'ID de votre projet Cloud de Confiance by S3NS . -
MODEL_ID: chaîne représentant l'ID du modèle à utiliser. Voici les valeurs acceptées :"gemini-omni-flash-preview"
-
TEXT_PROMPT: prompt textuel utilisé pour guider la génération de vidéos. -
CLOUD_STORAGE_INPUT_URI: chaîne représentant le bucket Cloud Storage contenant le contenu multimédia d'entrée. Exemple :"gs://video-bucket/input/". -
CLOUD_STORAGE_OUTPUT_URI: (facultatif) chaîne représentant le 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/". -
ASPECT_RATIO: (facultatif) chaîne représentant le format attendu de la vidéo de sortie. Si aucune valeur n'est fournie, le format est déduit de la requête. Voici les valeurs acceptées :"16:9""9:16"
-
DURATION: chaîne représentant la durée des fichiers vidéo générés. Les chaînes autorisées sont des nombres entiers compris entre3et10, suivis de "s" pour les secondes. Par exemple,"10s"
Méthode HTTP et URL :
POST https://aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/global/interactions
Corps JSON de la requête :
{
"model": "MODEL_ID",
"input": [
{
"type": "text",
"text": "TEXT_PROMPT"
},
{
"type": "image",
"uri": "CLOUD_STORAGE_INPUT_URI",
"mime_type": "image/png"
}
],
"response_format": [
{
"type": "video",
"delivery": "uri",
"gcs_uri": "CLOUD_STORAGE_OUTPUT_URI",
"aspect_ratio": "ASPECT_RATIO",
"duration": "DURATION"
}
],
"generation_config": {
"video_config": {
"task": "reference_to_video"
}
}
}
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 TOKEN" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/global/interactions"
PowerShell
Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :
$headers = @{ "Authorization" = "Bearer TOKEN" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/global/interactions" | Select-Object -Expand Content
{
"id":"INTERACTION_ID",
"model":"gemini-omni-flash-preview",
"status":"completed",
"usage":{
"total_tokens":479,
"total_input_tokens":26,
"input_tokens_by_modality":[
{
"modality":"text",
"tokens":26
},
{
"modality":"image",
"tokens":124
}
],
"output_tokens_by_modality": [
{
"modality": "video",
"tokens": 28832
}
],
"total_output_tokens":28832,
"total_thought_tokens":453
},
"steps":[
{
"type":"thought",
"summary":[
{
"type":"text",
"text":"MODEL THOUGHTS"
}
],
},
{
"type":"model_output",
"content":[
{
"type":"video",
"uri":"gs://some/output_path/123.mp4",
"mime_type":"video/mp4"
}
]
}
],
"object":"interaction"
"role":"model",
"created":"2026-05-29T02:17:56Z",
"updated":"2026-05-29T02:17:56Z",
}
Requête asynchrone
Avant d'utiliser les données de requête, effectuez les remplacements suivants :
-
PROJECT_ID: chaîne représentant l'ID de votre projet Cloud de Confiance by S3NS . -
MODEL_ID: chaîne représentant l'ID du modèle à utiliser. Voici les valeurs acceptées :"gemini-omni-flash-preview"
-
TEXT_PROMPT: prompt textuel utilisé pour guider la génération de vidéos. -
CLOUD_STORAGE_INPUT_URI: chaîne représentant le bucket Cloud Storage contenant le contenu multimédia d'entrée. Exemple :"gs://video-bucket/input/". -
CLOUD_STORAGE_OUTPUT_URI: (facultatif) chaîne représentant le 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/". -
ASPECT_RATIO: (facultatif) chaîne représentant le format attendu de la vidéo de sortie. Si aucune valeur n'est fournie, le format est déduit de la requête. Voici les valeurs acceptées :"16:9""9:16"
-
DURATION: chaîne représentant la durée des fichiers vidéo générés. Les chaînes autorisées sont des nombres entiers compris entre3et10, suivis de "s" pour les secondes. Par exemple,"10s"
Méthode HTTP et URL :
POST https://aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/global/interactions
Corps JSON de la requête :
{
"model": "MODEL_ID",
"input": [
{
"background": true,
"type": "text",
"text": "TEXT_PROMPT"
},
{
"type": "image",
"uri": "CLOUD_STORAGE_INPUT_URI",
"mime_type": "image/png"
}
],
"response_format": [
{
"type": "video",
"delivery": "uri",
"gcs_uri": "CLOUD_STORAGE_OUTPUT_URI",
"aspect_ratio": "ASPECT_RATIO",
"duration": "DURATION"
}
],
"generation_config": {
"video_config": {
"task": "reference_to_video"
}
}
}
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 TOKEN" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/global/interactions"
PowerShell
Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :
$headers = @{ "Authorization" = "Bearer TOKEN" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/global/interactions" | Select-Object -Expand Content
{
"id":"INTERACTION_ID",
"status":"in_progress",
"object":"interaction"
}
Avant d'utiliser les données de requête, effectuez les remplacements suivants :
-
PROJECT_ID: chaîne représentant l'ID de votre projet Cloud de Confiance by S3NS . -
INTERACTION_ID: ID d'interaction de la requête asynchrone.
Méthode HTTP et URL :
POST https://aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/global/interactions/INTERACTION_ID
Pour envoyer votre requête, choisissez l'une des options suivantes :
curl
Exécutez la commande suivante :
curl -X POST \
-H "Authorization: Bearer TOKEN" \
-H "Content-Type: application/json; charset=utf-8" \
-d "" \
"https://aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/global/interactions/INTERACTION_ID"
PowerShell
Exécutez la commande suivante :
$headers = @{ "Authorization" = "Bearer TOKEN" }
Invoke-WebRequest `
-Method POST `
-Headers $headers `
-Uri "https://aiplatform.googleapis.com/v1beta1/projects/PROJECT_ID/locations/global/interactions/INTERACTION_ID" | Select-Object -Expand Content
{
"id":"INTERACTION_ID",
"model":"gemini-omni-flash-preview",
"status":"completed",
"usage":{
"total_tokens":479,
"total_input_tokens":26,
"input_tokens_by_modality":[
{
"modality":"text",
"tokens":26
},
{
"modality":"image",
"tokens":124
}
],
"output_tokens_by_modality": [
{
"modality": "video",
"tokens": 28832
}
],
"total_output_tokens":28832,
"total_thought_tokens":453
},
"steps":[
{
"type": "user_input",
"content": [
{
"type": "text",
"text": "5 second, 9:16 video. Use the image as the first frame."
},
{
"type": "image",
"uri": "gs://some/path",
"mime_type": "image/png"
}
]
},
{
"type":"thought"
"summary":[
{
"type":"text",
"text":"MODEL THOUGHTS"
}
],
},
{
"type":"model_output",
"content":[
{
"type":"video",
"data":"VIDEO DATA",
"mime_type":"video/mp4"
}
]
}
],
"object":"interaction"
"role":"model",
"created":"2026-05-29T02:17:56Z",
"updated":"2026-05-29T02:17:56Z",
}
Générer des vidéos à l'aide de Veo et de références
Les sections suivantes décrivent comment utiliser Veo pour générer des vidéos à partir de références.
Générer des vidéos à partir d'images de composants
Procédez comme suit :
Console
Dans la console Cloud de Confiance , accédez à la page Agent Platform> Agent Platform Studio .
Cliquez sur Générer du contenu multimédia.
Cliquez sur Vidéo.
Dans le menu Tâche, sélectionnez Référence à la vidéo (sujet).
Dans le menu Modèle, sélectionnez un modèle parmi les options disponibles.
Dans la section Images du sujet, cliquez sur Ajouter.
Une boîte de dialogue de sélection de fichier s'affiche. Choisissez une à trois images sur votre ordinateur à importer.
(Facultatif) Dans la section Paramètres, ajustez les paramètres suivants :
- Format : sélectionnez 16:9 ou 9:16.
- Nombre de résultats : ajustez le curseur ou saisissez une valeur comprise entre 1 et 4.
- Durée de la vidéo : sélectionnez 8, 6 ou 4 secondes.
- Résolution de sortie : sélectionnez l'une des options suivantes :
- 720p
- 1080p
- 4K
Facultatif : dans la section Sécurité, sélectionnez l'un des paramètres de génération de personnes suivants :
Autoriser (adultes uniquement) : valeur par défaut. Permet de générer uniquement des personnes ou des visages adultes. Ne permet pas de générer des visages ni des personnes représentant des enfants ou des adolescents.
Ne pas autoriser : ne permet pas de générer des personnes ni des visages.
Facultatif : dans la section Options avancées, saisissez une valeur de graine pour générer des vidéos aléatoires.
Dans la zone Prompt, saisissez votre prompt textuel décrivant les vidéos à générer.
Cliquez sur Exécuter.
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 les commandes suivantes 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: chaîne représentant l'ID du modèle à utiliser. Les modèles suivants sont acceptés :-
<0x
-
TEXT_PROMPT: prompt textuel utilisé pour guider la génération de vidéos. -
BASE64_ENCODED_IMAGE: image du sujet encodée en octets base64. Vous pouvez répéter ce champ etmimeTypepour spécifier jusqu'à trois images du sujet. -
IMAGE_MIME_TYPE: type MIME de l'image d'entrée. Un seul des champs suivants :image/jpegimage/png
Vous pouvez répéter ce champ et
bytesBase64Encodedpour spécifier jusqu'à trois images du sujet. -
ASPECT_RATIO: (facultatif) format de la vidéo générée. Un seul des champs suivants :"16:9""9:16"
La valeur par défaut est
"16:9". -
OUTPUT_STORAGE_URI: (facultatif) bucket Cloud Storage dans lequel stocker les vidéos de sortie. Si aucune valeur n'est fournie, une vidéo encodée en octets Base64 est renvoyée dans la réponse. Par 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. -
VIDEO_RESOLUTION: (Facultatif) Résolution de la vidéo générée. Un seul des éléments suivants :"720p""1080p""4k"(modèles Veo 3.1 (preview) uniquement)
La valeur par défaut est
"720p". -
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 mode Paysage"9:16"pour le mode 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 qui contrôle le paramètre de sécurité pour la génération de personnes ou de visages. Vous pouvez utiliser les valeurs suivantes :-
"allow_adult": autoriser uniquement 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 qui contrôle 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 est comprise entre1et4. -
SEED_NUMBER: Facultatif. Valeur uint32 que le modèle utilise pour générer des vidéos déterministes. Si vous spécifiez un numéro source avec votre requête sans modifier d'autres paramètres, vous indiquez au modèle de produire les mêmes vidéos. La plage de valeurs acceptée est comprise entre0et4294967295.
-
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", // The following fields can be repeated for up to three total // images. "referenceImages": [ { "image": { "bytesBase64Encoded": "BASE64_ENCODED_IMAGE", "mimeType": "IMAGE_MIME_TYPE" }, "referenceType": "asset" } ] } ], "parameters": { "aspectRatio":, "ASPECT_RATIO, "durationSeconds": 8, "storageUri": "OUTPUT_STORAGE_URI", "sampleCount": RESPONSE_COUNT, "resolution": "VIDEO_RESOLUTION } }Pour envoyer votre requête, choisissez l'une des options suivantes :
Cette requête renvoie un nom d'opération complet avec un ID d'opération unique. Utilisez ce nom d'opération complet pour interroger l'état de la demande de génération de vidéo.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" }-
Facultatif : vérifiez l'état de l'opération de longue durée de génération de la vidéo.
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.
- OPERATION_ID : ID d'opération unique renvoyé dans la requête de génération de vidéo d'origine.
Méthode HTTP et URL :
POST https://us-central1-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/publishers/google/models/MODEL_ID:fetchPredictOperation
Corps JSON de la requête :
{ "operationName": "projects/PROJECT_ID/locations/us-central1/publishers/google/models/MODEL_ID/operations/OPERATION_ID" }Pour envoyer votre requête, choisissez l'une des options suivantes :
Cette requête renvoie des informations sur l'opération, y compris si elle est toujours en cours d'exécution ou si elle est terminée.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:fetchPredictOperation"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:fetchPredictOperation" | Select-Object -Expand Content
Utiliser des images de style pour générer des vidéos
Procédez comme suit :
Console
Dans la console Cloud de Confiance , accédez à la page Agent Platform> Agent Platform Studio .
Cliquez sur Générer du contenu multimédia.
Cliquez sur Vidéo.
Dans le menu Task (Tâche), sélectionnez Reference-to-video (Style) (Référence à la vidéo (style)).
Dans le menu Modèle, sélectionnez un modèle parmi les options disponibles.
Dans la section Image de style, cliquez sur Ajouter.
Une boîte de dialogue de sélection de fichier s'affiche. Choisissez une image sur votre ordinateur à importer.
(Facultatif) Dans la section Paramètres, ajustez les paramètres suivants :
- Format : sélectionnez 16:9 ou 9:16.
- Nombre de résultats : ajustez le curseur ou saisissez une valeur comprise entre 1 et 4.
- Durée de la vidéo : sélectionnez 8, 7, 6 ou 5 secondes.
Facultatif : dans la section Sécurité, sélectionnez l'un des paramètres de génération de personnes suivants :
Autoriser (adultes uniquement) : valeur par défaut. Permet de générer uniquement des personnes ou des visages adultes. Ne permet pas de générer des visages ni des personnes représentant des enfants ou des adolescents.
Ne pas autoriser : ne permet pas de générer des personnes ni des visages.
Facultatif : dans la section Options avancées, saisissez une valeur de graine pour générer des vidéos aléatoires.
Dans la zone Prompt, saisissez votre prompt textuel décrivant les vidéos à générer.
Cliquez sur Exécuter.
REST
Pour en savoir plus sur l'API Veo, consultez la documentation de l'API Veo sur Gemini Enterprise Agent Platform.
Utilisez les commandes suivantes 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: chaîne représentant l'ID du modèle à utiliser. Les modèles suivants sont acceptés : -
TEXT_PROMPT: prompt textuel utilisé pour guider la génération de vidéos. -
BASE64_ENCODED_IMAGE: image de style encodée en octets base64. -
IMAGE_MIME_TYPE: type MIME de l'image d'entrée. Un seul des éléments suivants :image/jpegimage/png
-
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. Par 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. -
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 mode Paysage"9:16"pour le mode 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 qui contrôle le paramètre de sécurité pour la génération de personnes ou de visages. Vous pouvez utiliser les valeurs suivantes :-
"allow_adult": autoriser uniquement 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 qui contrôle 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 est comprise entre1et4. -
SEED_NUMBER: Facultatif. Valeur uint32 que le modèle utilise pour générer des vidéos déterministes. Si vous spécifiez un numéro source avec votre requête sans modifier d'autres paramètres, vous indiquez au modèle de produire les mêmes vidéos. La plage de valeurs acceptée est comprise entre0et4294967295.
-
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", "referenceImages": [ { "image": { "bytesBase64Encoded": "BASE64_ENCODED_IMAGE", "mimeType": "IMAGE_MIME_TYPE" }, "referenceType": "style" } ] } ], "parameters": { "durationSeconds": 8, "storageUri": "OUTPUT_STORAGE_URI", "sampleCount": RESPONSE_COUNT } }Pour envoyer votre requête, choisissez l'une des options suivantes :
Cette requête renvoie un nom d'opération complet avec un ID d'opération unique. Utilisez ce nom d'opération complet pour interroger l'état de la demande de génération de vidéo.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" }-
Facultatif : vérifiez l'état de l'opération de longue durée de génération de la vidéo.
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.
- OPERATION_ID : ID d'opération unique renvoyé dans la requête de génération de vidéo d'origine.
Méthode HTTP et URL :
POST https://us-central1-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/publishers/google/models/MODEL_ID:fetchPredictOperation
Corps JSON de la requête :
{ "operationName": "projects/PROJECT_ID/locations/us-central1/publishers/google/models/MODEL_ID/operations/OPERATION_ID" }Pour envoyer votre requête, choisissez l'une des options suivantes :
Cette requête renvoie des informations sur l'opération, y compris si elle est toujours en cours d'exécution ou si elle est terminée.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:fetchPredictOperation"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:fetchPredictOperation" | Select-Object -Expand Content