Regular and transparent animation
Choose the right input workflow, understand Alpha Key previews, and export transparency without confusing it with background removal.
On this page
Choose the source workflow
| Goal | Source | Workflow |
|---|---|---|
| Keep a scene or photograph background | Ordinary image | Regular image animation |
| Animate an already isolated character | Images with meaningful alpha | Transparent asset animation / Alpha Key |
| Remove a complex background from ordinary footage | Opaque source video | Separate Studio export processing, when offered; not a Public API feature |
A PNG extension alone does not prove transparency. Check the actual alpha channel. Every image used by transparent generation, including an active last frame or reference image, must meet the requirement.
Why a preview may have a colored background
Alpha Key generation places the isolated subject over a temporary key-color background so the video model can animate it. The raw generated video can therefore look green or magenta and remain opaque.
Normal transparent preview and compatible transparent exports remove that temporary background. Downloading the raw generated video or an ordinary MP4 clip is not the same as downloading an alpha-bearing output.
Export the intended result
Select transparent PNG frames, an appropriate spritesheet or engine pack, WebM Alpha, or ProRes 4444. See output formats for what each file contains.
Inspect fine hair, semi-transparent edges, motion blur, and pixels close to the key color. Check against both light and dark backgrounds. Preview success is a useful check, not a guarantee that every frame has a perfect edge.
The Studio may offer color-key removal or AI matting for other sources. These are export operations with their own controls, costs, and availability. They are not interchangeable with starting from an alpha-bearing image.
Public API boundary
The public request supports video.transparency.mode values standard and alpha_key. Transparent export requires an Alpha Key source. The Public API does not expose arbitrary-image AI background removal, rembg, or a fallback matting service.
For an appropriate source, the relevant request fragment is:
{
"video": {"transparency": {"mode": "alpha_key", "key_selection": "auto"}},
"export": {
"output_formats": ["frames_zip"],
"transparent": {"enabled": true}
}
}
This is a fragment, not a complete create request: it still needs an input image and model-compatible options. Follow the API quickstart.
If the result looks wrong
- Opaque file: verify the selected output format and source mode, not just the filename.
- Colored raw video: choose a transparent export rather than the raw source.
- Missing subject edges: inspect input alpha, key-color overlap, and generated motion.
- Transparent output unavailable: check source eligibility and export entitlement.
Do not repeatedly regenerate before establishing whether the problem is the source, selection, export configuration, or viewing application.
Check inputs and destination compatibility
For tightly framed sources, consider input canvas. Check Alpha on every endpoint or reference. If encoded transparency displays incorrectly, use format compatibility and export troubleshooting.
Was this page helpful?
No search queries, code, or free text are collected. This switch controls documentation interactions only; general site analytics follow the privacy policy. Privacy policy