What Types of Video Templates Are Supported by Pixelle-Video? A Complete Guide
Pixelle-Video supports three distinct template types—static, image, and video—organized by naming prefixes and resolution folders, with built-in portrait templates for AI-generated video backgrounds.
Pixelle-Video, an open-source AI video generation framework from AIDC-AI, provides a flexible template system for creating short-form videos. Understanding what types of video templates are supported by Pixelle-Video is essential for customizing your workflow and selecting the right approach for your content needs.
Template Type Families by Naming Prefix
Pixelle-Video uses a clear naming convention to distinguish three template families. Each prefix determines how media is handled during video generation:
| Prefix | Template Type | Media Behavior |
|---|---|---|
static_*.html |
Static templates | No AI-generated media; text-only rendering |
image_*.html |
Image templates | AI-generated image inserted as background |
video_*.html |
Video templates | AI-generated video used as dynamic background |
These naming rules are documented in the 模板命名规范 (Template Naming Specification) section of the user guide.
How Each Template Type Works
Static templates (static_*.html) are the simplest option. They render text overlays without calling any AI generation workflow, making them ideal for quick, low-cost videos where you don't need dynamic backgrounds.
Image templates (image_*.html) trigger the ComfyUI image-generation workflow. The resulting AI image is automatically inserted as the background layer, with text rendered on top.
Video templates (video_*.html) trigger the ComfyUI video-generation workflow. This produces fully dynamic AI-generated footage as the background, creating the most visually engaging results.
Built-In Video Templates
Pixelle-Video ships with two ready-to-use video templates located in the portrait size directory:
| Template File | Description |
|---|---|
templates/1080x1920/video_default.html |
Default dynamic template for portrait video |
templates/1080x1920/video_healing.html |
"Healing" style dynamic template for portrait video |
You can inspect these templates directly in the repository:
- [
video_default.html](https://github.com/AIDC-AI/Pixelle-Video/blob/main/templates/1080x1920/video_default.html) - [
video_healing.html](https://github.com/AIDC-AI/Pixelle-Video/blob/main/templates/1080x1920/video_healing.html)
Resolution-Based Organization
Templates are organized by resolution folders, which determine the final video orientation. This structure is documented in the 模板结构 (Template Structure) section.
| Size Folder | Orientation | Typical Use Case |
|---|---|---|
1080x1920 |
Portrait | TikTok, Douyin, Xiaohongshu short videos |
1920x1080 |
Landscape | YouTube, Bilibili, horizontal platforms |
1080x1080 |
Square | Instagram, WeChat Moments |
You can add custom video templates to any of these size directories following the video_*.html naming convention.
Summary
Pixelle-Video supports three core template types distinguished by naming prefixes:
- Static templates (
static_*.html) for text-only rendering without AI generation - Image templates (
image_*.html) for AI-generated image backgrounds via ComfyUI - Video templates (
video_*.html) for AI-generated video backgrounds via ComfyUI
The repository includes two built-in video templates for portrait format (video_default and video_healing), and you can create custom templates in any supported resolution folder.
Frequently Asked Questions
What is the difference between image and video templates in Pixelle-Video?
Image templates generate a single AI image as the background, while video templates generate full motion footage. Both use ComfyUI workflows, but video templates call the video-generation pipeline instead of the image-generation pipeline, resulting in dynamic backgrounds suitable for more engaging content.
Can I use custom resolutions for Pixelle-Video templates?
Yes. While the repository provides standard folders (1080x1920, 1920x1080, 1080x1080), you can create additional resolution directories. The template system is flexible—place your static_*.html, image_*.html, or video_*.html files in any resolution folder, and the rendering pipeline will process them accordingly.
How do I create a custom video template from scratch?
Create an HTML file with the video_ prefix in your desired resolution folder—for example, templates/1080x1920/video_custom.html. The template should define the text overlay structure and styling. When processed, Pixelle-Video will automatically trigger the ComfyUI video-generation workflow and insert the resulting AI video as your background layer.
Have a question about this repo?
These articles cover the highlights, but your codebase questions are specific. Give your agent direct access to the source. Share this with your agent to get started:
curl -s "https://instagit.com/install.md" Maintain an open-source project? Get it listed too →