pexels は何をしますか?
Pexels APIからロイヤリティフリーのストックフォトを検索・取得します。ユーザーがストックフォトの検索、プレースホルダー/デモ/シード画像の準備、ギャラリーの生成、またはプロジェクト用の実際のロイヤリティフリー画像を必要とする場合(例:「Xの写真を5枚見つけて」「ヒーローセクションのストック画像を取得」「Pexelsから画像をシード」)に使用します。
セットアップ
- Pexels APIにアクセスし、無料のAPIキーを取得します。
- 環境変数
PEXELS_API_KEYを設定します:
export PEXELS_API_KEY="your_api_key_here"
使い方
写真を検索
キーワードに基づいて写真を検索できます:
from pexels import search_photos
# 特定のクエリで写真を検索
results = search_photos("自然", per_page=5)
写真IDで取得
Pexelsの写真IDを使用して単一の写真を取得:
from pexels import get_photo
photo = get_photo(2014422)
人気の写真
現在人気のある写真を取得:
from pexels import get_curated_photos
curated = get_curated_photos(per_page=10)
応答形式
各写真には以下のフィールドが含まれます:
id:一意の写真IDwidth:画像の幅(ピクセル)height:画像の高さ(ピクセル)url:Pexels上の写真ページURLphotographer:写真家の名前photographer_url:写真家のPexelsプロフィールsrc:利用可能な各解像度の画像URLを含むオブジェクト(original,large,medium,small)alt:画像の代替テキスト
例
カスタムギャラリーウィジェットへの画像のシード:
from pexels import search_photos
photos = search_photos("都会の風景", per_page=5)
for photo in photos:
print(f"{photo['alt']} - {photo['photographer']}")
print(f"ダウンロード: {photo['src']['medium']}")
注意事項
- Pexels APIは無料ですが、レート制限があります。詳しくはPexels APIドキュメントをご確認ください。
- すべての画像はロイヤリティフリーですが、Pexelsの帰属要件に従ってください。
- 特定のキーワードで結果が返されない場合は、より一般的な用語を試すか、APIの応答を確認してください。