博物馆开放数据与 IIIF 怎么用：从单张下载到跨馆聚合

大多数人用博物馆网站的方式是：搜到作品，点开大图，右键保存。这只用到了开放馆藏的一小部分。

真正做研究、做教学、做对比的人，需要的是三样东西：可复用的图像、可批量处理的元数据、以及能把两者联系起来的接口。这三样在各馆的开放程度差别很大。

三种“开放”，别混为一谈

1. 可下载图像

页面上有下载按钮，通常给 1–3 档分辨率。这是最常见的一层，适合单件使用。

2. 开放元数据（open data）

机构把藏品记录以结构化格式（如 CSV、JSON、LOD）释出，常按 CC0 授权。它回答“有哪些作品、分别是什么”，不提供图像本身。

史密森尼开放获取是这一层的典型：图像与元数据一起以 CC0 释出，可直接进数据集。

3. 接口（API / IIIF）

让程序按需取图或取元数据。IIIF 是其中最重要的一套标准，因为它跨机构通用。

关键区别：元数据 CC0，不代表图像也 CC0。两者是分开声明的，必须分别核对。

IIIF 到底解决什么问题

IIIF（International Image Interoperability Framework）有两个核心部分：

Image API：按 URL 参数取图，可以指定区域、尺寸、旋转与格式。
Presentation API：用一个 manifest 文件描述一组图像及其结构（顺序、分册、注释）。

Image API 的 URL 结构大致是：

{server}/{identifier}/{region}/{size}/{rotation}/{quality}.{format}

例如取整幅、宽 1200 像素的 JPEG，大致写成：

https://example.org/iiif/obj-123/full/1200,/0/default.jpg

几个常用参数：

参数	含义	常见写法
region	取哪一块	`full` 整幅 / `pct:10,10,40,40` 百分比区域
size	输出尺寸	`max` 原尺寸 / `1200,` 固定宽 / `!800,800` 适应框
rotation	旋转	`0` / `90`
quality	质量	`default` / `color` / `gray` / `bitonal`
format	格式	`jpg` / `png` / `tif`

这意味着你可以在不下载整幅大图的前提下，只取需要的那一块放大看细节——对手卷、地图、版画题记尤其有用。

哪些馆提供这些

芝加哥艺术博物馆馆藏：IIIF 与开放数据都提供，开发者页面写清了接口。
荷兰国立博物馆：开放数据与 API 齐全，部分接口需要申请 key。
盖蒂博物馆：馆藏支持 IIIF，研究页面还提供专题数据集。
加里卡数字图书馆：法国国家图书馆的 IIIF 接口，适合报刊与手稿。
ColBase：日本国立文化财机构联合库，提供高清图像与解说，适合东亚藏品。
大都会开放馆藏：可按开放获取筛选并下载，元数据同样可用。

找这类入口的关键词是：IIIF、API、Open data、Developer、Rights and reproductions。它们通常不在主导航里，而藏在页脚或“研究/关于”页面。

三个实际用法

对比细节

同一件作品的不同版本、不同印次、不同修复阶段，用同一区域参数取图对齐，差异会立刻显现。

做标注与教学

manifest 可以被各类 IIIF 查看器加载，用来做区域标注、讲解、课堂演示。你不用自己搭图床。

批量研究

取元数据做统计：某馆某年代的藏品构成、某类题材的图像数量、某位艺术家的作品分布。注意各馆字段不统一，先做字段映射。

批量取图的边界

先读服务条款：很多机构限制请求频率，要求标明 User-Agent。
不要镜像整站：技术上做得到，但会给你和机构都带来麻烦。
缓存而非重复请求：同一条记录取一次就存下来。
标注来源与许可：数据集里保留原始链接与 rights 字段。
注意 robots.txt 与 API 配额：这是礼貌问题，也常是法律问题。

常见误区

把“能看大图”当成 API：页面上的高清查看器不一定是可编程接口。
忽略 manifest 里的 rights：manifest 会逐图声明许可，和站点页脚的总条款可能不同。
把 CC0 元数据当 CC0 图像：两者分开声明。
以为所有 IIIF 都免费：接口免费，图像仍可能按用途收费。
跨馆字段直接对比：尺寸单位、年代写法、作者归属规则都不一样，必须先映射。

检查清单

我需要的是图像、元数据，还是接口？
图像许可与元数据许可分别是什么？
是否需要申请 API key 或遵守请求频率？
我有没有保留原始记录链接与 rights 字段？
跨馆对比前，字段映射做了吗？

接下来做什么

授权与署名规则：图像授权与引用。
从藏品页拼出作品流传链：来源与流传怎么查。
录像、装置与媒体档案：数字艺术与影像。
东亚藏品的高清图与著录：中国书画与东亚艺术的数字资源。
直接找入口：数字馆藏与图库分类。