解決 Google Flow 無權訪問報錯的 3 種方案 – Veo 3.1 API 替代方案完整指南

import requests
import time
import os

class Veo31VideoGenerator:
    """Veo 3.1 視頻生成器 - 支持原生音頻"""

    def __init__（self， api_key）:
        self.api_key = api_key
        self.base_url = "https://api.apiyi.com/v1"  # API易 統一接口
        self.headers = {
            "Authorization": f"Bearer {api_key}"，
            "Content-Type": "application/json"
        }

    def text_to_video（self， prompt， aspect_ratio="16:9"， with_audio=True）:
        """
        文生視頻 （TEXT_2_VIDEO）

        Args:
            prompt: 視頻描述，可包含對話 （使用引號）
            aspect_ratio: "16:9" 橫屏 或 "9:16" 豎屏
            with_audio: 是否生成原生音頻

        Returns:
            dict: 包含 video_url 和 status 的結果
        """
        payload = {
            "model": "veo-3.1"，
            "mode": "TEXT_2_VIDEO"，
            "prompt": prompt，
            "aspect_ratio": aspect_ratio，
            "generate_audio": with_audio，
            "duration": 8
        }

        return self._submit_and_wait（payload）

    def first_last_frame_to_video（self， prompt， first_frame_url， last_frame_url）:
        """
        首尾幀控制生成 （FIRST_AND_LAST_FRAMES_2_VIDEO）

        Args:
            prompt: 視頻過渡描述
            first_frame_url: 第一幀圖片 URL
            last_frame_url: 最後一幀圖片 URL

        Returns:
            dict: 生成結果
        """
        payload = {
            "model": "veo-3.1"，
            "mode": "FIRST_AND_LAST_FRAMES_2_VIDEO"，
            "prompt": prompt，
            "first_frame": first_frame_url，
            "last_frame": last_frame_url，
            "duration": 8
        }

        return self._submit_and_wait（payload）

    def reference_to_video（self， prompt， reference_images）:
        """
        參考圖生成 （REFERENCE_2_VIDEO）

        Args:
            prompt: 視頻描述
            reference_images: 參考圖 URL 列表 （1-3 張）

        Returns:
            dict: 生成結果
        """
        if len（reference_images） > 3:
            raise ValueError（"最多支持 3 張參考圖"）

        payload = {
            "model": "veo-3.1"，
            "mode": "REFERENCE_2_VIDEO"，
            "prompt": prompt，
            "reference_images": reference_images，
            "duration": 8
        }

        return self._submit_and_wait（payload）

    def extend_video（self， previous_video_url， extension_prompt）:
        """
        場景擴展 - 基於上一個視頻的最後一幀繼續生成

        Args:
            previous_video_url: 上一個視頻的 URL
            extension_prompt: 擴展場景描述

        Returns:
            dict: 新視頻結果
        """
        payload = {
            "model": "veo-3.1"，
            "mode": "SCENE_EXTENSION"，
            "previous_video": previous_video_url，
            "prompt": extension_prompt，
            "duration": 8
        }

        return self._submit_and_wait（payload）

    def _submit_and_wait（self， payload， max_wait=300）:
        """提交任務並等待完成"""

        # 提交任務
        response = requests.post（
            f"{self.base_url}/videos/generations"，
            headers=self.headers，
            json=payload
        ）

        if response.status_code ！= 200:
            raise Exception（f"提交失敗: {response.text}"）

        task_id = response.json（）["id"]
        print（f"✅ 任務提交成功，ID: {task_id}"）

        # 輪詢等待
        start_time = time.time（）
        while time.time（） - start_time < max_wait:
            result = requests.get（
                f"{self.base_url}/videos/generations/{task_id}"，
                headers=self.headers
            ）.json（）

            status = result.get（"status"）

            if status == "completed":
                print（f"🎬 視頻生成完成！"）
                return {
                    "status": "success"，
                    "video_url": result["video_url"]，
                    "duration": result.get（"duration"， 8），
                    "resolution": result.get（"resolution"， "1080p"）
                }
            elif status == "failed":
                raise Exception（f"生成失敗: {result.get（'error'）}"）
            else:
                progress = result.get（"progress"， 0）
                print（f"⏳ 生成中... {progress}%"）

            time.sleep（5）

        raise TimeoutError（"生成超時，請稍後查詢結果"）


# ========== 使用示例 ==========

if __name__ == "__main__":
    # 初始化生成器
    generator = Veo31VideoGenerator（api_key="YOUR_API_KEY"）

    # 示例 1: 文生視頻 （帶對話音頻）
    result = generator.text_to_video（
        prompt='''
        一位年輕女性站在咖啡店櫃檯前，微笑着說："我要一杯拿鐵"。
        咖啡師點頭回應："好的，稍等"。
        背景是溫馨的咖啡店氛圍，輕柔的爵士樂。
        '''，
        aspect_ratio="16:9"，
        with_audio=True
    ）
    print（f"視頻地址: {result['video_url']}"）

    # 示例 2: 首尾幀控制 （精確構圖）
    result = generator.first_last_frame_to_video（
        prompt="鏡頭從特寫逐漸拉遠，展示整個城市天際線"，
        first_frame_url="https://example.com/closeup.jpg"，
        last_frame_url="https://example.com/skyline.jpg"
    ）

    # 示例 3: 生成長視頻 （多次擴展）
    clips = []

    # 生成第一個片段
    clip1 = generator.text_to_video（"日出時分，海面波光粼粼，一艘帆船緩緩駛來"）
    clips.append（clip1["video_url"]）

    # 擴展後續片段
    clip2 = generator.extend_video（clip1["video_url"]， "帆船靠近港口，漁民開始忙碌"）
    clips.append（clip2["video_url"]）

    clip3 = generator.extend_video（clip2["video_url"]， "漁民們滿載而歸，臉上洋溢着笑容"）
    clips.append（clip3["video_url"]）

    print（f"已生成 3 個連續片段: {clips}"）

API易 平臺通過官方渠道接入 Veo 3.1 能力，技術上與 Google 官方 API 完全一致。主要區別在於:

1. 訪問便捷性: 無需科學上網，國內直連訪問
2. 付費方式: 按量付費，無需訂閱 Google AI Pro
3. 接口格式: 提供 OpenAI 兼容格式，便於集成
4. 額度靈活: 不受 Google 每月 credits 限制

通過 API易 apiyi.com 可以獲取免費測試額度，快速驗證效果。

所有通過 Veo 3.1 生成的視頻都會包含 SynthID 隱形水印，這是 Google 用於標識 AI 生成內容的技術。這個水印:

• 肉眼不可見
• 不影響視頻畫質
• 可被專門檢測工具識別
• 符合 AI 內容標註規範

這是 Google 的安全措施，通過任何渠道調用 Veo 3.1 都會包含此水印。

優化提示詞是關鍵，建議包含以下要素:

• Google 官方: 生成後 2 天內需下載，否則會被刪除
• API易 平臺: 視頻永久保存在你的賬戶中，可隨時下載

根據 Google 服務條款，使用 Veo 3.1 生成的內容可用於商業用途，但需要:

1. 確保提示詞和參考圖不侵犯他人知識產權
2. 不生成違規內容 （暴力、色情等）
3. 遵守當地法律法規

API易 平臺同樣遵循這些規範。