generate_wordcloud_image
Generate a word cloud and return it as a WebP image. Data is sent to word-cloud.net servers for processing only and is not logged or stored.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| bold | No | Use bold weight | |
| font | No | Font family. Built-in: Arial, Audiowide, Bangers, Black Ops One, Bungee, Caveat, Chewy, Comic Sans MS, Courier New, Creepster, Dancing Script, Fredoka One, Georgia, Great Vibes, Impact, Lobster, Luckiest Guy, MedievalSharp, Montserrat, Nosifer, Open Sans, Orbitron, Oswald, Pacifico, Passion One, Permanent Marker, Righteous, Roboto, Russo One, Satisfy, UnifrakturMaguntia. Or use any Google Font with googleFontsUrl. | Impact |
| mask | No | Shape mask preset constraining where words are placed | none |
| shape | No | Canvas shape | landscape |
| words | Yes | Array of words with weights. Higher weight = larger text. | |
| maskUrl | No | URL to a custom mask image (PNG, JPEG, SVG). Black areas define where words are placed. | |
| gradient | No | Background gradient. Mutually exclusive with backgroundColor. | |
| rotation | No | Word rotation mode | horizontal-vertical |
| colorMode | No | Color mode: 'palette' uses colorPalette colors, 'bw' is black & white, 'white' is all white text | palette |
| colorPalette | No | Color palette preset | rainbow |
| customColors | No | Custom hex color values (e.g. ["#ff0000", "#00ff00"]). Overrides colorPalette when provided. | |
| backgroundUrl | No | URL to a background image (PNG, JPEG, SVG). | |
| googleFontsUrl | No | Google Fonts CSS URL for custom fonts (e.g. https://fonts.googleapis.com/css2?family=Lobster&display=swap) | |
| backgroundColor | No | Solid background hex color (e.g. #1a034f). Omit for transparent. Mutually exclusive with gradient and backgroundPreset. | |
| backgroundPreset | No | Built-in background image preset | None |