Find matching library examples
find_matching_examplesMatch a brief against hundreds of render-ready examples to receive ranked candidates with thumbnails and a decision: adapt an existing example or assemble from templates.
Instructions
Match a brief against the ENTIRE published examples library (hundreds of professionally designed, render-ready projects) and return ranked candidates with thumbnails/previews plus a decision: "adapt-example" (strong match — call start_from_example), "adapt-or-assemble", or "assemble-similar" (compose from the returned design-template/canvas-preset/shape modules). Use this before authoring any project JSON by hand; matching runs over full metadata with category synonyms, so it finds examples the plain search_creative_library query cannot.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| type | No | Restrict to video examples, still-image examples, or both. | any |
| brief | Yes | What to create, for whom, and the goal — same brief you would give plan_creative_video. | |
| limit | No | ||
| duration | No | Target video duration in seconds (soft signal). | |
| aspectRatio | No | ||
| excludeSlugs | No | Recently used example slugs to exclude (anti-repetition). | |
| includeParts | No | Include design-template/canvas-preset/shape modules for assembly. Default: automatic (included unless a strong example match exists). | |
| variationMode | No | fresh (default) rotates which comparable top candidate leads, so repeated identical briefs vary; "consistent" keeps ranking deterministic. | fresh |
| variationSeed | No | Optional reproducible seed for the rotation; omit for a new pick per request. | |
| excludePremium | No | Set true on free-plan accounts to skip premium examples (their content is plan-gated). |