SuperAPI AI 工具集

find-me-a-museum-image

设计与创作

查看项目

更新于 10-16 09:35

技能介绍

用途:从博物馆开放获取馆藏中查找并下载真实、非 AI 生成的公共领域(CC0)艺术作品,供项目作为素材使用。

主要能力:脚本 scripts/museum_image.py 位于技能的 SKILL.md 所在目录,仅依赖 Python 3 标准库,需用绝对路径调用。无需 API 密钥的博物馆:artic(芝加哥艺术博物馆)、met(大都会艺术博物馆)、cleveland(克利夫兰艺术博物馆)、smk(丹麦国立美术馆)、rijks(荷兰国立博物馆)、getty(盖蒂博物馆)。需要免费密钥的:smithsonian,密钥放环境变量 SMITHSONIAN_API_KEY。

使用方式:先用 search 子命令按关键词搜索并保存缩略图与结果 JSON,例如 python3 <skill-dir>/scripts/museum_image.py search "water lilies" --orientation landscape --limit 6 --save <scratchpad>/results.json --thumbs <scratchpad>/thumbs;再阅读缩略图人工挑选;最后用 download 子命令下载,例如 python3 <skill-dir>/scripts/museum_image.py download <scratchpad>/results.json 3 --out assets/hero.jpg,同时生成 *.attribution.json 署名文件。--limit 为每家博物馆的数量,4–6 较合适。每次查询应使用独立的结果与缩略图文件。

适用场景:为网页、应用等寻找横幅、封面或插图等真实画作素材,并需要署名信息。

限制:大都会搜索最慢且索引可能过时;某家博物馆报错或超时时搜索会跳过它,警告输出到 stderr。--orientation 依据已知尺寸过滤,met 用画作物理比例近似,smithsonian 不过滤。公共领域标注遵循美国规则(约 1930 年前出版),1929 年等作品在其他国家可能仍受版权保护,国际发布时宜选去世 70 年以上的作者。结果为空通常说明查询过具体,可放宽关键词或改用艺术家名。荷兰国立博物馆无自由文本检索,主题词效果差,艺术家名效果好且标题为荷兰语;SMK 检索模糊;getty 结果不含材质与尺寸。更多 API 细节见 references/apis.md。