从缩略图到原图——Anitabi 图片 API 的 plan 参数详解
图片 URL 格式
所有地标截图的 URL 都遵循这个格式：
https://image.anitabi.cn/points/{bangumiID}/{landmarkID}.jpg?plan={分辨率参数}
封面图：https://image.anitabi.cn/bangumi/{bangumiID}.jpg?plan={分辨率参数}
三档分辨率
| plan 参数 | 说明 | 推荐场景 |
|---|---|---|
h160 | 缩略图，高度 160px | 地图地标标记、列表展示、小图卡片 |
h360 | 标清图，高度 360px | 移动端满宽度查看、详情页中等尺寸展示 |
| 无 plan 参数 | 完整原始尺寸 | 只在用户主动点击放大查看时用，不要默认请求 |
具体转换方法
API 返回的缩略图地址示例：
https://image.anitabi.cn/points/115908/qys7fu.jpg?plan=h160想拿标清图
把 ?plan=h160 换成 ?plan=h360：
https://image.anitabi.cn/points/115908/qys7fu.jpg?plan=h360想拿完整尺寸
删掉整个 ?plan=xxx：
https://image.anitabi.cn/points/115908/qys7fu.jpg不要滥用完整尺寸
官方文档特别提醒：
"不建议在任何展示界面上使用完整尺寸截图，大量请求完整尺寸截图会对服务器造成压力，且无法确保快速加载。"
这意味着：
- 地图上的缩略图标记 →
h160 - 作品详情页的地标列表 →
h160或h360 - 地标详情页的大图展示 →
h360 - 只在用户主动点击"查看原图"按钮 时才去请求完整尺寸
封面图同理
作品封面图 URL 也是一样的规则：
https://image.anitabi.cn/bangumi/115908.jpg?plan=h160
→ 把 h160 换成 h360 或删掉 plan 参数。
实际使用建议
做自己的项目时：
- 默认全部用 h160——加载快、省带宽
- 移动端展示用 h360——比 h160 稍清晰，加载速度还可以
- 完整尺寸只给"查看原图"按钮——用户主动触发才请求
这样既能保证体验流畅，又不会给 Anitabi 服务器造成不必要的压力。遵守开放 API 的使用规范。