壹贰线报 · 官方页面核实 · 2026 年 10 月
一、先说结论:你给的三条都成立,但有一个关键数字要补
后台读者发来 ImgBB 的资料,让帮忙核一核。逐条比对官网之后,这次的结论比较"温和":没有需要推翻的旧口径——免费托管、拖拽上传、直链 / BBCode / HTML 嵌入、上传 API,四条都站得住。
真正要补的是一个你没提、但决定它能不能用的数字:免费档单张图片上限 32MB;以及三处二手攻略常会含糊过去的地方。
你给的资料 | 官方口径 | 判定 |
|---|---|---|
免费图片和 GIF 托管 | 官网首页原文:ImgBB is a free image hosting service;GIF 可上传(官方 API 返回示例即为 .gif) | ✅ 准确 |
拖拽上传、直接链接、BBCode、HTML 嵌入 | 官网原文:Direct image links, BBCode, and HTML thumbnails | ✅ 准确 |
用于上传集成的 API | 确有 API v1(api.imgbb.com/1/upload);但官方 Pro 权益表把 API Access 列在付费一侧 | ⚠️ 有前提 |
(资料未提)单图上限 | 免费 32MB,Pro 提到 64MB | ⭐ 需补 |
(资料未提)定时删除 | 可设 60 秒 – 180 天后自动删除 | ⭐ 需补 |
一句话概括:免费、免注册、直链、GIF 都是真的;但"无广告""无限空间""图片替换""64MB""API Access"这五项,官方把它们挂在 Pro 权益里——资料把它们和免费能力放在一起说了。
二、免费档到底给了什么
1. 单图上限 32MB(本篇最该记住的数字)
官网首页上传区直接标着 32 MB limit。
这个额度比不少图床大方——4K 截图、长图、动图基本都能一次性传上去,不用先压缩。
2. 不需要注册也能传
拖拽、粘贴、从电脑里选,或者直接填一个图片 URL 让它去抓——上传完成后立刻给出一整套链接:
直链(i.ibb.co 开头):给 Markdown 和网页
<img>用;BBCode:给论坛用;
HTML 缩略图:给博客用。
不注册就能拿到这些链接;注册一个免费账号,多的是图片管理、相册归类这些功能。
3. 定时删除:60 秒 – 180 天
上传时可以指定图片在某段时间后自动删除,最短 60 秒,最长 15,552,000 秒(180 天)。临时分享大图、不方便让对方下载原文件的场景很顺手。
这条同时说明另一件事:"永久保存"不是官方承诺,而是一个可选项。 免费图床的长期可用性,永远要自己在本地留一份。
4. 免费档一览
项目 | 免费档 |
|---|---|
价格 | 免费(ImgBB is a free image hosting service) |
单图上限 | 32 MB |
是否需要注册 | 不需要,匿名即可上传;注册后可管理图片与相册 |
链接形式 | 直链 / BBCode / HTML 缩略图 |
定时删除 | 60 秒 – 180 天(expiration 参数,单位秒) |
常见格式 | JPG / PNG / GIF / WEBP / BMP 等 |
存储总量上限 | 官方未公示;"Unlimited space" 在官方页面属 Pro 权益 |
三、三处容易被二手攻略带偏的地方
1. "API Access" 写在官方 Pro 权益表里
这一点最值得单独说。官方升级页把 API Access 明确列为 Pro 权益之一;而在 api.imgbb.com 页面,多个第三方接入文档都描述为"注册免费账号后点 Get API key 即可拿到密钥"。
两种说法并存,实务上的建议是:
以官方页面为准,把免费档的 API 当成"可用,但可能有额外限制"来看待;
真要上生产的项目,先用免费 key 自测一遍——上传是否成功、返回结构、失败时的错误码,跑通了再做决定;
别忘了 API 上传必须有 key——这和网页端可以完全匿名上传不一样。
2. "无限空间"是 Pro 的说法
官方页面在 Pro 权益里写的是 Unlimited space。而免费档的存储总量上限,官方没有公示数字。也就是说:
日常少量配图,基本碰不到边界;
但打算把 ImgBB 当"主仓库"长期堆图,就得有心理准备——它的空间承诺不在免费这一侧。
同理,免费档也没有"无广告"的承诺;官方把 No Ads 挂在 Pro 权益里。
3. 这五项其实都是 Pro 权益
官方 Pro 权益清单(官网实读):
Pro 权益 | 说明 |
|---|---|
No Ads | 去广告 |
Direct Linking | 直链 |
Unlimited space | 无限空间 |
Replace image feature | 替换图片(链接不变) |
64 MB file size per image | 单图上限提到 64MB |
API Access | API 访问 |
注:免费用户在网页上传后同样能复制到 i.ibb.co 直链,"Direct Linking"这一项在免费与 Pro 之间的具体差异,以官方说明为准。
价格(官网公示):
套餐 | 单价 | 实际计费 |
|---|---|---|
月付 | $12.99 / 月 | 按月 |
年付 | $7.99 / 月 | $95.88 / 年(约 38% off) |
3 年 | $3.99 / 月 | $143.64 / 3 年(约 69% off) |
四、API 怎么用:一个端点,四个参数
官方 API v1 文档(api.imgbb.com 实读):
端点:
https://api.imgbb.com/1/upload方法:优先 POST(GET 也能用,但受 URL 长度限制,base64 经 URL 编码后还可能被改动)
必须带 key
参数表:
参数 | 必填 | 说明 |
|---|---|---|
| 必填 | API 密钥,作为 query string 参数传递 |
| 必填 | 二进制文件、base64 数据,或一个图片 URL(最大 32MB) |
| 可选 | 文件名;用 POST + multipart/form-data 上传文件时会自动识别 |
| 可选 | 到期自动删除,单位秒,60 – 15552000 |
调用示例(官方文档原样):
curl --location --request POST \
"https://api.imgbb.com/1/upload?expiration=600&key=YOUR_CLIENT_API_KEY" \
--form "image=R0lGODlhAQABAIAAAAAAAP///yH5BAEAAAAALAAAAAABAAEAAAIBRAA7"
返回 JSON 里常用的字段:
字段 | 含义 |
|---|---|
| 图片直链(i.ibb.co 开头) |
| 展示用链接 |
| 图片查看页(ibb.co/xxxx) |
| 缩略图 / 中图链接 |
| 删除页地址 |
| 到期时间戳,0 表示不过期 |
关于 key 的安全提醒
官方文档的示例是把 key 放在 query string 里。而 query string 恰恰是最容易进日志的部分——服务器访问日志、代理日志、浏览器历史、Referer 头都可能把它记下来。所以:
key 只放服务端,绝不写进前端代码或公开仓库;
做了日志采集的项目,记得把 key 做脱敏处理。
另外要注意:用代码删图是不行的——返回的 delete_url 是一个网页地址,删除得走这个页面,API 本身没有删除接口。批量管理图片时这一点要提前设计。
五、四个实操建议
1. 图床只是"发布用的中转",原图务必本地留档
免费图床的可用性没有长期承诺,服务条款也保留了处理违规内容的权利。重要图片请同时存在本地或自有存储,别把唯一副本押在第三方。
2. 敏感内容不要用公开直链
公开直链一旦外泄,任何拿到地址的人都能访问,搜索引擎也可能收录。含隐私的图建议用私密分享或加密码,文件名里也别放个人信息。
3. 临时分享就设 expiration
发给外部合作方看的效果图、一次性截图,把 expiration 设成 600 秒到几天,到期自动消失,比事后记得去删更省事。
4. 国内访问,先自测再决定
ImgBB 是海外服务,没有中国大陆节点。中文技术社区的普遍反馈是"国内访问可能较慢或不稳定,建议先自行实测,重要场景配合加速或换用国内存储"。
所以最稳妥的用法是:ImgBB 作为发帖、笔记、原型阶段的临时图床;正式站点或公众号配图,走自有存储或国内对象存储。
六、适合谁 / 不适合谁
适合
论坛贴图、博客配图、Markdown 写笔记:免注册,拖进去就有直链,32MB 上限够用;
截图自动上传的小工具:一个端点加一个 key,几行代码就能接;
临时分享大图:配合 expiration 设到期自动删除;
海外博客、跨境社媒配图:海外访问体验相对更好。
不太适合
当长期主图床用:空间与可用性承诺不在免费侧;
面向国内访客的正式站点:无大陆节点,需要额外做加速或备一份国内地址;
存敏感内容:公开直链风险高;
需要国内备案域名的场景:ImgBB 给不了备案链路。
七、三步上手
打开 imgbb.com,把图片拖进上传区(不注册也能传;要管理图片和相册就免费注册一个账号);
上传完成后按场景复制代码——Markdown / 网页用直链,论坛用 BBCode,博客用 HTML 缩略图;需要临时分享的在页面上设置自动删除时间;
要用 API:在 api.imgbb.com 获取 key(免费账号的可用性以官方页面为准),POST 到
https://api.imgbb.com/1/upload,图片以文件 / base64 / URL 三种形式之一提交。
上限 32MB、Pro 单图 64MB 及各项 Pro 权益取自官方首页与升级页实读内容;API 端点、参数(key / image / name / expiration 60–15552000)、返回字段与 POST 建议取自 api.imgbb.com 官方文档;Pro 价格 $12.99 / $7.99 / $3.99 为官方公示口径。
壹贰云测评 · 壹贰线报