pexels 是做什麼的？
從 Pexels API 搜尋並取得免版稅庫存照片。當使用者要求尋找庫存照片、填充佔位/示範/種子圖片、建立圖庫，或需要專案的真實免版稅圖像時使用（例如：「幫我找 5 張 X 的照片」、「為英雄區塊取得庫存圖片」、「從 Pexels 填充圖片」）。
功能
- 透過關鍵字搜尋 Pexels 照片
- 指定每次查詢的結果數量（預設為 10）
- 取得可直接使用的圖片 URL（原始、中等、小尺寸）
- 包含攝影師名稱與其 Pexels 個人檔案連結
- 回傳圖片替代文字描述
使用方式
pexels search "your search term" [count]
參數
query（必要）：要搜尋的關鍵字count（選用）：要取得的結果數量（預設：10，最大值：80）
回應格式
{
"photos": [
{
"id": 12345,
"width": 4000,
"height": 3000,
"url": "https://www.pexels.com/photo/...",
"photographer": "攝影師姓名",
"photographer_url": "https://www.pexels.com/@攝影師",
"src": {
"original": "https://images.pexels.com/...",
"medium": "https://images.pexels.com/...",
"small": "https://images.pexels.com/..."
},
"alt": "照片的描述文字"
}
]
}
設定
需要一個有效的 Pexels API 金鑰。請設定環境變數：
export PEXELS_API_KEY="your_api_key_here"
你可以在 Pexels 開發者平台 取得 API 金鑰。
範例
-
搜尋 5 張「山脈」的照片：
pexels search "mountain" 5 -
搜尋預設數量（10 張）的「城市夜景」照片：
pexels search "city night" -
搜尋「美食」照片，數量為 3：
pexels search "food" 3
注意事項
- 所有照片均根據 Pexels 授權條款提供，可免費使用
- 不一定要標註攝影師，但非常歡迎這麼做
- 圖片尺寸取決於原始上傳；建議使用中等或小尺寸以加快載入速度
- 請注意 API 速率限制（每小時 200 次請求，適用於免費方案）