CoreIX overview
CoreIX is Bitiful's in-house, high-performance, real-time media processing engine.
For images, videos, and other media stored in S4 object storage, append processing parameters to the end of the URL (or pass them in a GetObject request) and get the processed result in real time. Processing never modifies the original object in your bucket.
Note CoreIX is currently in beta and free of charge. The billing start date and pricing will be announced separately, so keep an eye on our announcements.
Quickstart
Add parameters to the end of a media file's URL:
Original image: https://demo.bitiful.com/girl.jpegWith processing parameters: https://demo.bitiful.com/girl.jpeg?w=800&h=500&pos=top

You can combine multiple parameters freely, for example to resize, add a watermark, and convert the format in a single request.
Key features
- Exceptional performance: Up to 10x faster or more than mainstream image processing services in China.
- End-to-end HDR: HDR photos and videos stay HDR after cropping, resizing, and watermarking, and can be mapped to SDR with a single parameter.
- Professional color management: Accurately handles color spaces such as CMYK, Display P3, and Adobe RGB.
- Very large images: Supports images up to 200 MB.
- Content awareness: Automatically detects and preserves faces, people, pets, and the main subject when cropping. It can also blur faces automatically and pick video cover frames.
- Broad format coverage: Natively supports camera RAW, SVG, PDF, OpenEXR, JPEG XL, and more. See Supported formats.
- Live Photos: Extracts the still image and video from Live Photos (motion photos) on iOS and major Android brands, and converts between them.
- Video and animated images: Extract frames from and clip videos, and convert between video and animated images.
- Built-in image analysis: Text recognition (OCR), color palettes, perceptual hashes, content labels, similar-image features, and BlurHash and ThumbHash placeholders.
- Quantized compression:
fmt=tpngdelivers compression similar to TinyPNG.
Automatic optimizations
Before applying the parameters you specify, CoreIX performs a set of automatic optimizations that balance visual accuracy against data transfer savings:
- Auto-orientation: Rotates images based on their Exif orientation. Supports JPEG, PNG, WebP, AVIF, HEIF, and major camera RAW formats.
- Metadata stripping: Removes Exif data that is useless when sharing images, saving up to about
500 KiB. - Automatic color management: Performs any necessary color space conversion when generating thumbnails and slims down the color profile, saving up to about
2.5 MiBfor images in uncommon color spaces. - HDR preservation: HDR sources produce HDR output by default. Add
hdr-rate=0to map to SDR without a washed-out look. - Format negotiation:
fmt=autopicks JPEG XL, AVIF, or WebP based on what the browser supports. If you explicitly request a format the browser doesn't support, CoreIX falls back automatically. - Smart lossless: Images with few colors, such as icons and screenshots, are automatically encoded with a lossless palette, making them smaller without any quality loss.
Feature overview
Size and cropping
| Feature | Key parameters | Description | Applies to |
|---|---|---|---|
| Resize images | w h dpr mode | Proportional resize, crop, pad, or stretch | All |
| Smart crop | pos | Keep a given position when cropping, or automatically keep faces and the main subject | All |
| Custom crop | rect | Extract any rectangular region by coordinates | Images |
| Trim borders | trim | Automatically remove solid-color or transparent borders | Still images |
| Shapes and canvas | flip border pad box mask | Flip, borders, padding, color blocks, rounded corners, and circles | Images |
Quality and color
| Feature | Key parameters | Description | Applies to |
|---|---|---|---|
| Output quality | q | Adjust the compression quality of lossy formats | All |
| Sharpen images | sharp usm | Improve sharpness | Still images |
| Blur images | blur px | Blur and pixelate | Still images |
| Color adjustment and auto enhance | enhance bri con sat, and more | Enhance images in one step, or manually adjust brightness, contrast, saturation, and more | Images |
| Color management | cs | Set the output color space | Still images |
| HDR processing | hdr-rate hdr-fmt | Control HDR brightness and output form, or convert to SDR | Images, video |
Watermarks
| Feature | Key parameters | Description | Applies to |
|---|---|---|---|
| Text watermarks | txt | Fonts, color, stroke, shadow, background box, line breaks, rotation, and tiling | Still images |
| Image watermarks | mark | Bitmap or SVG watermarks, with tiling and blend modes | Still images |
| SVG template watermarks | mark + txt | Fill text into an SVG template dynamically for multiple text blocks and complex layouts | Still images |
| Watermark fonts | txt-font | List of available fonts | – |
Privacy
| Feature | Key parameters | Description | Applies to |
|---|---|---|---|
| Face blurring | face-blur face-pixel | Automatically detect faces and blur or pixelate them | Still images |
Video and animated images
| Feature | Key parameters | Description | Applies to |
|---|---|---|---|
| Extract frames from video and animations | frame | Capture a frame by timestamp or frame index, or automatically pick a cover frame | Video, animated images |
| Clip video and convert to animations | frame range | Clip videos, extract animated segments, and convert between video and animated images | Video, animated images |
Video processing works only on files already stored in S4 object storage. For mirrored origin fetch, it takes effect only after the file has been fetched from origin successfully.
Formats and analysis
| Feature | Key parameters | Description | Applies to |
|---|---|---|---|
| Image format conversion | fmt | JPEG, PNG, WebP, AVIF, JPEG XL, HEIC, GIF, and more, or automatic selection | All |
| Image analysis | fmt | Color palettes, perceptual hashes, face positions, content labels, aesthetic scores, and feature vectors | Images |
| Supported formats | – | Recognized input formats and what each format supports | – |