image_generate
Generate still images from text prompts, optionally guided by reference images for product or character consistency. Batch up to 10 images in a single call.
Instructions
For a user's image request, load the generating-images skill BEFORE calling this — it picks the right model and builds the prompt (this tool does neither, and calling it raw gives weak, inconsistent results). Generate one or many still images from text prompts, optionally guided by reference images (a product photo, a character, a style or composition to follow). Pass requests: ONE object per image (wrap even a single image — { requests: [ { prompt } ] }). Generate a batch of DIFFERENT images in a SINGLE call by adding more request objects (up to 10), each with its own prompt/model/aspect_ratio/resolution/reference_images; a single approval covers the whole batch. Each result carries a hosted image URL plus a local file path, or a structured error with a hint. Use for graphics, mockups, product/marketing visuals, logos, concept art, or to render a product or character from a supplied reference. Images are polled for you; a heavy image (large model / 4k / big batch) that runs long returns {status:"pending", ...} (a job handle, not an error) — pass that exact handle to job_status to retrieve it, and never re-submit a pending image. Set dry_run=true to preview the exact requests and cost without generating (no credits spent).Each entry in results is one of three things: finished media; a {status:"pending", ...} job handle to rejoin with job_status; or a failure carrying ok: false and an error. A failed entry is terminal — report its error and never poll or re-submit it. Read every entry rather than the top-level counters alone.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| dry_run | No | If true, return the requests that would be sent (keys masked), make no API call. | |
| requests | Yes | One object per image (wrap even a single image); add more objects to batch different images in one call (up to 10). |