掌握 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 調用，註冊即可使用