find_public_image
Search a PUBLIC, Creative-Commons + public-domain image pool (Openverse) for the query, download the top suitable result, store it in the project's asset bucket, and return the filename ready for add_image_layer. This finds someone else's openly-licensed image — it is NOT for uploading your own image (use upload_image for that). Use it for any "get me a parasol" / "find a beach photo" / "add a coffee cup" request — saves the upload-then-add_image_layer dance. Free; no model spend. Falls back to 404 when no suitable downloadable image is found. Always returns attribution { creator, creator_url, title, license, license_version, source_url } per the CC requirement; the editor/caller should surface this where the licence requires it. (Formerly named fetch_image; that name is still accepted as an alias.)
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | Plain-language search query — e.g. "parasol on a beach", "vintage coffee cup", "sunset over mountains". | |
| projectId | Yes | Project to add the image to. | |
| license_type | No | Openverse licence filter. "all-cc" (default) is widest; "commercial" excludes non-commercial licences; "cc0" pins to public-domain dedications. | |
| min_dimension | No | Minimum width or height (whichever is larger) in px. Default 800 so the layer doesn't disappoint at canvas size. |