Skip to main content

Documentation Index

Fetch the complete documentation index at: https://bitiful-docs.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

CoreIX 是缤纷云自研的,具有高度 自动化智能化高兼容性高性能 实时 媒体处理引擎 S4 对象存储中的媒体内容可以简单地通过在 Url 末尾(或在 GetObject 接口中)携带相关 处理参数 轻松获得 CoreIX所有丰富功能
注意 当前处于测试阶段,暂不收费。收费时间及标准会另行通知,请您及时关注相应通知。

CoreIX 独有特点

  1. 超高性能:性能最多可达国内主流图片处理性能的 10 倍
  2. 独家支持颜色管理:国内唯一可准确处理 CMYK 色彩模式 的实时媒体引擎;
  3. 独家超大图处理:CoreIX 允许高性能处理 高达 200MB 的图片;
  4. 独家支持 HDR 视频截图:可以输出 HDR 图片,也可映射为 SDR 图片
  5. 独家画面感知能力:在必须裁剪画面时可 自动保留画面主体
  6. 独家原生支持 SVG:可以将 SVG 转成光栅图,也可作为 水印图
  7. 独家哈希占位支持:原生支持 ThumbhashBlurhash 码输出;
  8. 独家原生支持 RAW 格式:兼容主流 RAW 格式,并自动进行恰当的 Post-processing
  9. 独家支持量化压缩:CoreIX 支持 fmt=tpng 参数,可原生获得类似 TinyPNG 的处理效果;
  10. 独家 OCR 内置:CoreIX 会 自动优化图片并识别文字内容,无需编写复杂的代码调用第三方 API;

高度集成的自动优化:

  • 自适应方向:可依据原图的 Exif 信息对图片做自动的方向调整处理,支持带 Exif 信息的 Jpeg、PNG、Webp、Avif、Heif 和 主流相机 Raw 图;
  • 自动删减 Exif:在快速分享场景中,Exif 没有实际作用,去掉 Exif 可减少相应传输流量,此举最多可节省约 500 KiB 容量;
  • 自动颜色管理:CoreIX 生成缩略图时,会自动进行必要的颜色空间转换,然后删除 ICC profile,此举对于特殊色彩空间的图片最多可节省约 2.5 MiB 容量;

  • 可转换 Tinysrgb:对于包含 sRGB 的原图,在生成小号缩略图时,CoreIX 会自动用 Tinysrgb 替代,此举通常可节省 3 KiB 容量;
  • 自动支持 HDR:在对 HDR 视频进行截图(取帧)操作时,CoreIX 将默认自动输出 HDR 图片,指定 cs 参数为 srgb 时将自动把色彩空间映射为 SDR,避免出现灰图;
  • 高度集成:所有参数
  • 客户端协商机制:当设定输出格式为 fm=webp 时,系统将通过 Accept 判断客户端是否支持 webp 图片;

图片处理功能

  1. CoreIX 关心图片的最终分享效果,包括准确度与访问速度。所以在每次执行手动参数前,都会对图片做必要的自动优化,以最大程度达到处理效果节省流量的最佳平衡。
  2. CoreIX 在生成分享图时做实时处理,所有操作均不会造成对存储桶中原图的修改。

手动参数:

限制项相关参数作用说明范围
缩略宽高- w: 图片宽度
- h: 图片高度
将图片缩放至指定大小。全部
缩放倍数- dpr: 倍数值可简易设置 2x 3x 大小缩略尺寸。全部
缩略模式- mode: crop / clip当设定w、h全部指定且与原图比例不符时。 默认使用 crop 裁剪缩略模式。全部
保留位置- pos: 缩略裁剪模式情况下保留的部分缩略裁剪后提取的保留部分。全部
自定义裁剪- rect: 裁剪坐标与大小裁剪指定位置和大小的矩形图片。静图
质量变化- q: 质量百分比调整 JPG、GIF(动图)、WebP(动、静图)、Avif 格式图片的质量。全部
图像锐化- sharp: 锐化程度对图片进行锐化效果处理。静图
图像模糊- blur: 模糊程度对图片增加模糊效果。静图
文字水印- txt: 水印的文字内容详细参数静图
图片水印- mark: 水印图片的桶内路径详细参数静图
视频截图- frame: 毫秒数(视频)或 帧数(GIF)格式支持:MP4、MKV; 色彩支持:SDR 视频 / BT.2020/2100 色域 HDR 视频 * 注意:frame 只能对已经存入 S4 对象存储的文件生效 (镜像回源场景下回源成功后才会生效)动图 视频
色彩空间- cs: ColorSpace设定希望输出的色彩空间,支持:tinysrgb、srgb、adobe rgb静图
格式转换- fmt: 格式代号图片格式:jpeg、png、tpng、webp、bmp、avif、gif、tiff - 其他格式:blurhash、thumbhash、json(输出图片、视频信息)全部
自2024年1月1日起,将支持 GIF / WEBP 动图支持高性能缩略、裁剪处理

图片处理方法

直接在图片类型对象的 Url 末尾加上相应参数即可使用。

示例 URL 如下:

原图:https://demo.bitiful.com/girl.jpeg
加上处理参数后:https://demo.bitiful.com/girl.jpeg?w=800&h=500&pos=top girl.resize.jpg