Veo ofrece una herramienta de mejora de instrucciones basada en LLM, también conocida como reescritor de instrucciones. El reescritor de instrucciones ofrece la opción de reescribir tus instrucciones para agregar descripción de video, movimientos de cámara, transcripción y efectos de sonido a tu instrucción. Las instrucciones más detalladas dan como resultado videos de mayor calidad.
Si inhabilitas la mejora de instrucciones, es posible que se vea afectada la calidad de los videos y la similitud del resultado con la instrucción que proporcionaste. Esta función está habilitada de forma predeterminada para veo-2.0-generate-001.
La respuesta de la API entrega una instrucción reescrita solo si la instrucción original tiene menos de 30 palabras.
Para obtener más información sobre cómo escribir instrucciones de texto eficaces para la generación de videos, consulta la guía de instrucciones de Veo.
Antes de comenzar
-
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 la autenticación para tu entorno.
Selecciona la pestaña según cómo planeas usar las muestras en esta página:
Console
Cuando usas la Cloud de Confiance consola de para acceder a los Cloud de Confiance by S3NS servicios y las APIs, no necesitas configurar la autenticación.
REST
Para usar las muestras de la API de REST incluidas en esta página en un entorno de desarrollo local, debes usar las credenciales que proporciones a la gcloud CLI.
Instala Google Cloud CLI y, luego, accede a gcloud CLI con tu identidad federada.
Para obtener más información, consulta Autentícate para usar REST en la documentación de autenticación de. Cloud de Confiance
Desactiva el reescritor de instrucciones
Para desactivar la mejora de instrucciones, haz lo siguiente:
Console
En la Cloud de Confiance consola, ve a la página Agent Platform Studio > Media Studio.
Haz clic en Veo.
En Configuración, haz clic en el botón de alternancia Habilitar la mejora de instrucciones.
En el cuadro Escribe tu instrucción, ingresa tu instrucción y, luego, haz clic en Generar.
Python
Instalar
pip install --upgrade google-genai
Para obtener más información, consulta la documentación de referencia del SDK.
Configura las variables de entorno para usar el SDK de IA generativa de Google 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
Para obtener más información sobre la API de Veo, consulta lo siguiente:
- Método:
endpoints.predict VideoGenerationModelInstanceVideoGenerationModelParamsVideoGenerationModelResult
- Usa el siguiente comando para enviar una solicitud de generación de video. Esta solicitud inicia una operación de larga duración y almacena el resultado en un bucket de Cloud Storage que especifiques.
Antes de usar cualquiera de los datos de solicitud a continuación, realiza los siguientes reemplazos:
- PROJECT_ID: Tu Cloud de Confiance by S3NS ID del proyecto.
- MODEL_ID: El ID del modelo que se usará Valores disponibles:
veo-2.0-generate-001
- TEXT_PROMPT: La instrucción de texto que se usa para guiar la generación de video
-
OUTPUT_STORAGE_URI: Es el bucket de Cloud Storage para
almacenar los videos de salida (opcional). Si no se proporciona, los bytes de video se muestran en la
respuesta. Por ejemplo:
gs://video-bucket/output/. - RESPONSE_COUNT: La cantidad de archivos de video que deseas generar Valores de números enteros aceptados: de 1 a 4
- DURATION: La duración de los archivos de video que deseas generar Los valores de números enteros aceptados son de 5 a 8.
-
ENHANCED_PROMPT: Indica si se deben usar instrucciones mejoradas o no. Puedes usar una de las siguientes opciones:
-
True: (predeterminado) usa Gemini para mejorar tus instrucciones. -
False: No uses Gemini para mejorar tus instrucciones.
-
-
Parámetros opcionales adicionales
Usa las siguientes variables opcionales según tu caso de uso. Agrega algunos o todos los siguientes parámetros en el objeto
"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: Es un valor de cadena que describe la relación de aspecto de los videos generados (opcional) . Puedes usar los siguientes valores:"16:9"para horizontal"9:16"para vertical
El valor predeterminado es
"16:9". -
NEGATIVE_PROMPT: Es un valor de cadena que describe el contenido que deseas evitar que genere el modelo (opcional). -
PERSON_SAFETY_SETTING: Es un valor de cadena que controla la configuración de seguridad para generar personas o rostros (opcional). Puedes usar los siguientes valores:-
"allow_adult": Solo permite la generación de personas y rostros adultos. -
"disallow": No genera personas ni rostros.
El valor predeterminado es
"allow_adult". -
-
RESOLUTION: Es un valor de cadena que controla la resolución del video generado (opcional). Solo es compatible con modelos Veo 3. Puedes usar los siguientes valores:"720p""1080p""4k"(solo modelos de la versión preliminar de Veo 3.1)
El valor predeterminado es
"720p". -
RESPONSE_COUNT: Opcional. El rango de valores aceptado es `1`-`4`. `SEED_NUMBER`: Es un valor uint32 que usa el modelo para generar videos deterministas (opcional). El rango de valores aceptado es1-4. -
SEED_NUMBER: Opcional. El rango de valores aceptado es `0`-`4294967295`. Especificar un número semilla con su solicitud sin cambiar otros parámetros guía al modelo para producir los mismos videos. El rango de valores aceptado es0-4294967295.
-
Para enviar tu solicitud, elige una de estas opciones:
POST https://us-central1-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/publishers/google/models/MODEL_ID:predictLongRunning
Cuerpo JSON de la solicitud:
{
"instances": [
{
"prompt": "TEXT_PROMPT"
}
],
"parameters": {
"storageUri": "OUTPUT_STORAGE_URI",
"sampleCount": "RESPONSE_COUNT",
"durationSeconds": "DURATION",
"enhancePrompt": ENHANCED_PROMPT
}
}
Para enviar tu solicitud, elige una de estas opciones:
curl
Guarda el cuerpo de la solicitud en un archivo llamado request.json y ejecuta el siguiente comando:
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
Guarda el cuerpo de la solicitud en un archivo llamado request.json,
y ejecuta el siguiente comando:
$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"
}