响应速度3~7s; 以下是按功能分类的完整API列表,包含所有获取图片及相关信息的端点和用法:
用于获取随机尺寸的图片,是最基础的API用法。
| 描述 | API端点 | 示例 |
|---|---|---|
| ⭐获取指定宽高的随机图片 | https://picsum.photos/{width}/{height} |
https://picsum.photos/200/300 |
| 获取正方形随机图片(宽高相等) | https://picsum.photos/{size} |
https://picsum.photos/200 |
| 获得随机图片 | https://picsum.photos/{width}/{height}?random={num} |
https://picsum.photos/200/300?random=2 |
示例图片:
用于获取已知ID或种子值的特定图片,确保每次返回相同图片。
| 描述 | API端点 | 示例 |
|---|---|---|
| 通过ID获取特定图片,可选指定尺寸 | https://picsum.photos/id/{image}/[width]/[height] |
https://picsum.photos/id/237/200/300 |
| 通过种子值获取固定随机图片,可选指定尺寸 | https://picsum.photos/seed/{seed}/[width]/[height] |
https://picsum.photos/seed/picsum/200/300 |
用于对图片添加灰度、模糊等效果,可与其他API组合使用。
| 描述 | API端点 | 示例 |
|---|---|---|
| 获取灰度图片(可与其他参数组合) | https://picsum.photos/[...]/?grayscale |
https://picsum.photos/200/300?grayscale |
| 获取模糊图片(默认模糊度) | https://picsum.photos/[...]/?blur |
https://picsum.photos/200/300/?blur |
| 自定义模糊程度(1-10之间的整数) | https://picsum.photos/[...]/?blur={1-10} |
https://picsum.photos/200/300/?blur=2 |
用于获取特定格式的图片文件,支持JPG和WebP格式。
| 描述 | API端点 | 示例 |
|---|---|---|
| 获取JPG格式图片 | https://picsum.photos/{width}/{height}.jpg |
https://picsum.photos/200/300.jpg |
| 获取WebP格式图片(更优压缩比) | https://picsum.photos/{width}/{height}.webp |
https://picsum.photos/200/300.webp |
将多种参数组合使用,实现复杂图片需求。
| 描述 | API端点 | 示例 |
|---|---|---|
| 组合ID、尺寸、灰度、模糊等多种参数 | https://picsum.photos/id/{id}/{width}/{height}?grayscale&blur={num} |
https://picsum.photos/id/870/200/300?grayscale&blur=2 |
用于获取图片的详细元信息,不返回图片本身。
| 描述 | API端点 | 示例 |
|---|---|---|
| ⭐获取特定ID图片的详细信息 | https://picsum.photos/id/{id}/info |
https://picsum.photos/id/0/info |
| 获取特定种子值图片的详细信息 | https://picsum.photos/seed/{seed}/info |
https://picsum.photos/seed/picsum/info |
| ⭐获取图片列表(含元信息),支持分页 | https://picsum.photos/v2/list[?page={page}&limit={limit}] |
https://picsum.photos/v2/list?page=2&limit=100 |
为满足特定场景需求的格式兼容API,本质是基础API的变体。
| 描述 | API端点 | 示例 |
|---|---|---|
| 显式指定JPG格式(与基础API功能相同) | https://picsum.photos/{width}/{height}.jpg |
https://picsum.photos/200/300.jpg |
| 显式指定WebP格式(现代浏览器推荐) | https://picsum.photos/{width}/{height}.webp |
https://picsum.photos/200/300.webp |
| 获取原图尺寸的特定图片 | https://picsum.photos/id/{id}/{width}/{height} |
https://picsum.photos/id/123/100/100 |
page和limit参数,可灵活获取大量图片信息