Dreem icon

Dreem

AI-powered image generation with Dreem

Library → Search Video Prompts

AI-generated

Summary

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.

Links

Discussion