图片处理

在 edge 或 vault 的图片地址上加参数，binedge 就返回处理后的图片。所有参数都参与签名，只有你的服务器能生成新尺寸。

参数

参数	取值	默认
w	目标宽，1 到 4096	不限
h	目标高，1 到 4096	不限
fit	inside 等比缩进框内；cover 铺满框再裁掉多余部分，w 和 h 都要给	inside
crop	center 或 smart（围绕画面重点裁剪）；只在 fit=cover 时有效	center
fmt	auto、jpeg、png、webp 或 avif	auto
q	质量，1 到 100；png 不用	jpeg 80、webp 75、avif 50

• w 和 h 至少给一个。图片不会被放大：原图比目标小时按原尺寸返回。
• 按 EXIF 方向转正，并去掉 EXIF、XMP、IPTC 和 ICC 元数据。
• fmt=auto 在浏览器接受时返回 AVIF，否则接受 WebP 时返回 WebP，否则带透明通道的返回 PNG、其余返回 JPEG。响应带 Vary: Accept。
• 原图超过 64 MiB 或约 2.68 亿像素、文件不是图片、出现未知参数或取值越界时返回 422。

示例

https://k3x9q2m7.edge.binedge.net/production/groups/logo.png?crop=smart&fit=cover&fmt=webp&h=144&q=75&w=144&sig=410RAzVg42KRbH5gEBlzbrYq5d7w-5avYm4J2EA9kro

这个地址的签名串见签名链接。用 Laravel：

Storage::disk('binedge')->imageUrl('groups/logo.png', ['w' => 144, 'h' => 144, 'fit' => 'cover', 'crop' => 'smart', 'fmt' => 'webp', 'q' => 75]);

缓存

• 在 edge 上，每个处理结果按完整地址缓存一年。原图变了就换一个 key 上传。
• 在 vault 上，和其他私有文件一样要加 exp，处理结果不缓存。