AI image

• Type ai.image
• Group AI
• Role action
• Risk acts outside MZBase
• Side effect safe to repeat
• Runs once per item
• Needs ai, media

Generates or edits an image with AI

Also available to AI agents and over MCP as a tool.

Uses the AI gateway; its cost shows in the run.

Parameters

route

AI route · string · optional

The AI route that runs it (AI settings). Empty = the default route for this kind of task; the route sets the price.

operation

Operation · string · optional · default generate · one of generate, edit

prompt

Prompt · string · required

Describe the picture. Expressions add per-item details.

negativePrompt

Negative prompt · string · optional

size

Size · string · optional · default square · one of square, portrait, landscape

count

Count · integer · optional · default 1 · range 1 – 8

Images per item; each one is priced.

seed

Randomness · object · optional · default {"mode":"random"}

Random choices repeat for the same seed: the same account gets the same variant every run. Empty = new each run.

Fields:

• mode (string) Mode
• value (integer) Value

source

Source · string · optional · default binary · one of binary, media

Shown when operation is edit.

binaryProperty

File field · string · optional · default data

Shown when source is binary.

mediaId

Media · string · optional

Shown when source is media.

into

Into field · string · optional · default data

saveTo

Save to · string · optional · default none · one of none, media

Where the result goes: back on the item as a file, or into the media library (the item then gets mediaId).

mediaFolder

Media folder · string · optional

Shown when saveTo is media.

mediaTags

Media tags · array · optional

Shown when saveTo is media.

Outputs

• main

← All nodes