Platform For AI:EasyAnimate を使用して高精細・長尺動画の生成

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

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

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

サービス URL とトークンを取得するには、[Service Details] ページで、[Call Information] セクションの [View Call Information] をクリックします。

サービスを呼び出して動画を生成します。以下は 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("サービス URL (service_url) とトークンは空にできません")
        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. サービス情報を設定します。プレースホルダーを実際のサービスエンドポイントとトークンに置き換えます。環境変数として設定することをお勧めします。
        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}")

次の表に、サービスインターフェイスの入力パラメーターを示します。