shipitagent

Tools · Media

image_generate

Can wait for approval

Generate an image from a text description. Returns the image so you can see it and the user can view it. Use for illustrations, diagrams, mockups, icons — not for editing an existing file.

When to use: Use image_generate to CREATE a new image from a description — an illustration, diagram, mockup, icon, or concept art. Write a specific prompt (subject, style, colours, composition). The result is returned to you as an image you can see, and shown to the user. Pick a size that fits the subject (square for icons, landscape for scenes, portrait for people). It does not edit existing files — use the file tools for that.

Example

The call

tool call
{
  "tool": "image_generate",
  "arguments": {
    "prompt": "A tidy isometric illustration of a pricing dashboard"
  }
}

Needs an image API key, e.g. OPENAI_API_KEY or FAL_KEY

So it isn't run here, and no output is shown: nothing on this page is made up.

Parameters

NameTypeDescription
prompt*stringWhat to draw — be specific about subject, style, colours, composition.
sizestringSquare, portrait, or landscape.1024x10241024x15361536x1024
providerstringBackend name (optional; auto-selected).

* required

Look at images, and make images, speech and video.