Skip to content

Style Preset Tools ​

Tools for managing reusable style templates.

Overview ​

Style presets save your preferred prompt settings for consistent branding:

Style Presets System

Create preset with prompt, negative prompt, system instruction, aspect ratio → Consistent styling


create_style_preset ​

Create a new reusable style preset.

Parameters ​

ParameterTypeRequiredDescription
namestringYesUnique preset name (1-128 chars)
promptstringNoPrompt prefix (max 2048 chars)
negative_promptstringNoDefault negative prompt (max 1024 chars)
system_instructionstringNoStyle guidance (max 512 chars)
aspect_ratiostringNoDefault aspect ratio

Example: Cinematic Style ​

json
{
  "tool": "create_style_preset",
  "params": {
    "name": "Cinematic",
    "prompt": "cinematic shot, dramatic lighting, anamorphic lens flare, film grain",
    "negative_prompt": "amateur, snapshot, flat lighting, poor composition",
    "system_instruction": "Create images with Hollywood film aesthetics",
    "aspect_ratio": "16:9"
  }
}

Response ​

Created style preset "Cinematic"

ID: 5
Settings:
- Prompt prefix: "cinematic shot, dramatic lighting..."
- Negative prompt: "amateur, snapshot, flat lighting..."
- System instruction: "Create images with Hollywood..."
- Default aspect ratio: 16:9

Use with: generate_image({ ..., style_preset_name: "Cinematic" })

How Presets Apply ​

When you generate with a preset:

Your prompt: "a mountain landscape"
Preset prompt: "cinematic shot, dramatic lighting"

Combined: "cinematic shot, dramatic lighting, a mountain landscape"

list_style_presets ​

Browse all saved style presets.

Parameters ​

None required.

Example ​

json
{
  "tool": "list_style_presets",
  "params": {}
}

Response ​

Your Style Presets (5):

1. **Cinematic** (ID: 5)
   Prompt: "cinematic shot, dramatic lighting..."
   Aspect: 16:9

2. **Vintage Film** (ID: 4)
   Prompt: "vintage 35mm film photograph, grain..."
   Aspect: landscape

3. **Watercolor** (ID: 3)
   Prompt: "watercolor painting, soft washes..."
   Aspect: square

4. **Anime** (ID: 2)
   Prompt: "anime style, vibrant colors..."
   Aspect: portrait

5. **Professional Photo** (ID: 1)
   Prompt: "professional photography, studio..."
   Aspect: portrait

get_style_preset ​

Get the full details of one saved style preset: its prompt prefix, negative prompt, system instruction and default aspect ratio.

Parameters ​

Give id or name, not both.

ParameterTypeRequiredDescription
idnumberEitherPreset ID
namestringEitherPreset name (max 128 chars)

Example ​

json
{
  "tool": "get_style_preset",
  "params": {
    "name": "Cinematic"
  }
}

Response ​

🎨 Style preset retrieved: Cinematic (#5)

• Prompt prefix: cinematic shot, dramatic lighting...
• Negative prompt: flat lighting, amateur
• Default aspect ratio: 16:9

Use `generate_image` with `style_preset_id` or `style_preset_name` to apply these defaults.

update_style_preset ​

Modify an existing style preset.

Parameters ​

ParameterTypeRequiredDescription
idnumberEitherPreset ID to update
namestringEitherPreset name to update
new_namestringNoNew name for preset
promptstringNoUpdated prompt prefix
negative_promptstringNoUpdated negative prompt
system_instructionstringNoUpdated system instruction
aspect_ratiostringNoUpdated aspect ratio

TIP

Provide either id or name to identify the preset.

Example: Add to Existing Prompt ​

json
{
  "tool": "update_style_preset",
  "params": {
    "name": "Cinematic",
    "prompt": "cinematic shot, dramatic lighting, anamorphic lens flare, film grain, shallow depth of field"
  }
}

Response ​

Updated style preset "Cinematic"

Changes:
- prompt: Added "shallow depth of field"

Updated settings:
- Prompt: "cinematic shot, dramatic lighting, anamorphic lens flare, film grain, shallow depth of field"
- Negative: "amateur, snapshot, flat lighting..."
- System: "Create images with Hollywood..."
- Aspect: 16:9

Clear a Field ​

Use null to clear optional fields:

json
{
  "tool": "update_style_preset",
  "params": {
    "name": "Cinematic",
    "negative_prompt": null
  }
}

delete_style_preset ​

Remove a saved style preset.

Parameters ​

ParameterTypeRequiredDescription
idnumberEitherPreset ID to delete
namestringEitherPreset name to delete

Example ​

json
{
  "tool": "delete_style_preset",
  "params": {
    "name": "Old Test Style"
  }
}

Response ​

Deleted style preset "Old Test Style"

Note: Images previously generated with this preset
are not affected. The preset reference is simply
no longer available for new generations.

Using Style Presets ​

In generate_image ​

json
{
  "tool": "generate_image",
  "params": {
    "prompt": "a sunset over mountains",
    "style_preset_name": "Cinematic"
  }
}

Or by ID:

json
{
  "tool": "generate_image",
  "params": {
    "prompt": "a sunset over mountains",
    "style_preset_id": 5
  }
}

Override Preset Settings ​

You can override preset defaults:

json
{
  "tool": "generate_image",
  "params": {
    "prompt": "a sunset over mountains",
    "style_preset_name": "Cinematic",
    "aspect_ratio": "square"
  }
}

The explicit aspect_ratio overrides the preset's default 16:9.


Preset Examples ​

Photography Styles ​

Professional Headshot

json
{
  "name": "Professional Headshot",
  "prompt": "professional headshot, studio lighting, clean background, corporate photography, sharp focus",
  "negative_prompt": "casual, outdoor, cluttered, snapshot",
  "system_instruction": "Create professional business portraits",
  "aspect_ratio": "portrait"
}

Product Photography

json
{
  "name": "Product Photography",
  "prompt": "professional product photography, soft shadows, clean white background, studio lighting",
  "negative_prompt": "amateur, cluttered, harsh shadows, low quality",
  "system_instruction": "Create clean, commercial product images",
  "aspect_ratio": "square"
}

Art Styles ​

Watercolor

json
{
  "name": "Watercolor",
  "prompt": "watercolor painting, soft washes, visible paper texture, delicate brushstrokes",
  "negative_prompt": "digital, photo, 3D, sharp edges, flat colors",
  "system_instruction": "Create traditional watercolor painting style images"
}

Oil Painting

json
{
  "name": "Oil Painting",
  "prompt": "oil painting, impasto technique, visible brushstrokes, rich colors, canvas texture",
  "negative_prompt": "digital, flat, airbrushed, photorealistic",
  "system_instruction": "Create images resembling classical oil paintings"
}

Anime

json
{
  "name": "Anime",
  "prompt": "anime style, vibrant colors, detailed shading, cel shading, clean lines",
  "negative_prompt": "realistic, 3D, western cartoon, photo",
  "system_instruction": "Create Japanese anime style illustrations",
  "aspect_ratio": "portrait"
}

Mood Styles ​

Dark Moody

json
{
  "name": "Dark Moody",
  "prompt": "dark moody atmosphere, dramatic shadows, noir lighting, high contrast",
  "negative_prompt": "bright, cheerful, flat lighting, overexposed",
  "system_instruction": "Create atmospheric, moody images with dramatic lighting"
}

Bright & Airy

json
{
  "name": "Bright & Airy",
  "prompt": "bright and airy, soft natural light, minimal shadows, clean aesthetic",
  "negative_prompt": "dark, moody, dramatic, harsh shadows, grungy",
  "system_instruction": "Create bright, fresh, minimalist imagery"
}

Best Practices ​

1. Be Specific ​

// Too vague
"nice style"

// Better
"soft pastel colors, gentle gradients, kawaii aesthetic, rounded shapes"

2. Match Negative to Positive ​

If your style is "watercolor":

json
{
  "prompt": "watercolor painting, soft washes",
  "negative_prompt": "digital art, 3D render, photograph, oil painting, sharp edges"
}

3. Keep Prompt Length Balanced ​

  • Too short: Not enough guidance
  • Too long: May overwhelm subject

Good length: 20-50 words

4. Test Before Committing ​

Generate test images with different subjects:

Generate a portrait using my new "Test Style"
Generate a landscape using my new "Test Style"
Generate a still life using my new "Test Style"

5. Use System Instructions Wisely ​

System instructions guide overall behavior:

// Good
"Create images suitable for children's book illustrations"
"Act as a professional food photographer"

// Less useful
"Make nice images"

Combining with Other Features ​

Style Preset + Character ​

json
{
  "tool": "generate_with_character",
  "params": {
    "character_name": "Luna",
    "scene_prompt": "in a magical forest",
    "style_preset_name": "Anime"
  }
}

Style Preset + Product ​

json
{
  "tool": "generate_with_product",
  "params": {
    "product_name": "Water Bottle",
    "scene_prompt": "on a wooden table with plants",
    "style_preset_name": "Product Photography"
  }
}

Next Steps ​

Released under the MIT License.