Dreem icon

Dreem

AI-powered image generation with Dreem

Library → Search Talents

AI-generated

Summary

Search semantically for AI model talents within the Dreem library filtered by gender and optional free-text descriptors to retrieve the top-ranked matching talents.

Inputs

  • Authentication (required) — Choose the authentication method: API Key or OAuth2 to access the Dreem API.
  • Search Keyword — Provide a free-text brief describing the talent using descriptors such as ethnicity and body build to match semantically. Leave empty to return the most recent talents for the selected gender.
  • Gender (required) — Select the talent's gender to search for: Female or Male. This is a required filter because the semantic talent index only covers these two genders.
  • Limit — Specify the number of top-ranked talent matches to return. The result page size is clamped between 1 and 20, defaulting to 5.

Output shape

a list of talent objects matching the search criteria

Returns an array of talents as JSON objects. If a search keyword is empty, returns the most recent talents filtered by the selected gender. Results are paginated within the limit parameter, representing the page size. Errors return a structured error message if continueOnFail is enabled.

Examples

Example 1: Search female talents described as 'scandinavian blonde 20s' limiting results to 5

Set Authentication to OAuth2, Search Keyword to 'scandinavian blonde 20s', Gender to Female, and Limit to 5.

Example 2: Retrieve top 10 male talents without a keyword to get the most recent males

Set Authentication to API Key, leave Search Keyword empty, set Gender to Male, and Limit to 10.

Links

Discussion