generate_image
Make an image from a prompt, or edit up to 5 photos.
With no photos it creates a new image from your prompt. With photos it edits them: change the background, fix lighting, merge people from several shots, restyle.
Price: Text only: a flat 5 credits. With photos: the quality tier (standard 5 · ultra 10 · max_effort 14).
| Parameter | Type | Required | Default | Details |
|---|---|---|---|---|
prompt | string | Yes | — | What to make, or what to change in the photos. |
image_urls | string (https URL)[] | No | — | 0–5 photos to edit. Leave out for a brand-new image. |
aspect_ratio | "1:1" | "2:3" | "3:2" | "3:4" | "4:3" | "9:16" | "16:9" | No | "2:3", or the photo's shape when editing | Output shape. |
quality | "standard" | "ultra" | "max_effort" | No | "max_effort" | Only used when editing photos. standard 5 · ultra 10 · max_effort 14 credits. |
Returns: { "images": [{ "id": "…", "url": "…" }] }. Keep the id to delete it later.
Example call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "generate_image",
"arguments": {
"prompt": "Golden-hour portrait on a rooftop, soft film grain",
"aspect_ratio": "2:3"
}
}
}




