Pexels图片下载技能

使用Pexels API搜索和下载高质量的免费图片，支持自动调整尺寸、格式验证和元数据管理。特别适合小红书、社交媒体等内容创作。

🎯 核心功能

• - ✅ 高质量图片：专业摄影师作品，非AI生成
• ✅ 免费商业使用：Pexels免费许可，可商用
• ✅ 智能搜索：多关键词搜索，自动选择最佳图片
• ✅ 尺寸调整：自动调整到目标尺寸（如小红书1242x1660）
• ✅ 格式验证：验证图片格式、尺寸、文件大小
• ✅ 元数据管理：保存图片信息和许可条款

🔑 快速开始

1. 获取Pexels API密钥

1. 1. 访问 Pexels官网
2. 注册免费账号
3. 获取API密钥

2. 基本使用

bash

设置API密钥

export PEXELSAPIKEY=yourapikey_here

搜索并下载图片

python download_pexels.py --query sculpture art --size 1242x1660

批量下载

python download_pexels.py --query-file keywords.txt --count 5 --output-dir images/

📦 安装

bash

安装依赖

pip install requests pillow

或使用requirements.txt

pip install -r requirements.txt

📁 项目结构

pexels-image-downloader/
├── SKILL.md # 本文档
├── download_pexels.py # 主下载脚本
├── requirements.txt # Python依赖
├── config/
│ ├── default_config.json # 默认配置
│ └── image_sizes.json # 平台尺寸配置
├── scripts/
│ ├── batch_download.sh # 批量下载脚本
│ ├── resize_images.py # 图片调整脚本
│ └── validate_images.py # 图片验证脚本
├── examples/
│ ├── xiaohongshu_example.py # 小红书示例
│ └── socialmediaexample.py # 社交媒体示例
└── docs/
├── api_reference.md # API参考
└── best_practices.md # 最佳实践

🚀 核心功能详解

1. 智能图片搜索

python

多关键词搜索，自动选择最佳图片

python download_pexels.py \ --query sculpture art;clay sculpture;art studio \ --orientation portrait \ --size large \ --color any

2. 平台专用尺寸

bash

小红书尺寸

python download_pexels.py --query art --platform xiaohongshu

微信尺寸

python download_pexels.py --query food --platform wechat

微博尺寸

python download_pexels.py --query travel --platform weibo

自定义尺寸

python download_pexels.py --query nature --width 1920 --height 1080

3. 批量处理

bash

从文件读取关键词批量下载

python download_pexels.py \ --query-file keywords.txt \ --count 3 \ --output-dir downloads/ \ --platform xiaohongshu \ --parallel 3

4. 高级筛选

bash

按颜色筛选

python download_pexels.py --query sunset --color red

按方向筛选

python download_pexels.py --query landscape --orientation landscape

按尺寸筛选

python download_pexels.py --query portrait --size medium

⚙️ 配置说明

配置文件示例

json { apikey: YOURPEXELSAPIKEY, default_settings: { platform: xiaohongshu, output_dir: ./downloads, max_results: 10, image_quality: 95, save_metadata: true }, platform_sizes: { xiaohongshu: {width: 1242, height: 1660}, wechat: {width: 900, height: 500}, weibo: {width: 1000, height: 562}, instagram_square: {width: 1080, height: 1080}, instagram_portrait: {width: 1080, height: 1350} }, search_categories: { art: [sculpture, painting, drawing, craft], food: [cuisine, restaurant, cooking, recipe], travel: [landscape, cityscape, adventure, nature], lifestyle: [home, decor, fashion, wellness] } }

环境变量

bash

必需：Pexels API密钥

export PEXELSAPIKEY=yourapikey_here

可选：默认设置

export PEXELSDEFAULTPLATFORM=xiaohongshu export PEXELSOUTPUTDIR=./images export PEXELSMAXDOWNLOADS=20 export PEXELSIMAGEQUALITY=95

🔧 使用示例

示例1：小红书内容创作

python #!/usr/bin/env python3

小红书内容图片下载示例

import os
from download_pexels import PexelsDownloader

初始化下载器

downloader = PexelsDownloader( apikey=os.getenv(PEXELSAPI_KEY), platform=xiaohongshu, outputdir=./xiaohongshuimages )

下载不同主题的图片

themes = [ (sculpture art, 3, 雕塑教程), (handcraft diy, 2, 手工制作), (art studio, 2, 艺术工作室), (creative design, 2, 创意设计) ]

for query, count, category in themes:
print(f下载 {category} 图片...)
results = downloader.download(
query=query,
count=count,
orientation=portrait,
size=large
)

print(f✅ 下载完成: {len(results)} 张图片)

示例2：批量内容生产

bash #!/bin/bash

batchcontentcreation.sh

定义内容主题

THEMES=( 健康饮食|healthy food|营养早餐 健身运动|fitness workout|居家锻炼 护肤美妆|skincare makeup|日常护理 旅行摄影|travel photography|风景打卡 )

为每个主题下载图片

for theme in ${THEMES[@]}; do IFS=| read -r title query tags <<< $theme

echo 处理主题: $title

# 下载图片
python download_pexels.py \
--query $query \
--count 2 \
--platform xiaohongshu \
--output-dir content/$title

# 生成内容文件
echo 标题: $title > content/$title/content.md
echo 标签: $tags >> content/$title/content.md
echo 图片: >> content/$title/content.md
ls content/$title/*.jpg >> content/$title/content.md

echo ✅ 完成: $title
done

📊 图片验证

自动验证

bash

验证图片是否符合平台要求

python validate_images.py \ --dir ./downloads \ --platform xiaohongshu \ --check-size \ --check-format \ --check-quality

验证报告示例

📊 图片验证报告
================
总计: 15 张图片
✅ 通过: 12 张
❌ 失败: 3 张

失败原因:

1. 1. image001.jpg: 尺寸不符 (800x600 → 需要 1242x1660)
2. image005.jpg: 文件过大 (8.2MB → 建议 <5MB)
3. image_012.jpg: 格式不支持 (.bmp → 需要 .jpg/.png)

🎯 最佳实践

1. 搜索策略

• - 使用具体关键词：避免过于宽泛的搜索
• 组合搜索：使用多个相关关键词
• 利用分类：使用预设的分类关键词
• 筛选条件：使用颜色、方向、尺寸筛选

2. 图片管理

• - 分类存储：按主题/日期分类存储图片
• 保留元数据：保存图片信息和许可条款
• 定期清理：删除不符合要求的图片