Generate a thumbnail
generate_thumbnailCreate a Roblox thumbnail from a text prompt and reference image; includes style-guide enhancement and optional direct publishing to Roblox.
Instructions
Make a new thumbnail image with the site's AI pipeline — the same one the generator page uses — from a prompt and at least one reference image. The prompt is rewritten against the studio style guide first unless enhance is turned off. The result is written to a file on this machine so it can be looked at, and saved to the project's history. Pass publish to send it straight to Roblox, which is only worth doing when the image has already been agreed on; otherwise generate, look at it, then call upload_thumbnail.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| game | Yes | Game name or universe id. The generation is saved to this project. | |
| model | No | Which image model to use. Defaults to gemini. | |
| prompt | Yes | What the thumbnail should show. | |
| enhance | No | Rewrite the prompt against the style guide first. Defaults to true. | |
| profile | No | Name of a style profile to enhance against. See list_style_profiles. | |
| publish | No | Upload it to Roblox immediately. Defaults to false. | |
| outputPath | No | Where to write the PNG. Defaults to a temp file, whose path is returned. | |
| primaryIndex | No | Which reference to match most closely, counting URLs then paths. Defaults to the first. | |
| referenceUrls | No | Public image URLs to steer style and subject. The first is treated as the primary reference unless primaryIndex says otherwise. | |
| referencePaths | No | Local image files to use as references. Hosted automatically. At least one reference, by path or URL, is required. |