Platform For AI：使用EasyAnimate產生高清長視頻

在服務詳情頁面，單擊查看WEB應用。

在WebUI介面選擇預訓練的模型路徑，其它參數按需配置即可。

單擊Generate（產生），等待大約5分鐘後，即可在右側查看或下載產生的視頻。

在服務詳情頁面的資源詳情地區，單擊查看調用資訊，擷取服務調用地址和Token。

調用服務，產生視頻。Python請求樣本如下：

import os
import requests
import json
import base64
from typing import Dict, Any


class EasyAnimateClient:
    """
    EasyAnimate EAS 服務 API 用戶端。
    """

    def __init__(self, service_url: str, token: str):
        if not service_url or not token:
            raise ValueError("服務地址 (service_url) 和 Token 不可為空")
        self.base_url = service_url.rstrip('/')
        self.headers = {
            'Content-Type': 'application/json',
            'Authorization': token
        }

    def update_model(self, model_path: str, edition: str = "v3", timeout: int = 300) -> Dict[str, Any]:
        """
        更新並載入指定的模型版本和路徑。

        Args:
            model_path: 模型在服務內的路徑, 如 "/mnt/models/Diffusion_Transformer/EasyAnimateV3-XL-2-InP-512x512"。
            edition: 模型版本，預設為 "v3"。
            timeout: 請求逾時時間（秒），模型載入較慢，建議設定較長時間。
        """
        # 1. 更新版本
        requests.post(
            f"{self.base_url}/easyanimate/update_edition",
            headers=self.headers,
            json={"edition": edition},
            timeout=timeout
        ).raise_for_status()

        # 2. 更新模型路徑並等待載入
        print(f"發送載入模型請求: {model_path}")
        response = requests.post(
            f"{self.base_url}/easyanimate/update_diffusion_transformer",
            headers=self.headers,
            json={"diffusion_transformer_path": model_path},
            timeout=15000
        )
        response.raise_for_status()
        return response.json()

    def generate_video(self, prompt_textbox: str, **kwargs) -> bytes:
        """
        根據提示詞產生視頻。

        Args:
            prompt: 英文正向提示詞。
            **kwargs: 其他選擇性參數，參考下方的參數說明表格。

        Returns:
            MP4 格式的視頻位元據。
        """
        payload = {
            "prompt_textbox": prompt_textbox,
            "negative_prompt_textbox": kwargs.get("negative_prompt",
                                                  "The video is not of a high quality, it has a low resolution..."),
            "width_slider": kwargs.get("width_slider", 672),
            "height_slider": kwargs.get("height_slider", 384),
            "length_slider": kwargs.get("length_slider", 144),
            "sample_step_slider": kwargs.get("sample_step_slider", 30),
            "cfg_scale_slider": kwargs.get("cfg_scale_slider", 6.0),
            "seed_textbox": kwargs.get("seed_textbox", 43),
            "sampler_dropdown": kwargs.get("sampler_dropdown", "Euler"),
            "generation_method": "Video Generation",
            "is_image": False,
            "lora_alpha_slider": 0.55,
            "lora_model_path": "none",
            "base_model_path": "none",
            "motion_module_path": "none"
        }

        response = requests.post(
            f"{self.base_url}/easyanimate/infer_forward",
            headers=self.headers,
            json=payload,
            timeout=1500
        )
        response.raise_for_status()

        result = response.json()
        if "base64_encoding" not in result:
            raise ValueError(f"API 返回格式錯誤: {result}")

        return base64.b64decode(result["base64_encoding"])


# --- 使用樣本 ---
if __name__ == "__main__":
    try:
        # 1. 佈建服務資訊，請替換為真實的服務調用地址和Token，建議將其設定為環境變數
        EAS_URL = "<eas-service-url>"
        EAS_TOKEN = "<eas-service-token>"

        # 2. 建立用戶端
        client = EasyAnimateClient(service_url=EAS_URL, token=EAS_TOKEN)

        # 3. 載入模型 (服務部署後，預設不會載入任何模型。在發起產生請求前，您必須至少調用一次update_model來指定要使用的模型。後續若需切換模型，則再次調用此方法。)
        client.update_model(model_path="/mnt/models/Diffusion_Transformer/EasyAnimateV3-XL-2-InP-512x512")

        # 4. 產生視頻
        video_bytes = client.generate_video(
            prompt_textbox="A beautiful cat playing in a sunny garden, high quality, detailed",
            width_slider=672,
            height_slider=384,
            length_slider=72,
            sample_step_slider=20
        )

        # 5. 儲存視頻檔案
        with open("api_generated_video.mp4", "wb") as f:
            f.write(video_bytes)
        print("視頻已成功儲存為 api_generated_video.mp4")

    except requests.RequestException as e:
        print(f"網路請求錯誤: {e}")
    except (ValueError, KeyError) as e:
        print(f"資料或參數錯誤: {e}")
    except Exception as e:
        print(f"發生未知錯誤: {e}")

服務介面輸入參數說明如下：