Actions10
- Generative Content Actions
- Library Actions
- Task Actions
Library → Search Video Prompts
AI-generatedSummary
Searches the Dreem library for video generation prompts filtered by a required gender and an optional free-text keyword, returning a list of matching prompts.
Inputs
- Authentication (required) — Choose how to authenticate with the Dreem API; options are API Key or OAuth2.
- Gender (required) — Required hard filter specifying prompt gender type: Female (2), Male (1), or Unisex (3). Male excludes unisex prompts; select Unisex to search unisex only.
- Search Keyword — Optional free-text brief describing the motion to semantically search prompts. Leave empty to return the newest prompts instead of a ranking.
- Limit — Number of top-ranked matching video prompts to return, constrained between 1 and 20; defaults to 5.
Output shape
a list of video prompt objects matching the search criteria
The output is a paged list of prompt entries returned from the Dreem API. Each prompt includes attributes such as name, id, description, and sourceType. Prompts are filtered by gender, and if a keyword is provided, they are semantically ranked by relevance; if no keyword is given, the newest prompts are returned. Pagination is fixed to page 1 with page size equal to the specified limit parameter.
Examples
Example 1: Find the top 3 unisex video prompts related to slow product motions
Set Gender to Unisex (3), enter 'slow orbit around the product' as Search Keyword, set Limit to 3, and provide API authentication.