Stock Photos & Videos

RapidAPI2026-08-10 更新2026-08-11 收录

图库素材检索

视觉内容供给

数据链接：

https://rapidapi.com/KageLogic/api/stock-photos-videos 数据链接链接失效反馈

官方服务：

资源简介：

Search and download high-quality stock photos and videos from Pexels API seamlessly within your MCP environment.

创建时间：

2026-08-10

原始信息汇总

Stock Photos & Videos API 数据集总结

数据集概览

Stock Photos & Videos API 是由 Kage Logic 提供的一个免费API，用于搜索和下载来自 Pexels 目录的高质量免版税库存图片和视频。该API采用三端点流程，允许开发者搜索媒体、获取详细信息并获取直接下载链接。

核心功能

媒体搜索：提供独立的图片搜索端点（get_photos）和视频搜索端点（get_videos），支持自然关键词搜索（如 nature、technology、office）
智能筛选：支持按尺寸（large/medium/small）、方向（landscape/portrait/square）和分页（page）进行过滤
直接下载：get_media_detail 端点可通过媒体ID返回实际下载链接
隐私保护：零日志政策，搜索查询和下载活动不会被存储，符合GDPR/CCPA标准
高性能：99.9%可用性，超低延迟，TLS 1.3端到端加密
MCP支持：原生支持Model Context Protocol，便于AI代理集成

端点详情

1. GET `/api/stock-photos-videos/get_photos`

搜索Pexels上匹配查询条件的高质量库存图片。

完整URL：https://stock-photos-videos.p.rapidapi.com/api/stock-photos-videos/get_photos?query={keyword}&size={size}&orientation={orientation}&page={page}
注意：搜索结果不包含下载链接，需通过 get_media_detail 获取

2. GET `/api/stock-photos-videos/get_videos`

搜索Pexels上匹配查询条件的高质量库存视频。

完整URL：https://stock-photos-videos.p.rapidapi.com/api/stock-photos-videos/get_videos?query={keyword}&size={size}&orientation={orientation}&page={page}
参数与图片搜索相同，视频下载链接同样通过 get_media_detail 获取

3. GET `/api/stock-photos-videos/get_media_detail`

通过媒体ID检索特定图片或视频的详细信息及下载链接。

完整URL：https://stock-photos-videos.p.rapidapi.com/api/stock-photos-videos/get_media_detail?id={media_id}
使用时机：应在搜索端点之后调用，以获得实际的 download_link

请求参数

搜索端点参数（get_photos / get_videos）

参数	类型	必填	描述
`query`	string	是	搜索关键词（最少1个字符）
`size`	string（枚举）	否	媒体最小尺寸：`large`/`medium`/`small`
`orientation`	string（枚举）	否	媒体方向：`landscape`/`portrait`/`square`
`page`	number	否	结果页码（最小为1，默认为1）

详情端点参数（get_media_detail）

参数	类型	必填	描述
`id`	string	是	媒体ID（图片或视频）

认证方式

所有请求需携带以下 RapidAPI 请求头：

X-RapidAPI-Key：您的API密钥
X-RapidAPI-Host：stock-photos-videos.p.rapidapi.com

基础URL：https://stock-photos-videos.p.rapidapi.com/api

响应格式

所有端点返回统一信封格式：success（布尔值）和 data（对象/数组）。

get_photos 响应示例： json { "success": true, "data": [ { "id": "2014422", "photographer": "Aleksandar Pasaric", "url": "https://www.pexels.com/photo/2014422/", "alt": "Mountain landscape at sunset" } ] }

get_media_detail 响应示例（包含下载链接）： json { "success": true, "data": { "id": "2014422", "url": "https://www.pexels.com/photo/2014422/", "download_link": "https://images.pexels.com/photos/2014422/pexels-photo-2014422.jpeg" } }

错误码

HTTP状态	错误代码	说明
400	`INVALID_PARAMETER`	无效查询或缺少参数
401	`UNAUTHORIZED`	API密钥无效或缺失
403	`FORBIDDEN`	API密钥缺少媒体范围权限
422	`VALIDATION_ERROR`	缺少必需的查询参数
429	`RATE_LIMIT_EXCEEDED`	请求过于频繁
500	`INTERNAL_ERROR`	媒体目录暂时不可用