Unsplash

简介

Unsplash API 提供数百万张高质量、可免费使用图片的程序化访问：搜索、精选随机图片、单图元数据（作者、尺寸、下载链接、EXIF）。图片受 Unsplash License 保护，允许商业使用且无需署名（署名会更受欢迎）。

快速开始

搜索图片（替换 YOUR_ACCESS_KEY）：

curl "https://api.unsplash.com/search/photos?query=mountain&per_page=5" \
  -H "Authorization: Client-ID YOUR_ACCESS_KEY"

随机图片：

curl "https://api.unsplash.com/photos/random?orientation=landscape" \
  -H "Authorization: Client-ID YOUR_ACCESS_KEY"

按 ID 获取图片：

curl "https://api.unsplash.com/photos/abc123" \
  -H "Authorization: Client-ID YOUR_ACCESS_KEY"

使用 urls 对象获取所需尺寸（raw、full、regular、small、thumb）——raw 支持服务端缩放参数，如 &w=800&q=80。

认证方式

• 在 unsplash.com/developers 注册应用，获取 Access Key。
• 只读 API 调用使用 Authorization: Client-ID \<ACCESS_KEY>。
• 用户级操作（点赞、创建收藏、下载统计）需要完整的 OAuth 流程（带重定向 URI）。

速率限制与注意事项

• 免费层（“Demo”）：50 次请求/小时——原型开发绰绰有余；生产使用需要应用审核（配额更高）。
• 响应头 X-Ratelimit-Remaining 显示剩余配额。
• 请热链 urls 里的地址（不要转存）——这就是该 API 的设计用途。
• 搜索结果的分页用 link 响应头。

常见问题

Unsplash 免费吗？ API 有免费演示层（50 次/小时）；生产使用需要应用审核。图片本身在 Unsplash License 下可免费商用。

需要 OAuth 吗？ 只读的搜索/图片数据只需 Access Key（Client-ID 头）。OAuth 仅用于用户级操作。

图片可以商用吗？ 可以——Unsplash License 允许商业使用且无需署名。