Lección 28 · 15 min · Gratis

Primeros pasos con Veo

Copyright 2026 Google LLC.

# @title Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
# https://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.

Si estás leyendo este notebook en Github, ábrelo en Colab haciendo clic en el botón de arriba para ver los videos generados.

Nota: Veo es una función de pago. Este notebook no se ejecutará con la versión gratuita. (Consulta precios para más detalles).

# Change that value if you want to run the colab
I_am_aware_that_veo_is_a_paid_feature = False # @param {type:"boolean"}

¿Qué es Veo?

Veo permite a los creadores generar videos de alta calidad con detalles increíbles, artefactos mínimos y duraciones extendidas en resoluciones de hasta 1080p. Veo es compatible con la conversión de texto a video y de imágenes a video.

Con Veo 3, puedes crear videos con:

  • Comprensión avanzada del lenguaje: Veo comprende profundamente el lenguaje natural y la semántica visual, capturando los matices y el tono de prompts complejos para renderizar detalles intrincados en escenas extendidas, incluyendo términos cinematográficos como "timelapse" o "tomas aéreas".
  • Control creativo sin precedentes: Veo ofrece un nivel de control creativo sin precedentes, comprendiendo prompts para todo tipo de efectos cinematográficos, como timelapses o tomas aéreas de un paisaje.
  • Videos con audio: Veo 3 genera videos con audio automáticamente, sin esfuerzo adicional por parte del desarrollador.
  • Controles de video más precisos: Veo 3 es más preciso en la iluminación, la física y los controles de cámara.

Veo 3.1 trae nuevas capacidades:

La familia de modelos Veo 3 incluye Veo 3/3.1, Veo 3.1 Lite y Veo 3/3.1 Fast, que son versiones más rápidas y accesibles de los modelos. Los modelos Veo Lite y Fast son ideales para servicios de backend que generan anuncios programáticamente, herramientas para pruebas A/B rápidas de conceptos creativos o aplicaciones que necesitan producir contenido para redes sociales rápidamente. Veo 3.1 Lite es particularmente rentable, optimizado para la generación de video de alta capacidad de procesamiento en 720p y 1080p.

La seguridad es un enfoque central, con medidas robustas para prevenir contenido inapropiado o dañino, y todos los videos generados están marcados digitalmente con SynthID de Google DeepMind.

Ten en cuenta que la generación de modelos anterior, Veo 2, todavía está disponible para desarrolladores a través de la API de Gemini por un tiempo. Sin embargo, a diferencia de Veo 3, los videos generados por Veo 2 no contienen audio.

Configuración

Instalar el SDK

Instala el SDK desde PyPI.

%pip install -U -q "google-genai>=2.9.0" # Minimum version 1.44 for video extension # 2.0 is needed to use the interactions API
     ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 45.3/45.3 kB 1.1 MB/s eta 0:00:00
   ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 237.3/237.3 kB 13.4 MB/s eta 0:00:00
[?25h

Configura tu clave de API e inicializa el cliente

Para ejecutar la siguiente celda, tu clave de API debe estar almacenada en un Secreto de Colab llamado GEMINI_API_KEY. Si aún no tienes una clave de API, o no estás seguro de cómo crear un Secreto de Colab, consulta Autenticación image para ver un tutorial.

from google.colab import userdata
from google import genai
from google.genai import types

GEMINI_API_KEY = userdata.get('GEMINI_API_KEY')
client = genai.Client(api_key=GEMINI_API_KEY)

Selecciona el modelo Veo

VEO_MODEL_ID = "veo-3.1-lite-generate-preview" # @param ["veo-3.1-generate-preview", "veo-3.1-fast-generate-preview", "veo-3.1-lite-generate-preview"] {"allow-input":true, isTemplate: true}

Texto a video

Describe la escena que deseas, ya sea creada por ti o con la ayuda de Gemini, y Veo 3 la hará realidad.

Consejos de prompting para Veo

Para aprovechar al máximo Veo, considera incorporar terminología de video específica en tus prompts. Veo comprende una amplia gama de términos relacionados con:

  • Composición de la toma: Especifica el encuadre y el número de sujetos en la toma (por ejemplo, "toma única", "toma de dos", "toma por encima del hombro").
  • Posicionamiento y movimiento de la cámara: Controla la ubicación y el movimiento de la cámara usando términos como "a la altura de los ojos", "ángulo alto", "ángulo bajo", "dolly shot", "zoom shot", "pan shot" y "tracking shot".
  • Efectos de enfoque y lente: Usa términos como "enfoque superficial", "enfoque profundo", "enfoque suave", "lente macro" y "lente gran angular" para lograr efectos visuales específicos.
  • Estilo general y tema: Guía la dirección creativa de Veo especificando estilos como "ciencia ficción", "comedia romántica", "película de acción" o "animación". También puedes describir los sujetos y fondos que deseas, como "paisaje urbano", "naturaleza", "vehículos" o "animales".

Consulta la guía de prompts de Veo para más detalles y consejos.

Parámetros opcionales

El prompt es el único parámetro obligatorio, los demás son todos opcionales.

  • negative_prompt: Lo que no quieres ver en el video.
  • person_generation: Dile a tu modelo si se le permite generar adultos en los videos o no. Los niños siempre están bloqueados.
  • duration_seconds: 4, 6 u 8 segundos con Veo 3.1 (siempre 8 segundos para Veo 3 y 7 segundos al extender).
  • aspect ratio: Ya sea 16:9 (horizontal) o 9:16 (vertical).
  • resolution: Ya sea 720p o 1080p.

Más detalles sobre cada parámetro en la sección relacionada de la documentación.

Crea un video a partir de un simple prompt de texto

La generación del video tarda aproximadamente un minuto.

if not I_am_aware_that_veo_is_a_paid_feature:
  print("Veo is a paid feature. Please change the variable 'I_am_aware_that_veo_is_a_paid_feature' to True if you are okay with paying to run it.")

else:
  import time

  prompt = "a close-up shot of a golden retriever playing in a field of sunflowers" # @param {type: "string"}

  # Optional parameters
  negative_prompt = "barking, woofing" # @param {type: "string"}
  aspect_ratio = "16:9" # @param ["16:9","9:16"]
  resolution = "1080p" # @param ["720p","1080p"]

  operation = client.models.generate_videos(
      model=VEO_MODEL_ID,
      prompt=prompt,
      config=types.GenerateVideosConfig(
        aspect_ratio=aspect_ratio,
        resolution=resolution,
        negative_prompt=negative_prompt,
      ),
  )

  # Waiting for the video(s) to be generated
  while not operation.done:
      time.sleep(20)
      operation = client.operations.get(operation)
      print(operation)

  print(operation.result.generated_videos)

  for n, generated_video in enumerate(operation.result.generated_videos):
    client.files.download(file=generated_video.video)
    generated_video.video.save(f'video{n}.mp4') # Saves the video(s)
    display(generated_video.video.show()) # Displays the video(s) in a notebook
Consejo: Webhooks

Gemini es compatible con Webhooks para procesar las finalizaciones de forma asíncrona. En lugar de llamar continuamente a las operaciones GET /, suscríbete a video.generated directamente para permitir que la API de Gemini envíe notificaciones en tiempo real a tu servidor cuando las operaciones asíncronas o de larga duración se completen.

Consulta el cookbook de Webhooks para ver un tutorial detallado.

webhook = client.webhooks.create(
    name="MyVideoGenerationWebhook",
    subscribed_events=["video.generated"],
    uri="https://my-api.com/gemini-callback",
)

print(f"Created webhook: {webhook}")
Mira una generación de muestra 🎥

🍿 El video que generarás será similar a este: Un golden retriever jugando en un campo de girasoles.

Lección del curso «Gemini API Cookbook (quickstarts)» de Google, publicado con licencia Apache 2.0. Traducción y adaptación al español de IA con Clase. IA con Clase no está afiliado a Google. Ver el original · Licencia
Esta lección es gratuita. El resto del curso se abre con la Membresía de IA con Clase, que incluye todos los cursos del catálogo. Ver precios