掌握 Veo 3.1 扩展视频 API：7 秒增量延长生成 148 秒长视频完整指南

from google import genai
import time
import os

class Veo31VideoExtender:
    """Veo 3.1 视频扩展器 - 支持最长 148 秒视频生成"""

    def __init__(self, api_key: str):
        self.client = genai.Client(api_key=api_key)
        self.model = "veo-3.1-generate-preview"
        self.max_extensions = 20  # 最大扩展次数
        self.extension_duration = 7  # 每次扩展 7 秒

    def generate_initial_video(self, prompt: str, aspect_ratio: str = "16:9"):
        """生成初始视频"""
        print(f"[1/2] 生成初始视频...")
        print(f"    提示词: {prompt[:50]}...")

        operation = self.client.models.generate_videos(
            model=self.model,
            prompt=prompt,
            config={
                "aspect_ratio": aspect_ratio,
                "number_of_videos": 1
            }
        )

        video = self._wait_for_completion(operation)
        print(f"    初始视频生成完成 (8秒)")
        return video

    def extend_video(self, video, prompt: str, target_duration: int = 148):
        """
        扩展视频到目标时长

        Args:
            video: 输入视频对象
            prompt: 扩展提示词
            target_duration: 目标时长(秒),最大 148 秒

        Returns:
            扩展后的视频对象
        """
        # 计算需要的扩展次数
        initial_duration = 8
        needed_duration = target_duration - initial_duration
        extensions_needed = min(
            (needed_duration + self.extension_duration - 1) // self.extension_duration,
            self.max_extensions
        )

        print(f"[2/2] 开始视频扩展...")
        print(f"    目标时长: {target_duration}秒")
        print(f"    需要扩展: {extensions_needed}次")

        current_video = video
        current_duration = initial_duration

        for i in range(extensions_needed):
            print(f"    扩展进度: {i+1}/{extensions_needed}")

            operation = self.client.models.generate_videos(
                model=self.model,
                prompt=prompt,
                video=current_video
            )

            current_video = self._wait_for_completion(operation)
            current_duration += self.extension_duration

            print(f"    当前时长: {current_duration}秒")

        final_duration = min(current_duration, 148)
        print(f"视频扩展完成! 最终时长: {final_duration}秒")
        return current_video

    def _wait_for_completion(self, operation, check_interval: int = 30):
        """等待操作完成"""
        while not operation.done:
            time.sleep(check_interval)
            operation = self.client.operations.get(operation)

        if operation.result.generated_videos:
            return operation.result.generated_videos[0]
        raise Exception("视频生成失败")

    def download_video(self, video, output_path: str):
        """下载视频到本地"""
        print(f"下载视频到: {output_path}")

        # 获取视频内容
        video_data = self.client.files.download(video.video)

        with open(output_path, 'wb') as f:
            f.write(video_data)

        print(f"下载完成! 文件大小: {os.path.getsize(output_path) / 1024 / 1024:.2f} MB")


# 使用示例
if __name__ == "__main__":
    # 初始化扩展器
    extender = Veo31VideoExtender(api_key="YOUR_API_KEY")

    # 生成初始视频
    initial_video = extender.generate_initial_video(
        prompt="夕阳下的海边,金色的阳光洒在波光粼粼的海面上,一艘帆船缓缓驶向远方",
        aspect_ratio="16:9"
    )

    # 扩展到 60 秒
    extended_video = extender.extend_video(
        video=initial_video,
        prompt="帆船继续前行,天空逐渐变成橙红色,海鸥在船边盘旋",
        target_duration=60
    )

    # 下载视频
    extender.download_video(extended_video, "extended_video_60s.mp4")

这通常是因为输入视频不是由 Veo 生成的。Gemini API 的 extend 功能仅支持 Veo 生成的视频作为输入。

解决方案:

1. 确保使用 Veo 3.1 生成原始视频
2. 检查视频格式是否为 MP4
3. 确认帧率是 24fps、分辨率是 720p/1080p
4. 通过 API易 apiyi.com 平台可以获取详细的错误诊断帮助

保持视频风格一致的关键在于提示词策略:

1. 延续原提示词: 在扩展提示词中使用与原视频相似的描述
2. 避免风格跳跃: 不要在扩展时加入新的视觉风格描述
3. 保持主体一致: 明确指出"同一个"主体继续动作
4. 场景渐变: 场景变化要循序渐进,不要突然切换

示例:

• 原始: "一只白色的猫在草地上玩耍"
• 扩展: "同一只白色的猫继续在草地上奔跑,追逐蝴蝶" ✅
• 扩展: "一只黑色的狗出现在画面中" ❌

理论上,经过多次扩展,视频可能会出现一定程度的质量漂移。但 Veo 3.1 在设计上已经针对这一问题进行了优化:

• 每次扩展都会参考原始风格特征
• 连续性建模确保动作流畅
• 分辨率保持在 720p 稳定输出

建议: 如果对质量要求极高,可以考虑在 10-15 次扩展后重新评估效果,通过 API易 apiyi.com 平台可以方便地进行多次测试对比。

生成的视频在 Google 服务器上保留 2 天。超过 2 天后,视频将被自动删除。

重要提醒:

• 扩展后的视频也被视为新生成的视频,同样只保留 2 天
• 建议在生成后立即下载到本地保存
• 使用代码中的 download_video 方法可以自动完成下载

目前 Veo 3.1 API 处于 Paid Preview 阶段,有以下获取途径:

1. Google AI Studio: 开发者可直接申请
2. Vertex AI: 企业用户通过 Google Cloud 控制台开通
3. API易 apiyi.com: 提供统一的 API 接口,支持 Veo 3.1 调用,注册即可使用