Readme
Technical Specifications & Usage Guide
Input Compatibility
Ensure your input files meet the following criteria to avoid processing errors.
| Category | Supported Standards |
|---|---|
| Containers | .mp4, .mov, .webm, .avi, .gif |
| Codecs | H.264, H.265 (HEVC), VP9, AV1, PhotoJPEG |
Attribute Preservation
The model is designed to respect the integrity of your original file. The following attributes are preserved in the output: * Visuals: Aspect Ratio and Resolution (1:1 match). * Timing: Frame Rate. * Audio: Passthrough (if present).
Background & Transparency Control
The model allows you to define the background behavior using the background_color parameter.
- Format: Must be a predefined string value (e.g.,
Transparent,White,Black, etc.). - Unsupported: Hex codes (e.g.,
#FFFFFF) are not supported. - Default:
Transparent.
Transparency Constraints
If you set background_color to Transparent, you must ensure your selected output format supports an alpha channel.
Error 422 (Unprocessable Entity): Will occur if
background_coloris set toTransparentbut the output preset does not support alpha (e.g., selectingmp4_h264).
Output Preset Compatibility Table
| Output Preset | Alpha Channel Support? | Notes |
|---|---|---|
webm_vp9 |
✅ Yes | Recommended for Web |
mov_proresks |
✅ Yes | High quality, large file size |
mkv_vp9 |
✅ Yes | |
mkv_raw |
✅ Yes | |
gif |
✅ Yes | |
mov_h265 |
✅ Yes | Only when encoded as HEVC with Alpha |
mp4_h264 |
❌ No | Standard MP4 |
mp4_h265 |
❌ No | Standard HEVC |
mkv_h264 |
❌ No | |
mkv_h265 |
❌ No | |
avi_h264 |
❌ No |
Limits & Constraints
Please adhere to the following limits to ensure successful processing.
Duration
- Maximum: 60 seconds per input file.
Resolution
- Maximum: 16,000 x 16,000 pixels (16K).
- Error 413 (Payload Too Large): Returned if the input resolution exceeds the 16K limit.
- Output: The output resolution will strictly match the input resolution.
Model created
Model updated