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.
📢 政策调整预告
由于严重的滥用问题，S4 将做出以下调整
- 即日起，S4 对象存储 不再能直接绑定域名 对外服务，请 启用“静态 CDN”；
- 从 5 月 11 日起 S4 对象存储将进行单线程限速：
- 普通文件默认限速 5MB/s；
- 针对 “ipa/apk” 文件最高下载速度限制为 1MB/s；
- 预计从 5 月 15 日起，S4 对象存储 不能 直接对外提供 “ipa/apk” 下载服务，请启用“静态 CDN”；
请 启用 CDN 以获得更高的下载速度及资源加载性能
CoreIX V2.5 上线
很高兴，我们朝 做全球最好的图片实时处理 API 这一目标又迈出了新的一步。自 CoreIX 在业界第一次支持 PQ/HLG HDR 照片处理开始已过去 2 年，现推出“GainMap HDR”照片处理能力 —— CoreIX 默认会保留包含“HDR 增益图”的照片，并且无论原图是什么 GainMap 方案，CoreIX 都将努力转换成国际标准的 ISO 方案（仅 JPEG 格式输出），以寻求最大化的（显示设备、软件设备）显示兼容性。以下是 CoreIX V2.5 为你带来的全新能力：
- 兼容的GainMap格式：
- 苹果
Apple Raw 直出照片；
- 苹果
GainMap HDR HEIC 直出照片；
- 苹果
GainMap HDR JPEG 直出照片；
- 苹果旧式
GainMap HDR JPEG 直出照片；
- Adobe
GainMap HDR JPEG 后期照片；
- Google
UltraHDR JPEG 直出照片；
- ISO
GainMap JPEG 直出/后期照片；
- OPPO
高效 HEIC 直出照片；
- HDR 相关参数；
- 新增 hdr-rate 参数，限制 HDR 亮度（防止部分 HDR 照片过于刺眼），支持
绝对值 和 百分比 两种值，该参数仅对 GainMap HDR 有效；
- 绝对值：设置处理后照片的最大亮度（0.0 ~ 10.0），建议可以在晚上设置为 0.8 ~ 1.2 以缓解刺眼效果；
- 百分比：将处理后 HDR 照片的最大亮度保留为“原图的指定比例”，如：原图最大亮度为 2.0，
&hdr-rate=50% 时意味着处理后的照片最大亮度为 1.0
- 新增 mark-hdr-rate 参数，设置 GainMap HDR 照片中的水印亮度，传入值为
百分比，默认 50% —— 即：原图最高亮度的“一半”，防止水印过亮，破坏原图预期效果，该参数仅对 GainMap HDR 有效；
- 参数 cs 兼容 GainMap HDR 照片（cs=sdr 时，转换为 SDR 亮度照片）；
- 支持 PDF 转图片：现在 CoreIX 可以无缝支持 PDF 输入，将指定页数的内容转化成图片（frame 参数）
GainMap HDR 照片处理效果（图源自 小红书APP）
在 HDR 的软硬件环境下可以看到下面图片亮度的区别（推荐如：MacBook Pro、iPhone、iPad）因三大运营商网间结算至带宽成本及存储成本的大幅提升预计从 6 月 21 日起，官网按量计费价格调整如下：
CDN 海外节点 流量单价调整为（大陆地区价格不变）：
| 流量（GB） | 单价 |
|---|
0 ~ 10 | 与大陆流量共享 |
11 ~ 1000 | 0.46 元/GB |
1001 ~ 10000 | 0.38 元/GB |
10001 ~ 100000 | 0.30 元/GB |
100000 + | 0.24 元/GB |
CDN 大陆节点流量单价调整为：
| 流量（GB） | 单价 | 闲时折扣（00~08 点） |
|---|
0 ~ 10 | 免费（含 https） | - |
11 ~ 1000 | 0.18 元/GB | 6折 |
1001 ~ 10000 | 0.14 元/GB | 6折 |
10001 ~ 100000 | 0.12 元/GB | 6折 |
100000 + | 0.10 元/GB | 6折 |
CDN 全局请求单价调整为：
| 请求（万次） | 单价 | 闲时价格（00~08 点） |
|---|
0 ~ 10 | 免费 | - |
11+ | 0.035 元/万次 | 0.02 元/万次 |
S4 出口流量单价上调：
| 流量（GB） | 单价 | 闲时折扣（00~08 点） |
|---|
0 ~ 10 | 免费 | - |
11 ~ 1000 | 0.26 元/GB | 8折 |
1001 ~ 10000 | 0.22 元/GB | 8折 |
10001 ~ 100000 | 0.2 元/GB | 8折 |
100000 + | 0.18 元/GB | 8折 |
S4 回源流量单价下调：
| 流量（GB） | 单价 | 变动 |
|---|
0 ~ 10 | 免费 | - |
11 ~ 1000 | 0.1 元/GB | ↓ 16.7% |
1001 ~ 10000 | 0.085 元/GB | ↓ 15% |
10001 ~ 100000 | 0.07 元/GB | ↓ 20% |
100000 + | 0.055 元/GB | ↓ 37.5% |
S4 对象存储更新 🎉
进一步 完善 S3 协议 V4 上传校验兼容性，现在应当可以良好兼容最新的 Java S3 SDK 2.30.30+ 和 .Net S3 SDK 4.0.0+，即 —— SDK 不再需要禁用 Payload Signing 属性。如果你的 SDK 场景仍然存在疑似问题，欢迎加入我们的技术支持群组咨询，我们将尽力提供技术支持。其他调整
由于使用率较低，且大陆出现了较为优秀的同类服务（Creght）。目前 Framer 加速服务将关闭新建入口，现有网站访问会继续维持到 2027 年中旬。预计从 10 月份起不再优化该服务的可靠性问题，有大陆的相关需求 可转移至：https://www.creght.cn/媒体处理更新
实时媒体处理 CoreIX 近期更新如下：
- 调整优化
thumbhash 哈希占位 效果；
- 新增
主色调获取接口 fmt=color 将返回 rgba 的 Hex 色值字符串；
SVG 转 图片 功能上线（当 fmt 指定任意图片格式时）；
- 可以有效避免 SVG 源文件的泄漏风险；
- 可为 SVG 带来 完整的图片处理 支持，包括 —— 水印、缩略图、主色调、模糊 等；
- 优化兼容性 —— 在不支持 SVG 客户端中，可以获得 无缝的转换兼容。
- 使用
fmt=keep 参数将输出 安全的 SVG 源文件（Xml），能杜绝：
- SVG Xml 中的跨站脚本（XSS）攻击 —— 清理 SVG 文件中的脚本；
- SEO 垃圾邮件和网络钓鱼 —— 清除指向其他域的超链接；
- 第三方追踪 —— 删除对跨域资源的引用。
📊 控制台统计数据异常说明
省流：
不影响任何服务稳定性，不影响存储数据安全
少算的费用 不会追缴；多算的费用将 单独补偿。
7月12日 由于数据基础设施故障叠加监控 BUG 之问题：
将影响：
- S4 出口数据 —— 对象存储
统计图表 中 S4 出口数据 和 回源数据 将低于实际数据
- S4 流量计费 —— 所有 账户
当日计费 低于预期（于账户角度意味着 少付钱）
- S4 阶梯计算 —— 少部分 账户会因
阶梯清零 导致未来一段时间每个周期扣费会略高于预期（我们会在周一前会补偿 CDN 流量包到账户中）
- 实时日志 —— 包括 S4、CDN
不影响：媒体处理更新
实时媒体处理 CoreIX 近期更新如下：
预览模糊功能 fmt=thumbhash 大幅优化性能和效果；媒体信息获取接口 fmt=info 新增 视频、音频 的支持；内容识别 OCR 接口 测试上线，可支持 视频、图片 中的文字识别；
- 支持多达 15 种不同语言的自动识别；
- 无缝支持 视频、动图 的 frame 参数（截帧）；
- 付费客户目前可免费测试，请联系客服申请。
🎁 流量、请求数资源包以及折扣活动上线
资源包特点：
- 购买相应的资源包后可直接抵扣消耗的资源；
- 资源包抵扣时没有最低计算单位的限制（例如：用余额抵扣请求数消费时最低单位是“千次请求”）
- 可用余额购买资源包，若之前使用优惠券充值，相当于折上折；
- 转回“按量计费”后，所有资源包抵扣量依然参与本月阶梯计算。
特别折扣
7月7日前购买：1TB 和 10TB 的 CDN资源包 最低可享受 6 折（每个账户限购一次）。购买地址：https://console.bitiful.com/billing/resource （右上角 购买资源包）☀️ 全新「证书中心」正式上线
支持域名证书全流程自动处理：签发、续期、托管、更换完全不用再担心证书过期，赶紧来体验。使用演示
🙅♀️ 拒绝被滥用，S4 可自动检测 M2TS 和 M4S 类型
年初发生了一起震惊开发者圈的 供应链滥用事件:攻击者利用 typescript 和 mpeg2-ts 后缀相同的特点，将大量视频切片上传到 npm 后盗链下载，消耗了大量宝贵的公益资源。针对该类情况，缤纷云 S4 的 媒体类型自动检测系统 优化了对视频切片的判断策略，善加利用可以 有效杜绝 此类攻击。🎉 双 11 充值折扣券上线
缤纷云 11.11 大额充值券充值用券：
- 使用 BTF20241111A 送 20%，充100起送
- 使用 BTF20241111B 送 30%，充500起送
- 使用 BTF20241111C 送 50%，充100起送 (限首充) (长按 券代码 可复制)
时间：2024年11月10日 ～ 2024年12月10日🚀 大幅优化 CDN 部署时间
将 CDN 的部署时间从 数分钟 大幅优化至 30s 内，大大改善 CDN 的配置体验。📄 媒体处理 Style 支持可变参数
在设置 Style 的参数时，现在可以通过在 参数前增加 * 符号 使该值 可被 Url 参数自定义。以上图的参数举例：
- w（宽度像素） 是 不可变参数，代表设置到 Style 后，该参数 固定为 1200，不可被 Url 参数 改变；
- txt（水印文字）是 可变参数，代表设置到 Style 后，该参数 默认为 @Bitiful，但可以被 Url参数 改变。
建议 不要 将图片处理的 格式、宽度、高度 等 影响文件大小 的参数设置为 可变参数。
Wetransfer 和 奶牛快传 的开源替代。支持缤纷云领先的独特功能「即传即收」。
- 高性能广兼容：支持兼容 S3 协议的对象存储直传直取，不经过服务器中转，性能最大化；
- 依赖简单：*无账户体系、无各种 数据库依赖，自部署只需简单配置；
- 功能完整：下载链接 限速、限时、限次；
- 架构、代码简单，易于改造和二次开发。
🛜 缤纷云发布 Simul-Transfer 技术，让文件分享 0 等待
上下行同步传输技术
缤纷云基于自身独有的 流式架构，再次首创为 「对象存储」 原生带来了全新的 「同步传输技术」Simul-Transfer。它让分享的文件在 上传开始的一瞬间便可以被下载。›› 进一步查看🔐 S4 对象存储支持签名URL请求次数限制
推出 x-bitiful-max-requests 参数
利用 S4 该特性可进一步保护你的上传下载,例如：
- 在需要
限制下载次数 的场景（例如：分享文件），杜绝黑产嗅探到真实下载地址无限下载；
- 保护你的 上传链接 不被重放攻击
在缺乏 次数限制 的情况下，黑产可以在极短的时间内对 上传URL 进行重放攻击，达到上传违规文件的目的。
✏️ S4 对象存储生产支持 Move 操作（原子 Rename）
Rename 性能提升 1000 倍
传统的对象存储（Tencent COS、Aliyun OSS、AWS S3）均不支持原生的 Move 操作，在 Rename 场景需要 借助 Copy + 校验达到 Move 目的。单个大文件的 Copy + 校验 过程很可能 长达 10 秒 以上，在部分场景中会 严重降低整体性能。而 Move 操作耗时可 低至 5 毫秒内。
- 强一致 - Move 前后 没有任何中间状态，操作成功后全局立即生效；
- 强可靠 - 没有 Copy 过程，完全不会影响原数据的安全；
- 低成本 - 没有 Copy 过程，不会占用双倍的存储容量；
- 高兼容 - 使用 控制台 和 简单的 CopyObject 接口，可 Rename 任意大小对象；
🌍 缤纷云全球CDN节点上线
一键轻松切换
现在可以通过简单地修改CDN配置，完成「仅大陆节点」和「全球节点」的切换。自动优化跨境回源（当前免费）
海外节点在回源S4存储桶时会进行全自动的跨境优化（自定义网站回源暂不支持）。🕥 存储 & CDN 实时访问日志上线！
为了让客户进一步观测自己的请求数据，我们上线了实时访问日志。这几乎是业界首次直接免费提供（不用开通额外服务、不用考虑计费）实时访问日志。在海量的访问下，要免费开放并维持这一能力并不容易，希望能与各位客户一起提高与进步。目前提供的功能还比较简单，但我们相信这是一个好的开始～基于流式数据架构的近实时观测能力
得益于缤纷云先进的流式数据架构，让我们有能力为用户提供各种近乎实时的观测数据。例如：在桶列表当中，对象的总容量与总数的数据更新近乎总是在1分钟内，这使我们更容易对总体情况进行把握和预测。原文件保护功能增加「默认Style」功能
源文件保护功能，可以在非「预签名」情况下最大程度保护您的原创作品。设定了指定MIME源文件保护后，您的用户在匿名访问的情况下访问该媒体（未经处理）的原文件会报错：403 OriginalFileProtected。在这种情况下，用户访问该媒体的方法只有：
- 使用预签名Url访问（使用预签名Url方式在S4当中一直拥有最高权限）；
- 使用您设定的某个Style访问（例如：https://bucket.s3.bitiful.net/image.jpg!style:)
这无疑为您的媒体内容提供了巨大的保护能力。更优雅的源文件保护（设定默认Style）
但为用户返回「403 OriginalFileProtected」的报错信息未必是最优雅的方案。现在：缤纷云S4允许您为保护内容设定一个已存在的默认Style。当您的用户触发源文件保护的时候，系统不会返回「403 OriginalFileProtected」的错误信息，而是按照上面指定的默认Style对媒体进行处理，然后返回给用户。🧪 实验特性缤纷云S4对象存储访问节点现已支持HTTP/3（QUIC）
QUIC (HTTP 3) 通常被称为下一代网络通信。它运行在 OSI 模型的第四层，过去代表”快速 UDP 互联网连接”（现在起草的规范指出”QUIC”是协议的实际名称，而不是其他任何内容的缩写）。它也被称为 HTTP/3，进一步巩固了其作为 HTTP/2 继承者的地位。基于 UDP
QUIC协议最关键的一点是使用UDP进行通信；仅此一项就可以通过放弃使用传统的基于 TCP 的安排（需要任何两方同步，然后是 SYN-ACK 和确认）来降低客户端和服务器之间的延迟。缤纷云S4对象存储访问端点全面支持HTTP/3（QUIC）
若您希望体验HTTP/3，并且您的桶域名 https://xxx.s3.bitiful.net 在访问时还没有看到h3协议：请与群中客服联系。 强大的 CoreIX 变得更强🌟 CoreIX 支持 Blurhash 和 Thumbhash
缤纷云 CoreIX 上线实时的 Blurhash & Thumbhash 功能。这是缩略图预加载的最佳实践，效果出类拔萃。从现在开始，立即使用简单的 fmt=blurhash 或 fmt=thumbhash 获得全新的预加载效果。👇👇👇 🖥 全新的缤纷云控制台已经上线！
更美观、更方便，适配更多的屏幕尺寸。强大的缤纷云媒体引擎‼️ CoreIX 支持高级文字水印
如下图，依靠强大的 文字水印参数 实现艺术一般的水印效果。只需要设定几个参数，CoreIX 会在 0.1 秒内 呈现给您的用户。 今天缤纷云正式发布了🎁 缤纷云 S4 智能对象存储 正式发布
你好，2024年，你好，缤纷云。 
做全球最好的图片实时处理 API —— 这是开发 CoreIX 的初衷基于 2 年的技术储备，我们进行 全面重构，带来了全新的 CoreIX V2 版本。 只要您的项目使用了 CoreIX API 即可 自动获得 下面的收益：
