使用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}")

服务接口输入参数说明如下：