image_playground_generate
Diagnostics & system · macOS
Effect: write (strongest supported action). Status: gated.
Gated means the tool requires an installed app, a connected account, permission, or runtime availability. Check those requirements on the listed platform before using it.
macOS
Purpose
Generates an image on the Mac from a text prompt with Apple's Image Playground model (Apple Intelligence; no API key needed). Saves a PNG and reveals it in Finder so the user can see it and drag it anywhere. Styles are Apple's built-in set (animation, illustration, sketch) — good for quick stylized art, NOT photorealistic. Requires macOS 15.4+ with Apple Intelligence enabled. On macOS 15.x/26 generation is fully automatic; on macOS 27+ a small Image Playground panel opens and the user clicks the image once to save it (Apple's public API on that version). WHERE TO SAVE: if the user names a place (e.g. "my Desktop", "the project folder"), pass that as output_path; otherwise omit it and it lands in ~/Pictures/Image Playground/ with a name from the prompt, then opens in Finder. The first call previews; confirm: true generates it.
Required inputs
prompt— Text description of the image to generate.
Permissions and confirmation
Explicit confirmation parameter: inspect the schema and tool description before any real call. The documentation example keeps confirm false. Obtain user authorization before performing the action.
- Use only the apps, accounts and resources authorized by the user on this platform. Consult this tool's platform-specific description for its connection and permission requirements; this catalog does not assert additional OAuth scopes or OS entitlements.
Full input schema — macOS
{
"properties": {
"confirm": {
"description": "Must be true to generate and save the image. Without it the call returns a preview and creates nothing.",
"type": "boolean"
},
"output_path": {
"description": "Where to save the PNG — an absolute path or ~ path (a file like ~/Desktop/art.png, or a folder to save into). Omit to use ~/Pictures/Image Playground/<prompt>-<timestamp>.png. Missing parent folders are created.",
"type": "string"
},
"prompt": {
"description": "Text description of the image to generate.",
"type": "string"
},
"reveal_in_finder": {
"description": "Open Finder with the new image selected so the user can see/move it. Default true; set false when generating many in a row.",
"type": "boolean"
},
"style": {
"description": "Visual style. Default 'animation'. Falls back to an available style if the requested one isn't supported on this device.",
"enum": [
"animation",
"illustration",
"sketch"
],
"type": "string"
}
},
"required": [
"prompt"
],
"type": "object"
}Documentation example
Do not execute this example. These concrete inputs refer to a fictional demonstration dataset. Resolve real handles and obtain user authorization before any real call.
{
"confirm": false,
"prompt": "A watercolor hummingbird above a field of flowers",
"style": "illustration"
}