Generate an image
generate_imageMakes a picture from a description and stores it, ready to attach to a post. Call it as soon as you know what the picture should be: the user is asked to confirm the spend before it runs, with the price, so you do not need to ask them first. Describe the subject and the setting in the prompt; the model cannot see the brand kit, so put anything from it that matters into the words. If the project has set an image prompt, it is wrapped around what you write and sets the look, so you do not need to repeat the house style.
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": {
"prompt": "<prompt>"
},
"name": "generate_image"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| count | No | How many to make, up to 4. Defaults to 1. | |
| model | No | A model from list_image_models. Defaults to the workspace one. | |
| prompt | Yes | What the picture should show, in detail. | |
| imageUrl | No | An existing picture to edit or work from, rather than starting blank. | |
| resolution | No | 1K, 2K or 4K. Larger costs more at some models. | |
| aspectRatio | No | e.g. 1:1, 4:5 for Instagram, 16:9 for a link preview. | |
| forPlatform | No | Where this picture is going: facebook, instagram, x, linkedin or tiktok. Give it and the shape is chosen to suit that feed, which saves the user a cropped post. | |
| ignoreProjectStyle | No | Generate exactly this prompt, without the project's image template. Only when the user asks for something outside their usual look. |