Skip to content

CLI command

tinbox search-images

Find stock images (or generate an AI placeholder) for a campaign or newsletter body. mode='search' queries the okslop stock library by keyword; mode='generate' returns a deterministic AI-generated placeholder for a prompt (use when nothing fits or you need a hero image). Returns image URLs you can drop into markdown as ![alt](url). Read-only — picking an image is your job; nothing is inserted or sent.

Generated from tool: search_images

Usage

sh
tinbox search-images --query <query> --mode <mode> --limit <limit> --orientation <orientation>

Flags

NameTypeRequiredDefaultDescription
--querystringyes—Search keyword (mode='search') or the image prompt (mode='generate').
--modestringyes—'search' the stock library (default) or 'generate' an AI placeholder.
--limitstringyes—Max images to return (default 12; ignored for generate).
--orientationstringyes—Preferred orientation. Landscape suits email hero images.