Add style set image
add_style_sampleAdd one image to the user's active style kit (a style holds any number of images per type and size; the user picks one as the anchor in Create with AI). subject_category sets the type it frames and replaces that type's anchor (its first image) at that size; add:true keeps the anchor and adds the image beside it; no subject_category adds an untagged image. image_id replaces that exact image. remove:true removes image_id (or, without it, the first image of subject_category at that size). With a MagicPixel style active, uploading makes the user's own copy of it (its images and brief) and activates it; with No style it creates "My style". The result says which. remove never creates one. Rules match the in-app editor: size 128 accepts a 128/256/512/1024 square on an exact 128-pixel grid (stored at 128); size 64 must be exactly 64×64; no soft (partly transparent) edges; max 2 MB. The active style's images steer the look and pixel size of EVERY generation (account-wide), unlike style_reference_id which only guides one call. Seed them from the game's existing art. The user edits the same images in the app (the style picker in Create with AI, ✎ on the style).
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "add_style_sample"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| add | No | With subject_category: add a further image of that type instead of replacing its anchor. | |
| size | No | Size band the image calibrates (64 or 128). Omitted → 128. | |
| remove | No | Remove image_id (or the type's first image at that size) instead of uploading. | |
| image_id | No | A kit image id from get_style_set: replace it (with image_base64) or remove it (with remove). | |
| image_base64 | No | PNG or JPEG (raw base64 or data URL). Required unless remove is true. | |
| subject_category | No | The type the image frames (custom = untagged). A type without an image reads the next one in this order at the same size. Omitted → custom, or the replaced image's own type. |