[翻译]Pexels免费图片API文档
如果贵司想请求我们的API, 你可以从这里获取Key. 我们很期待听到你的创意! 获取更到信息可以在API预览页 或 继续阅读来了解我们的API 如何工作的以及如何集成它.
指南
- 无论什么时候, 当你发送一个请求的时候, 请确保在突出的位置显示Pexels的链接. 你可以使用文字链接(例如 "照片由 Pexels提供") 或者一个我们Logo的图片链接(下载我们的Logo 白色版 或者 黑色版).
- 如果可能的话, 可以将我们的摄影师名称显示出来 (例如 "照片由John Doe 上传到 Pexels" 链接到Pexels的对应页面).
- 不要复制Pexels的核心功能.
- 不要滥用 API. API请求限制是每小时不超过 200 次 以及每个月不超过 20,000 次. (超过限制请联系我们)
鉴权
在你收到自己的API key后, 你可以开始使用这个API. 你需要在你每次请求的时候将它加到HTTP请求头Authorization上:
Authorization: YOUR_API_KEY搜索图片
https://api.pexels.com/v1/search?query=example+query&per_page=15&page=1参数名 | 解释 |
|---|---|
query | 获取与query相关的照片. (必须) |
per_page | 定义当前页结果的个数. (默认: 15, 最多: 80) |
page | 定义当前页的页码. (默认: 1) |
如果请求成功, 响应体会是如下格式的JSON:
{
page: 1,
per_page: 15,
total_results: 236,
url: "https://www.pexels.com/search/example%20query/",
next_page: "https://api.pexels.com/v1/search/?page=2&per_page=15&query=example+query"
photos: [{
width: 1000,
height: 1000,
url: "https://www.pexels.com/photo/12345",
photographer: "Name",
src: {
original: "https://*.jpg",
large: "https://*.jpg",
large2x: "https://*.jpg",
medium: "https://*.jpg",
small: "https://*.jpg",
portrait: "https://*.jpg",
landscape: "https://*.jpg",
tiny: "https://*.jpg"
}, (NEXT PHOTOS)]
}
}上一页/下一页的属性只会出现在非最后一页/第一页的时候
策展图片
https://api.pexels.com/v1/curated?per_page=15&page=1我们每个小时会添加至少一个照片到我们的策展列表, 所以你可以得到一组不断更新的照片. 有关请求参数和响应格式可以查看上面的搜索方法.
获取一张照片
https://api.pexels.com/v1/photos/:id</pre>如果你有一张照片的id, 你可以使用它来获取信息
随机照片
如果你想获取随即照片, 你可以使用"策展照片" 以及 设置 per_page 为 1 page 设置为1 到1000 的随机数来获取漂亮的随机照片. 如果你想获取随机的指定主题的照片, 可以使用相同的方法.
搜索视频
https://api.pexels.com/videos/search?query=example+query&per_page=15&page=1
参数名称 | 解释 |
|---|---|
query | 获取query相关的视频. (必须) |
per_page | 定义当前页结果的个数. (默认: 15, 最多: 80) |
page | 定义当前页的页码. (默认: 1) |
min_width | 返回视频的最小宽度. (默认: "") |
max_width | 返回视频的最大宽度. (默认: "") |
min_duration | 返回最小时间秒数的视频的 (默认: "") |
max_duration | 返回最大时间秒数视频. (optional, default: "") |
废弃警告: 视频API在video_pictures中返回一个图片数组.video_pictures 已经被废弃, 将会在后面删除.
受欢迎视频
https://api.pexels.com/videos/popular?per_page=15&page=1参数名称 | 解释 |
|---|---|
query | 获取query相关的视频. (必须) |
per_page | 定义当前页结果的个数. (默认: 15, 最多: 80) |
page | 定义当前页的页码. (默认: 1) |
min_width | 返回视频的最小宽度. (默认: "") |
max_width | 返回视频的最大宽度. (默认: "") |
min_duration | 返回最小时间秒数的视频的 (默认: "") |
max_duration | 返回最大时间秒数视频. (optional, default: "") |
废弃警告: 视频API在video_pictures中返回一个图片数组.video_pictures 已经被废弃, 将会在后面删除.
获取一个视频
https://api.pexels.com/videos/videos/:id如果你有视频的id, 你可以获取它的信息.
图片格式化
参数名称 | 解释 |
|---|---|
original | 图片的原始尺寸. |
large | 大尺寸, 最大宽度940px 以及高度 650px. 具有原图片的纵横比. |
large2x | 图片最大宽度 1880px 以及最大高度1300px. 具有原图片的纵横比. |
medium | 高度为 350px 宽度自适应. 具有原图片的纵横比. |
small | 高度为 130px 宽度自适应. 具有原图片的纵横比. |
portrait | 宽度 800px 高度 1200px. |
landscape | 宽度 1200px 高度 627px. |
tiny | 宽度 280px 高度 200px. |
请求统计
要查看这段时间剩余请求次数, 可以查看HTTP请求头 "X-Ratelimit-Remaining".
尝试请求
curl -H "Authorization: YOUR_API_KEY" "https://api.pexels.com/v1/search?query=people"非官方的封装
免责申明
我们没有正常运行时间或可用性保证。有些功能在未来可能会改变。
联系我们
有问题请写信 api@pexels.com.