Style search

Find the right animation styles for a brief using natural language. Useful when you don't know the named Animation Prompt category and would rather describe the look.

Under the hood we embed your query with Vertex multimodal embeddings and run cosine similarity against the indexed Style records. You get back a ranked list of Style IDs you can pass to creative.featured_styles (advanced) or use as a discovery layer to find the right animation_prompts.

Query parameters

Request

curl "https://api.dessert.dev/v1/styles/search?q=warm+honey+drip+on+amber&top_n=10" \
  -H "Authorization: Bearer $DESSERT_API_KEY"

requests.get(
    "https://api.dessert.dev/v1/styles/search",
    params={"q": "warm honey drip on amber", "top_n": 10},
    headers={"Authorization": f"Bearer {os.environ['DESSERT_API_KEY']}"},
).json()

const url = new URL("https://api.dessert.dev/v1/styles/search");
url.searchParams.set("q", "warm honey drip on amber");
url.searchParams.set("top_n", "10");
await fetch(url, {
  headers: { Authorization: `Bearer ${process.env.DESSERT_API_KEY}` },
}).then(r => r.json());

{
  "tool": "dessert.search_styles",
  "arguments": { "q": "warm honey drip on amber", "top_n": 10 }
}

Response

{
  "query": "warm honey drip on amber",
  "results": [
    {
      "style_id": "recSSSSSSSSSSSSS1",
      "style_name": "Honey Drizzle on Amber Glass",
      "animation_prompt": "Serum Drizzles",
      "similarity": 0.872
    },
    {
      "style_id": "recSSSSSSSSSSSSS2",
      "style_name": "Slow Amber Pour",
      "animation_prompt": "Liquid Dripping",
      "similarity": 0.841
    }
  ]
}

Animation Prompt categories

The 36 production Animation Prompts that creative.animation_prompts accepts. They're grouped into seven slot families for clarity:

Errors