import{_ as t,c as s,a,o as r}from"./app-Dgsdh8A6.js";const c={};function d(i,e){return r(),s("div",null,e[0]||(e[0]=[a('

图片格式化

已知 *.hdslb.com *.biliimg.com 等域名作用等效, 对于请求头 Referer 要求留空或在 .bilibili.com 等 B 站域名下

对于以上域名的 /bfs/ 下的图片文件都可以使用以下可选格式化参数

使用 @ 开始参数 (无论格式如何, 无论是否有参数, 通过计算 HASH 发现, 使用 @ 均会导致返回图片不同), 多个参数以 _ 分隔, 图片格式无需分隔且必须放在最后

参见: #191

注: jpg 即 jpeg, 二者等效. 网页端常用 AVIF, WebP.

参数格式含义备注
w${int}w图片最大限制宽度范围 [1, 9223372036854775807]
h${int}h图片最大限制高度范围 [1, 9223372036854775807]
s${int}s作用尚不明确不影响输出结果, 范围 [1, 9223372036854775807]
e${int}e改变大小0: 保留比例取其小, 1: 保留比例取其大, 2: 不保留原比例
p${int}p缩放倍数默认100, 范围 [1, 1000]
o${int}o作用尚不明确不影响输出结果 范围 [0, 1]
q${int}q图片质量百分比仅限webp/jpeg/avif
c${int}c裁切图片(如果宽高允许)0: 不裁切但会修改图片, 1: 上传时的预设规则(若无则右下), 2: 左上, 3: 右上
f${int}f作用尚不明确[0, 1]: 不改变图片, 2: 会改变图片
progressiveprogressive图片编码方式仅限 jpeg(无: baseline, 有: progressive)/png(无:non-interlaced, 有: interlaced)
!!${str}加载来源web-home-carousel-cover, header, web-dynamic, web-avatar-space-header, ...
..${str}图片格式仅限 png/jpeg/webp/avif/avg_color

示例:

查看示例:

原始图片

https://i1.hdslb.com/bfs/archive/e5fff1472bad1c0c6bcb3004205f9be23b58ffc0.jpg

高度限制为100

https://i1.hdslb.com/bfs/archive/e5fff1472bad1c0c6bcb3004205f9be23b58ffc0.jpg@100h

宽度限制为100

https://i1.hdslb.com/bfs/archive/e5fff1472bad1c0c6bcb3004205f9be23b58ffc0.jpg@100w

转换格式为webp

https://i1.hdslb.com/bfs/archive/e5fff1472bad1c0c6bcb3004205f9be23b58ffc0.jpg@.webp

转换为webp图片质量为1%

https://i1.hdslb.com/bfs/archive/e5fff1472bad1c0c6bcb3004205f9be23b58ffc0.jpg@1q.webp

avg_color格式说明

当图片格式化输出格式为avg_color

/bfs/*/*.*@*.avg_color

请求方式:GET

json回复:

根对象:

字段类型内容备注
RGBstr平均颜色值HEX

示例:

获取 https://i1.hdslb.com/bfs/archive/e5fff1472bad1c0c6bcb3004205f9be23b58ffc0.jpg 的平均颜色值

curl 'https://i1.hdslb.com/bfs/archive/e5fff1472bad1c0c6bcb3004205f9be23b58ffc0.jpg@.avg_color'
查看响应示例:
{\n    "RGB": "#7d6f6c"\n}
',20)]))}const b=t(c,[["render",d]]),l=JSON.parse('{"path":"/docs/misc/picture.html","title":"图片格式化","lang":"zh-CN","frontmatter":{},"git":{"updatedTime":1753153653000,"contributors":[{"name":"SocialSisterYi","username":"SocialSisterYi","email":"1440239038@qq.com","commits":2,"url":"https://github.com/SocialSisterYi"},{"name":"SessionHu","username":"SessionHu","email":"102411014+SessionHu@users.noreply.github.com","commits":5,"url":"https://github.com/SessionHu"}],"changelog":[{"hash":"88bc2ea943775a83bdd5cfe2464f7a28fade3068","time":1753153653000,"email":"102411014+SessionHu@users.noreply.github.com","author":"SessionHu","message":"feat(misc/picture.md): update bfs domains"},{"hash":"031e28eb62cba0d3e91508ac2669eaafb0715db6","time":1745080699000,"email":"102411014+SessionHu@users.noreply.github.com","author":"SessionHu","message":"fix: img 403 by referrer"},{"hash":"60a0c5d1a2f44fe61335da04571305fa7727a968","time":1724238159000,"email":"102411014+SessionHu@users.noreply.github.com","author":"Session小胡","message":"feat: 各种接口补充与错误修正 (#1066)"},{"hash":"18c1efbc102ae6b44c8f5314c90e5e64f0d926cd","time":1721909032000,"email":"102411014+SessionHu@users.noreply.github.com","author":"Session小胡","message":"feat: bili_ticket 算法 Java 实现 及 信息补充 及 错误修正 (#1061)"},{"hash":"bbbbc9b7672691f3bb53844b774f96fe8f897550","time":1702358474000,"email":"102411014+SessionHu@users.noreply.github.com","author":"Session小胡","message":"feat(picture.md): @.avg_color (#893)"},{"hash":"05ac3d5e2a9e28be3bf129ae8c78ffdbebaa161c","time":1684805901000,"email":"1440239038@qq.com","author":"SocialSisterYi","message":"添加文档【Wbi 接口签名】,修改目录结构"},{"hash":"7d89ece2ac46425810647c4ac92acf5f3721cb68","time":1676998806000,"email":"1440239038@qq.com","author":"SocialSisterYi","message":"🚀调整项目结构"}]},"filePathRelative":"docs/misc/picture.md"}');export{b as comp,l as data};