Skip to content
Console

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.jpeg

With processing parameters: https://demo.bitiful.com/girl.jpeg?w=800&h=500&pos=top

Resized, keeping the top

You can combine multiple parameters freely, for example to resize, add a watermark, and convert the format in a single request.

Key features

  1. Exceptional performance: Up to 10x faster or more than mainstream image processing services in China.
  2. 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.
  3. Professional color management: Accurately handles color spaces such as CMYK, Display P3, and Adobe RGB.
  4. Very large images: Supports images up to 200 MB.
  5. 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.
  6. Broad format coverage: Natively supports camera RAW, SVG, PDF, OpenEXR, JPEG XL, and more. See Supported formats.
  7. Live Photos: Extracts the still image and video from Live Photos (motion photos) on iOS and major Android brands, and converts between them.
  8. Video and animated images: Extract frames from and clip videos, and convert between video and animated images.
  9. Built-in image analysis: Text recognition (OCR), color palettes, perceptual hashes, content labels, similar-image features, and BlurHash and ThumbHash placeholders.
  10. Quantized compression: fmt=tpng delivers 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 MiB for images in uncommon color spaces.
  • HDR preservation: HDR sources produce HDR output by default. Add hdr-rate=0 to map to SDR without a washed-out look.
  • Format negotiation: fmt=auto picks 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

FeatureKey parametersDescriptionApplies to
Resize imagesw h dpr modeProportional resize, crop, pad, or stretchAll
Smart cropposKeep a given position when cropping, or automatically keep faces and the main subjectAll
Custom croprectExtract any rectangular region by coordinatesImages
Trim borderstrimAutomatically remove solid-color or transparent bordersStill images
Shapes and canvasflip border pad box maskFlip, borders, padding, color blocks, rounded corners, and circlesImages

Quality and color

FeatureKey parametersDescriptionApplies to
Output qualityqAdjust the compression quality of lossy formatsAll
Sharpen imagessharp usmImprove sharpnessStill images
Blur imagesblur pxBlur and pixelateStill images
Color adjustment and auto enhanceenhance bri con sat, and moreEnhance images in one step, or manually adjust brightness, contrast, saturation, and moreImages
Color managementcsSet the output color spaceStill images
HDR processinghdr-rate hdr-fmtControl HDR brightness and output form, or convert to SDRImages, video

Watermarks

FeatureKey parametersDescriptionApplies to
Text watermarkstxtFonts, color, stroke, shadow, background box, line breaks, rotation, and tilingStill images
Image watermarksmarkBitmap or SVG watermarks, with tiling and blend modesStill images
SVG template watermarksmark + txtFill text into an SVG template dynamically for multiple text blocks and complex layoutsStill images
Watermark fontstxt-fontList of available fonts–

Privacy

FeatureKey parametersDescriptionApplies to
Face blurringface-blur face-pixelAutomatically detect faces and blur or pixelate themStill images

Video and animated images

FeatureKey parametersDescriptionApplies to
Extract frames from video and animationsframeCapture a frame by timestamp or frame index, or automatically pick a cover frameVideo, animated images
Clip video and convert to animationsframe rangeClip videos, extract animated segments, and convert between video and animated imagesVideo, 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

FeatureKey parametersDescriptionApplies to
Image format conversionfmtJPEG, PNG, WebP, AVIF, JPEG XL, HEIC, GIF, and more, or automatic selectionAll
Image analysisfmtColor palettes, perceptual hashes, face positions, content labels, aesthetic scores, and feature vectorsImages
Supported formats–Recognized input formats and what each format supports–