用途:当用户想要一张真实照片而非 AI 生成图时使用,例如“找一张新加坡的照片”“搜索办公室图片”“某物料的图库图片”“为幻灯片或文章配图”。关键词测试:出现 photo、picture、stock image、find/search 时用本技能;出现 generate、create、make、draw、illustration 时改用宿主的图像生成工具。
主要能力:调用 Pexels API(基础地址 https://api.pexels.com/v1/,请求头 Authorization: <PEXELS_API_KEY>)搜索与获取照片。接口包括 /search(按关键词搜索)、/curated(精选热门)、/photos/:id(按 ID 获取)。搜索参数支持 query、orientation(landscape/portrait/square)、size(large/medium/small)、color(颜色名或十六进制)、locale(如 zh-CN)、per_page(默认 15,最大 80)、page。照片对象自带多种尺寸:original、large2x、large、medium、small、portrait、landscape、tiny,按需选用。
使用方式:先确认环境变量 PEXELS_API_KEY 已设置;查询词中的空格需编码为 + 或 %20;通过 curl 调用接口解析 JSON,向用户展示 ID、摄影师、alt、尺寸和 Pexels 链接;下载时使用响应中的 src 字段 URL(例如 photos[0].src.large),不要自行拼接 images.pexels.com 地址;交付文件并附署名。展示多张结果时可用表格列出编号、ID、摄影师、alt、尺寸。
适用场景:需要真实图像的演示文稿、文章/博客插图、社交媒体配图,以及任何明确要求“真实”图片而非 AI 生成的请求。
限制与注意:免费额度为 200 次/小时、20000 次/月,仅 API 调用计数,从 images.pexels.com 的 CDN 下载不计入。内容可免费用于商业与非商业用途,但须署名摄影师并链接回 Pexels(如“Photo by [Name] on Pexels”),展示多张时注明“Photos provided by Pexels”。不要用 original 尺寸做预览(可能超过 10MB),避免手动构造图片 URL。不适用于 AI 艺术生成、图像编辑(放大、去背景、调色)以及截图或图表。未提供官方技能说明文本。