Search stock images from a visual reference with Python

"""Search once with an authorized local reference and preserve the response."""
import base64
import json
import os
from pathlib import Path
import sys
import urllib.error
import urllib.request


def main():
    if len(sys.argv) != 2:
        raise SystemExit("Usage: python3 reference_search.py reference.jpg")
    key = os.environ.get("LIGHTDRIFT_API_KEY")
    if not key:
        raise SystemExit("Set LIGHTDRIFT_API_KEY in your environment first.")
    path = Path(sys.argv[1])
    if path.suffix.lower() not in {".jpg", ".jpeg", ".png", ".webp"}:
        raise SystemExit("Use a JPEG, PNG or WebP reference.")
    if not 0 < path.stat().st_size <= 5 * 1024 * 1024:
        raise SystemExit("Reference must be nonempty and at most 5 MiB.")
    payload = {
        "image_base64": base64.b64encode(path.read_bytes()).decode("ascii"),
        "query": "similar coastal scene with room on the left for a headline",
        "k": 5,
        "filters": {"commercial": True, "derivatives": True},
    }
    request = urllib.request.Request(
        "https://api.lightdrift.ai/v1/search",
        data=json.dumps(payload).encode(),
        headers={"X-API-Key": key, "Content-Type": "application/json"},
        method="POST",
    )
    try:
        with urllib.request.urlopen(request, timeout=45) as response:
            result = json.load(response)
        if not isinstance(result, dict) or not isinstance(result.get("results"), list):
            raise ValueError("Unexpected search response")
    except urllib.error.HTTPError as error:
        raise SystemExit(f"HTTP {error.code}; inspect API/account status before retrying.") from None
    except (urllib.error.URLError, TimeoutError):
        raise SystemExit("Search outcome uncertain; check account usage before retrying.") from None
    except (ValueError, TypeError):
        raise SystemExit("Unexpected response; inspect API status before retrying.") from None
    print(json.dumps(result, indent=2))


if __name__ == "__main__":
    main()

python3 reference_search.py reference.jpg > reference-results.json