Job Create Tool
aimage.job.createStarts an image job from a plain-language instruction to generate, edit, vary, or upscale one or more images, with planning and background execution.
Instructions
Start an AIMage job from a plain-language instruction: generate, edit, vary or upscale one or many images. A text model plans the work (enhancing prompts, asking questions when ambiguous, estimating cost); a background worker executes it. Poll with aimage.job.show; answer questions with aimage.job.reply; confirm costly plans with aimage.job.approve. Images on the person's own computer are fetched into the site first with amount.fetch (see amount.computers); results can also be sent to any aMount mount, a computer included, with deliver_to.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"message": "<message>"
},
"name": "aimage.job.create"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| size | No | Image size control, e.g. 1024x1024 | |
| message | Yes | What to do, e.g. "generate 3 poster-style images of a red poppy field, 1024x1024, into rainbow/red" or "upscale every image in products/ 2x" | |
| quality | No | Quality control | |
| background | No | Background control, e.g. transparent | |
| deliver_to | No | Also send the results to this aMount mount: a name or uuid from amount.mounts, or a computer name from amount.computers such as "mypc" | |
| text_model | No | Planner model (default from settings); any chat model from aimage.models | |
| image_model | No | Image model (default from settings) | |
| aspect_ratio | No | Aspect ratio control | |
| output_folder | No | Destination folder relative to the images root | |
| deliver_folder | No | Folder there, e.g. "<shared folder>/photos/2025" on a computer |