Documentation

Image generation

Generate and edit images in Studio, keep the results with your project, and continue the workflow on desktop or mobile.

Start in Studio

Image generation is a Studio node, not a separate settings workflow. Your project, inputs, outputs, and edits stay together in the vault.

Create the first image

A SystemSculpt license and internet connection are required for generation.

Open Studio from the command palette or Settings → SystemSculpt → Studio.
Create a project with New Studio project. New projects use SystemSculpt/Studio unless you change the projects folder in settings.
Add an Image Generation node to the project.
Enter a prompt, choose an image model and its output options, then run the node or the whole project.

Configure the Image Generation node

Prompt

Describe the image or the change you want. You can type in the node or connect a text output; connected text takes priority.

Input images

Connect up to four PNG, JPEG, or WebP images when you want to edit or reference existing visuals.

Image count

Generate up to four outputs, within the selected model’s batch limit. The model picker shows its limit.

Aspect ratio

Choose from the selected model’s supported ratios. Changing models resets size, quality, ratio, and count to defaults so old settings do not carry into a different model.

Image model

Search the available image models and compare credit estimates. SystemSculpt Default keeps model choice managed for you. Model availability and pricing refresh from the service without a plugin update.

Size and quality

Select the sizes and quality levels supported by your model, or keep Model default. Larger outputs and higher quality can cost more.

Credits and estimates

The picker’s credit estimates include the SystemSculpt service fee. The final charge uses actual generation cost with the fee and credit conversion accepted when the job started, rounded up to whole credits. Reference images and prompt processing can add cost. A conservative temporary hold can exceed the estimate; unused credits are released after settlement. If billing cannot be verified, the hold remains for reconciliation and the result is withheld. Refreshing or reconnecting to the same job does not generate or charge it twice.

Run and review

Run the image node from its action bar, or run the active project from the command palette. Studio shows a pending output while generation is in progress. Each completed output becomes an image media card connected to the generation node.

Project-owned files

The workflow is stored as a .systemsculpt project. Its generated and edited media live in the matching .systemsculpt-assets folder beside it.

Image cards keep the useful actions close to the result: Edit with AI, Edit image, Copy image, Replace media, and Delete node.

Choose the right editing path

Edit with AI

Creates a new Image Generation node connected to the selected image, carries over its aspect ratio, and focuses the prompt. Use it for generative changes.

Edit image

Opens the local image editor for text, boxes, circles, blur, and crop. Choose Done to render the edits as a project asset.

The local editor also lets you adjust text styling and layer order. Its Fit action recenters the canvas without changing the saved image.

Desktop and mobile

The image workflow is portable

Image generation and the image editor are available in Studio on desktop and mobile.

Some local-machine nodes still require desktop Obsidian: CLI, dataset, audio extraction, and terminal. Mobile hides unavailable nodes and blocks a run before it starts when the project includes one.

Reveal in Finder is also desktop-only. Keep cross-device projects to portable nodes when you need to run them from a phone or tablet.

Troubleshooting

License or connection error

Open Settings → SystemSculpt → Account, activate your license again, and retry the node.

Prompt required

Type a prompt in the node or connect a text-producing node to its prompt input.

Input image rejected

Use PNG, JPEG, or WebP and keep the run to four input images or fewer.

Credits held or model unavailable

Generation reserves credits before it starts. Wait for active jobs or pending billing to finish; do not start duplicate jobs to recover a missing response. Models without verified pricing or compatible image outputs are unavailable.

Project is blocked on mobile

Remove desktop-only nodes from the run, or open the project in desktop Obsidian to execute them.

More helpCheck the settings reference for Studio storage controls or the troubleshooting guide for service errors.

Chat workspace

Vault workflows

Search documentation