ZiZi Animation: install and use
Install once, connect your Aplovn account, and choose a model inside ZiZi Animation.
① Installation: where the files go
Download and extract the ZIP
Copy the entire folder below, including all files inside. Do not copy only main.py or the outer versioned ZIP folder.
Folder to copyaplovn_api_video_pluginOpen the ZiZi Animation installation folder
The folder containing
_internalis your installation root. Open_internal → plugins → video_pluginsand paste the plugin folder here:Destination, relative to the installation root[ZiZi installation]\_internal\plugins\video_plugins\After installation, this file must exist[ZiZi installation]\_internal\plugins\video_plugins\aplovn_api_video_plugin\main.pyFor example, if ZiZi is installed at D:\ZiZi, use D:\ZiZi\_internal\plugins\video_plugins\aplovn_api_video_plugin. Your drive letter and root folder can differ.
Updating an older copy: merge and replace the plugin files. Keep your user_resources configuration and the project's .aplovn_jobs folder so existing settings and task recovery remain available.Restart ZiZi Animation and select the plugin
Open the settings gear beside a storyboard's Generate video button, then open Video model management:
Custom plugins (自定义插件)→Current plugin (当前插件)→Aplovn API 视频生成The dark plugin panel shows version 0.1.2. If your host offers Import ZIP, you may use it instead of the folder method.
② Connect, choose settings, generate
Create your API Key
Sign in to Aplovn, open API / CLI and create a key with a budget. Copy it privately.
Click Connect (连接) in the plugin
Paste the key and connect. Your balance appears. Saved keys are loaded automatically on later use; no endpoint or model ID needs to be typed.
Select model and settings from the dropdowns
Choose Seedance 2.5, Seedance 2.0 or Wan 3.0, then resolution, duration and aspect ratio. Automatic storyboard-reference detection suits normal use. You may also explicitly select omni references, text-to-video or first/last frames.
Return to the storyboard and click Generate video
The generation button belongs to the storyboard; the plugin panel sets parameters. Select the prompt and references first. The plugin uploads selected files, checks the quote, waits for the task, downloads the completed video and returns it to the host.
Generation spends your Aplovn credits. The panel shows base consumption; reference video adds a duration-based charge. The website and plugin share one balance.
③ Help
The plugin is missing
Check the complete main.py path above, remove any accidental extra folder level, and restart the host. The host must support Python 3.10+ custom video plugins.
Can I reconnect or retry after an interruption?
Preserve the project's .aplovn_jobs folder. The plugin uses the saved operation identity to query the original task. Avoid deleting the record or changing parameters while recovering a task. A pending download can be retried without starting another generation.
Where are my credits and tasks?
Check Task history on Aplovn. A confirmed generation failure refunds the actual debit. Slow or unresolved tasks remain active while the original result is checked.
The plugin package remains version 0.1.2. Website language switching does not change the host application's language.