Actions10
- Generative Content Actions
- Library Actions
- Task Actions
Library → Search Talents
AI-generatedSummary
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.