用途:在 Unsplash 搜索图库照片并下载到本地,可选在图片底部叠加标题和副标题文字,适合为博客配图、制作带文字的封面图等场景。
主要能力:提供 search_unsplash 按关键词搜索照片,支持横向、纵向、方形等方向筛选;download_photo 下载常规尺寸图片并触发 Unsplash 要求的下载跟踪接口;另提供 add_text_overlay 在图片底部加半透明遮罩并写入标题/副标题。支持的脚本参数包括 --query、--output、--orientation、--color、--pick(random 或 first)、--title、--subtitle、--list、--count(上限 30,默认 30)。
使用方式:需先在 unsplash.com/developers 注册并将 API key 放入 UNSPLASH_CLIENT_ID 环境变量,同时安装 Python 3、requests 和 Pillow(后者用于文字叠加)。核心代码示例包括 search_unsplash(query, orientation=None, count=30)、download_photo(photo, output_path) 与 add_text_overlay(image_path, title, subtitle=None, output_path=None),可直接参照资料中的 Python 片段调用。
限制:Unsplash 要求署名摄影师,输出中需包含 Photo by {name} on Unsplash,并调用 download_location 完成下载跟踪;速率限制为 demo 应用 50 次/小时、生产应用 5000 次/小时;图片尺寸分为 raw、full、regular(1080px 宽)、small(400px)、thumb(200px)。具体收费与平台支持情况暂未提供。