Platform For AI:Generate high-definition long videos using EasyAnimate

Service details ページで、View Web App をクリックします。

WebUI インターフェイスで、事前学習済みモデルのパスを選択します。必要に応じて他のパラメーターを構成します。

[生成] をクリックします。約 5 分後、生成された動画を右側で表示またはダウンロードできます。

[Service details] ページの [Resource Details] セクションで、[View Call Information] をクリックして、サービス エンドポイントとトークンを取得します。

サービスを呼び出して動画を生成できます。以下は Python リクエストの例です。

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


class EasyAnimateClient:
    """
    EasyAnimate EAS service API client.
    """

    def __init__(self, service_url: str, token: str):
        if not service_url or not token:
            raise ValueError("Service URL and token cannot be empty")
        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]:
        """
        Update and load the specified model version and path.

        Args:
            model_path: Path to the model within the service, such as "/mnt/models/Diffusion_Transformer/EasyAnimateV3-XL-2-InP-512x512".
            edition: Model version, default is "v3".
            timeout: Request timeout in seconds. Model loading is slow, so set a longer timeout.
        """
        # 1. Update edition
        requests.post(
            f"{self.base_url}/easyanimate/update_edition",
            headers=self.headers,
            json={"edition": edition},
            timeout=timeout
        ).raise_for_status()

        # 2. Update model path and wait for loading
        print(f"Sending model loading request: {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:
        """
        Generate a video based on the prompt.

        Args:
            prompt: Positive prompt in English.
            **kwargs: Optional parameters. See the parameter description table below.

        Returns:
            Video binary data in MP4 format.
        """
        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"Invalid API response format: {result}")

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


# --- Example usage ---
if __name__ == "__main__":
    try:
        # 1. Configure service information. Replace with your actual service URL and token. We recommend setting them as environment variables.
        EAS_URL = "<eas-service-url>"
        EAS_TOKEN = "<eas-service-token>"

        # 2. Create client
        client = EasyAnimateClient(service_url=EAS_URL, token=EAS_TOKEN)

        # 3. Load model (After service deployment, no model is loaded by default. You must call update_model at least once before generating videos. Call this method again to switch models.)
        client.update_model(model_path="/mnt/models/Diffusion_Transformer/EasyAnimateV3-XL-2-InP-512x512")

        # 4. Generate video
        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. Save video file
        with open("api_generated_video.mp4", "wb") as f:
            f.write(video_bytes)
        print("Video saved successfully as api_generated_video.mp4")

    except requests.RequestException as e:
        print(f"Network request error: {e}")
    except (ValueError, KeyError) as e:
        print(f"Data or parameter error: {e}")
    except Exception as e:
        print(f"Unexpected error: {e}")

サービス API の入力パラメーターを以下に示します。