Skip to main content
Glama

Generate Image

generate_image
Destructive

Use this to create or edit an AI image. Text-to-image from a prompt, OR image-to-image / editing / multi-reference by passing input_images (URLs, data URIs, or base64) — e.g. edit or restyle an image the user just generated by passing its URL. Input support is per-model: some take 1 image, some several, some none (check each model's max_input_images via list_models). Submits an async job and returns a job_id — then call check_generation_status to poll (usually ready in seconds); when complete it returns the finished image inline for you to display. Each call starts a new job that spends credits from the user's BudgetPixel balance (failed jobs aren't charged). Default model: seedream-5.5; call list_models to see every available model with prices and input limits. Write @handle in the prompt to cast a character (list_characters), e.g. a free BudgetPixel AI influencer like @barry; an item's @handle (search_wardrobe) dresses them: "@barry wearing @camel_coat_set"; a pose's @handle (search_poses) poses them: "@barry in @sitting_knee_up_pose".

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

NameRequiredDescriptionDefault
seedNoSeed for reproducible generation
modelNoAI model id. Omit for the default (seedream-5.5 — natural light and skin, sharp small text, edits that keep the rest as it was, transparent cut-outs from the prompt; up to 10 reference images; 26 credits at 1K, 46 at 2K, plus 10 per reference image). For fast, low-cost drafts pick flux-3-image-klein (FLUX 3 Klein: 12 credits at 1K, up to 10 free references, images in seconds) or seedream-5.0-flash (flat 25 credits, free references). By job: gpt-image-2.6-sunburst (dense text, complex layouts, precise edits; up to 16 free references), gpt-image-2.6-flare (fast, sharp text; both make transparent cut-outs), seedream-4.5 (photorealism), gpt-image-2 (text in images), nano-banana-2.1 (fast, sharp text in images, up to 9 free references; optional paid search grounding), nano-banana-2 (editing), qwen-image-3.0 (all-rounder), flux-3-image (FLUX 3: up to 10 free references, optional web grounding; priced by size, 55 credits at 768px up to 790 at 4K). Call list_models for the full catalog with prices and input limits.
promptYesText prompt describing the image to generate (mai-image-2.7 takes up to 8,000 characters and refuses a longer prompt)
qualityNoOptional rendering quality for models that support it (gpt-image-2: low/medium/high; gpt-image-2.5-sunburst and gpt-image-2.5-flare: low/medium/high/xhigh/max; gpt-image-2.6-sunburst and gpt-image-2.6-flare: low 70, medium 120, high 175, xhigh 340 or max 675 credits per image at any size; grok-imagine-image-2: low/medium — no high tier). Higher costs more. On grok-imagine-image-2 quality x resolution sets the price (low 1K=50, low 2K=80, medium 1K=80, medium 2K=100 credits). Omit for default.
groundingNoOptional, flux-3-image only: let the model research the prompt with web and image search before rendering. On by default and free. Set false for faster, self-contained generation. Omit for the default.
backgroundNoOptional output background for models that support it (see list_models). gpt-image-2.6-sunburst / gpt-image-2.6-flare: "transparent" makes a cut-out (a sticker, logo or product) straight from the prompt or an edit, returned as a PNG with transparency; seedream-5.5 does the same; mai-image-2.7 makes a cut-out from a text prompt (with input images it draws the subject anew rather than cutting out the input). seedream-5.0-flash / seedream-5.0-pro: "transparent" only keeps a transparent background when EDITING: pass exactly one input image, a PNG that already has transparent pixels. Omit (or "opaque") for a normal image.
num_imagesNoNumber of images to generate (1-4)
resolutionNoOptional output size (per-model options, e.g. seedream-5.5, seedream-5.0-pro & seedream-5.0-flash: 1K/2K; minimax-h3-image: 2K or 4K; mai-image-2.7: 1K (default, 50 credits) or 2K (190), plus 11 credits at 1K or 45 at 2K for each of its up to 5 input images, per generated image; gpt-image-2 & nano-banana-2: up to 4K; nano-banana-2.1: 1K/2K/4K; flux-3-image and flux-3-image-klein: 768px/1K/1.5K/2K/4K — see list_models for what each size costs). Omit for the model default. Larger costs more, sometimes far more: flux-3-image is 55/65/90/130/790 credits per image at 768px/1K/1.5K/2K/4K (flux-3-image-klein 11/12/15/19/48), so confirm with the user before choosing 4K.
aspect_ratioNoAspect ratio of the generated image. Omit for the default: 1:1 — except an edit with flux-3-image, flux-3-image-klein, nano-banana-2.1 or mai-image-2.7, which keeps the first input image's shape unless you set a ratio here.
image_searchNoOptional, nano-banana-2.1 only: let the model look up web images as visual reference before rendering (what a real place, product or landmark looks like). Off by default. It runs a Google Search too, so it costs 20 credits per image in total, with or without google_search (list_models shows the current price). Tell the user it adds to the cost.
input_imagesNoOptional input image(s) for image-to-image / editing / multi-reference — each a public image URL, a data URI, or raw base64. Per-model support: some models take 1, some several, some none (see max_input_images in list_models). Omit for text-to-image. To edit an image the user just generated, pass its URL here.
google_searchNoOptional, nano-banana-2.1 only: ground the image in live Google Search results (weather, scores, recent events, current facts). Off by default. Costs extra: 10 credits per image (list_models shows the current price). Turn it on only when the request needs current, real-world information, and tell the user it adds to the cost.
negative_promptNoWhat to avoid in the generated image

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed4 schema fields changed
    • changedInput schema / properties / aspect_ratio / description
      Previous value: -"Aspect ratio of the generated image. Omit for the default: 1:1 — except an edit with flux-3-image, flux-3-image-klein or nano-banana-2.1, which keeps the first input image's shape unless you set a ratio here."New value: +"Aspect ratio of the generated image. Omit for the default: 1:1 — except an edit with flux-3-image, flux-3-image-klein, nano-banana-2.1 or mai-image-2.7, which keeps the first input image's shape unless you set a ratio here."
    • changedInput schema / properties / background / description
      Previous value: -"Optional output background for models that support it (see list_models). gpt-image-2.6-sunburst / gpt-image-2.6-flare: \"transparent\" makes a cut-out (a sticker, logo or product) straight from the prompt or an edit, returned as a PNG with transparency; seedream-5.5 does the same. seedream-5.0-flash / seedream-5.0-pro: \"transparent\" only keeps a transparent background when EDITING: pass exactly one input image, a PNG that already has transparent pixels. Omit (or \"opaque\") for a normal image."New value: +"Optional output background for models that support it (see list_models). gpt-image-2.6-sunburst / gpt-image-2.6-flare: \"transparent\" makes a cut-out (a sticker, logo or product) straight from the prompt or an edit, returned as a PNG with transparency; seedream-5.5 does the same; mai-image-2.7 makes a cut-out from a text prompt (with input images it draws the subject anew rather than cutting out the input). seedream-5.0-flash / seedream-5.0-pro: \"transparent\" only keeps a transparent background when EDITING: pass exactly one input image, a PNG that already has transparent pixels. Omit (or \"opaque\") for a normal image."
    • changedInput schema / properties / prompt / description
      Previous value: -"Text prompt describing the image to generate"New value: +"Text prompt describing the image to generate (mai-image-2.7 takes up to 8,000 characters and refuses a longer prompt)"
    • changedInput schema / properties / resolution / description
      Previous value: -"Optional output size (per-model options, e.g. seedream-5.5, seedream-5.0-pro & seedream-5.0-flash: 1K/2K; minimax-h3-image: 2K or 4K; gpt-image-2 & nano-banana-2: up to 4K; nano-banana-2.1: 1K/2K/4K; flux-3-image and flux-3-image-klein: 768px/1K/1.5K/2K/4K — see list_models for what each size costs). Omit for the model default. Larger costs more, sometimes far more: flux-3-image is 55/65/90/130/790 credits per image at 768px/1K/1.5K/2K/4K (flux-3-image-klein 11/12/15/19/48), so confirm with the user before choosing 4K."New value: +"Optional output size (per-model options, e.g. seedream-5.5, seedream-5.0-pro & seedream-5.0-flash: 1K/2K; minimax-h3-image: 2K or 4K; mai-image-2.7: 1K (default, 50 credits) or 2K (190), plus 11 credits at 1K or 45 at 2K for each of its up to 5 input images, per generated image; gpt-image-2 & nano-banana-2: up to 4K; nano-banana-2.1: 1K/2K/4K; flux-3-image and flux-3-image-klein: 768px/1K/1.5K/2K/4K — see list_models for what each size costs). Omit for the model default. Larger costs more, sometimes far more: flux-3-image is 55/65/90/130/790 credits per image at 768px/1K/1.5K/2K/4K (flux-3-image-klein 11/12/15/19/48), so confirm with the user before choosing 4K."
  2. Changed1 schema field changed
    • changedInput schema / properties / resolution / description
      Previous value: -"Optional output size (per-model options, e.g. seedream-5.5, seedream-5.0-pro & seedream-5.0-flash: 1K/2K; gpt-image-2 & nano-banana-2: up to 4K; nano-banana-2.1: 1K/2K/4K; flux-3-image and flux-3-image-klein: 768px/1K/1.5K/2K/4K — see list_models for what each size costs). Omit for the model default. Larger costs more, sometimes far more: flux-3-image is 55/65/90/130/790 credits per image at 768px/1K/1.5K/2K/4K (flux-3-image-klein 11/12/15/19/48), so confirm with the user before choosing 4K."New value: +"Optional output size (per-model options, e.g. seedream-5.5, seedream-5.0-pro & seedream-5.0-flash: 1K/2K; minimax-h3-image: 2K or 4K; gpt-image-2 & nano-banana-2: up to 4K; nano-banana-2.1: 1K/2K/4K; flux-3-image and flux-3-image-klein: 768px/1K/1.5K/2K/4K — see list_models for what each size costs). Omit for the model default. Larger costs more, sometimes far more: flux-3-image is 55/65/90/130/790 credits per image at 768px/1K/1.5K/2K/4K (flux-3-image-klein 11/12/15/19/48), so confirm with the user before choosing 4K."
  3. Changed1 schema field changed
    • changedInput schema / properties / model / description
      Previous value: -"AI model id. Omit for the default (seedream-5.0-pro — strong identity preservation and precise edits, up to 9 reference images; 55 credits at 1K, 110 at 2K). For fast, low-cost drafts pick flux-3-image-klein (FLUX 3 Klein: 12 credits at 1K, up to 10 free references, images in seconds) or seedream-5.0-flash (flat 25 credits, free references). By job: gpt-image-2.6-sunburst (dense text, complex layouts, precise edits; up to 16 free references), gpt-image-2.6-flare (fast, sharp text; both make transparent cut-outs), seedream-4.5 (photorealism), gpt-image-2 (text in images), nano-banana-2.1 (fast, sharp text in images, up to 9 free references; optional paid search grounding), nano-banana-2 (editing), qwen-image-3.0 (all-rounder), flux-3-image (FLUX 3: up to 10 free references, optional web grounding; priced by size, 55 credits at 768px up to 790 at 4K). Call list_models for the full catalog with prices and input limits."New value: +"AI model id. Omit for the default (seedream-5.5 — natural light and skin, sharp small text, edits that keep the rest as it was, transparent cut-outs from the prompt; up to 10 reference images; 26 credits at 1K, 46 at 2K, plus 10 per reference image). For fast, low-cost drafts pick flux-3-image-klein (FLUX 3 Klein: 12 credits at 1K, up to 10 free references, images in seconds) or seedream-5.0-flash (flat 25 credits, free references). By job: gpt-image-2.6-sunburst (dense text, complex layouts, precise edits; up to 16 free references), gpt-image-2.6-flare (fast, sharp text; both make transparent cut-outs), seedream-4.5 (photorealism), gpt-image-2 (text in images), nano-banana-2.1 (fast, sharp text in images, up to 9 free references; optional paid search grounding), nano-banana-2 (editing), qwen-image-3.0 (all-rounder), flux-3-image (FLUX 3: up to 10 free references, optional web grounding; priced by size, 55 credits at 768px up to 790 at 4K). Call list_models for the full catalog with prices and input limits."
  4. Changed1 schema field changed
    • changedInput schema / properties / model / description
      Previous value: -"AI model id. Omit for the default (seedream-5.5 — natural light and skin, sharp small text, edits that keep the rest of the picture unchanged; 26 credits at 1K, 46 at 2K, plus 10 per reference image, up to 10). seedream-5.0-pro keeps strong identity preservation (55 at 1K / 110 at 2K). For fast, low-cost drafts pick flux-3-image-klein (FLUX 3 Klein: 12 credits at 1K, up to 10 free references, images in seconds) or seedream-5.0-flash (flat 25 credits, free references). By job: gpt-image-2.6-sunburst (dense text, complex layouts, precise edits; up to 16 free references), gpt-image-2.6-flare (fast, sharp text; both make transparent cut-outs), seedream-4.5 (photorealism), gpt-image-2 (text in images), nano-banana-2.1 (fast, sharp text in images, up to 9 free references; optional paid search grounding), nano-banana-2 (editing), qwen-image-3.0 (all-rounder), flux-3-image (FLUX 3: up to 10 free references, optional web grounding; priced by size, 55 credits at 768px up to 790 at 4K). Call list_models for the full catalog with prices and input limits."New value: +"AI model id. Omit for the default (seedream-5.0-pro — strong identity preservation and precise edits, up to 9 reference images; 55 credits at 1K, 110 at 2K). For fast, low-cost drafts pick flux-3-image-klein (FLUX 3 Klein: 12 credits at 1K, up to 10 free references, images in seconds) or seedream-5.0-flash (flat 25 credits, free references). By job: gpt-image-2.6-sunburst (dense text, complex layouts, precise edits; up to 16 free references), gpt-image-2.6-flare (fast, sharp text; both make transparent cut-outs), seedream-4.5 (photorealism), gpt-image-2 (text in images), nano-banana-2.1 (fast, sharp text in images, up to 9 free references; optional paid search grounding), nano-banana-2 (editing), qwen-image-3.0 (all-rounder), flux-3-image (FLUX 3: up to 10 free references, optional web grounding; priced by size, 55 credits at 768px up to 790 at 4K). Call list_models for the full catalog with prices and input limits."
  5. Changed3 schema fields changed
    • changedInput schema / properties / background / description
      Previous value: -"Optional output background for models that support it (see list_models). gpt-image-2.6-sunburst / gpt-image-2.6-flare: \"transparent\" makes a cut-out (a sticker, logo or product) straight from the prompt or an edit, returned as a PNG with transparency. seedream-5.0-flash / seedream-5.0-pro: \"transparent\" only keeps a transparent background when EDITING: pass exactly one input image, a PNG that already has transparent pixels. Omit (or \"opaque\") for a normal image."New value: +"Optional output background for models that support it (see list_models). gpt-image-2.6-sunburst / gpt-image-2.6-flare: \"transparent\" makes a cut-out (a sticker, logo or product) straight from the prompt or an edit, returned as a PNG with transparency; seedream-5.5 does the same. seedream-5.0-flash / seedream-5.0-pro: \"transparent\" only keeps a transparent background when EDITING: pass exactly one input image, a PNG that already has transparent pixels. Omit (or \"opaque\") for a normal image."
    • changedInput schema / properties / model / description
      Previous value: -"AI model id. Omit for the default (seedream-5.0-pro — strong identity preservation, good for edits, up to 9 reference images). For fast, low-cost drafts pick flux-3-image-klein (FLUX 3 Klein: 12 credits at 1K, up to 10 free references, images in seconds) or seedream-5.0-flash (flat 25 credits, free references). By job: gpt-image-2.6-sunburst (dense text, complex layouts, precise edits; up to 16 free references), gpt-image-2.6-flare (fast, sharp text; both make transparent cut-outs), seedream-4.5 (photorealism), gpt-image-2 (text in images), nano-banana-2.1 (fast, sharp text in images, up to 9 free references; optional paid search grounding), nano-banana-2 (editing), qwen-image-3.0 (all-rounder), flux-3-image (FLUX 3: up to 10 free references, optional web grounding; priced by size, 55 credits at 768px up to 790 at 4K). Call list_models for the full catalog with prices and input limits."New value: +"AI model id. Omit for the default (seedream-5.5 — natural light and skin, sharp small text, edits that keep the rest of the picture unchanged; 26 credits at 1K, 46 at 2K, plus 10 per reference image, up to 10). seedream-5.0-pro keeps strong identity preservation (55 at 1K / 110 at 2K). For fast, low-cost drafts pick flux-3-image-klein (FLUX 3 Klein: 12 credits at 1K, up to 10 free references, images in seconds) or seedream-5.0-flash (flat 25 credits, free references). By job: gpt-image-2.6-sunburst (dense text, complex layouts, precise edits; up to 16 free references), gpt-image-2.6-flare (fast, sharp text; both make transparent cut-outs), seedream-4.5 (photorealism), gpt-image-2 (text in images), nano-banana-2.1 (fast, sharp text in images, up to 9 free references; optional paid search grounding), nano-banana-2 (editing), qwen-image-3.0 (all-rounder), flux-3-image (FLUX 3: up to 10 free references, optional web grounding; priced by size, 55 credits at 768px up to 790 at 4K). Call list_models for the full catalog with prices and input limits."
    • changedInput schema / properties / resolution / description
      Previous value: -"Optional output size (per-model options, e.g. seedream-5.0-pro & seedream-5.0-flash: 1K/2K; gpt-image-2 & nano-banana-2: up to 4K; nano-banana-2.1: 1K/2K/4K; flux-3-image and flux-3-image-klein: 768px/1K/1.5K/2K/4K — see list_models for what each size costs). Omit for the model default. Larger costs more, sometimes far more: flux-3-image is 55/65/90/130/790 credits per image at 768px/1K/1.5K/2K/4K (flux-3-image-klein 11/12/15/19/48), so confirm with the user before choosing 4K."New value: +"Optional output size (per-model options, e.g. seedream-5.5, seedream-5.0-pro & seedream-5.0-flash: 1K/2K; gpt-image-2 & nano-banana-2: up to 4K; nano-banana-2.1: 1K/2K/4K; flux-3-image and flux-3-image-klein: 768px/1K/1.5K/2K/4K — see list_models for what each size costs). Omit for the model default. Larger costs more, sometimes far more: flux-3-image is 55/65/90/130/790 credits per image at 768px/1K/1.5K/2K/4K (flux-3-image-klein 11/12/15/19/48), so confirm with the user before choosing 4K."
  6. Changed3 schema fields changed
    • changedInput schema / properties / background / description
      Previous value: -"Optional output background for models that support it (seedream-5.0-flash, seedream-5.0-pro — see list_models). \"transparent\" keeps a transparent background when EDITING: pass exactly one input image, a PNG that already has transparent pixels (a cutout, sticker or logo), and you get back a PNG with transparency. It cannot make a transparent image from text alone. Omit (or \"opaque\") for a normal image."New value: +"Optional output background for models that support it (see list_models). gpt-image-2.6-sunburst / gpt-image-2.6-flare: \"transparent\" makes a cut-out (a sticker, logo or product) straight from the prompt or an edit, returned as a PNG with transparency. seedream-5.0-flash / seedream-5.0-pro: \"transparent\" only keeps a transparent background when EDITING: pass exactly one input image, a PNG that already has transparent pixels. Omit (or \"opaque\") for a normal image."
    • changedInput schema / properties / model / description
      Previous value: -"AI model id. Omit for the default (seedream-5.0-pro — strong identity preservation, good for edits, up to 9 reference images). For fast, low-cost drafts pick flux-3-image-klein (FLUX 3 Klein: 12 credits at 1K, up to 10 free references, images in seconds) or seedream-5.0-flash (flat 25 credits, free references). By job: gpt-image-2.5-sunburst (precise edits), gpt-image-2.5-flare (fast everyday generation), seedream-4.5 (photorealism), gpt-image-2 (text in images), nano-banana-2.1 (fast, sharp text in images, up to 9 free references; optional paid search grounding), nano-banana-2 (editing), qwen-image-3.0 (all-rounder), flux-3-image (FLUX 3: up to 10 free references, optional web grounding; priced by size, 55 credits at 768px up to 790 at 4K). Call list_models for the full catalog with prices and input limits."New value: +"AI model id. Omit for the default (seedream-5.0-pro — strong identity preservation, good for edits, up to 9 reference images). For fast, low-cost drafts pick flux-3-image-klein (FLUX 3 Klein: 12 credits at 1K, up to 10 free references, images in seconds) or seedream-5.0-flash (flat 25 credits, free references). By job: gpt-image-2.6-sunburst (dense text, complex layouts, precise edits; up to 16 free references), gpt-image-2.6-flare (fast, sharp text; both make transparent cut-outs), seedream-4.5 (photorealism), gpt-image-2 (text in images), nano-banana-2.1 (fast, sharp text in images, up to 9 free references; optional paid search grounding), nano-banana-2 (editing), qwen-image-3.0 (all-rounder), flux-3-image (FLUX 3: up to 10 free references, optional web grounding; priced by size, 55 credits at 768px up to 790 at 4K). Call list_models for the full catalog with prices and input limits."
    • changedInput schema / properties / quality / description
      Previous value: -"Optional rendering quality for models that support it (gpt-image-2: low/medium/high; gpt-image-2.5-sunburst and gpt-image-2.5-flare: low/medium/high/xhigh/max; grok-imagine-image-2: low/medium — no high tier). Higher costs more. On grok-imagine-image-2 quality x resolution sets the price (low 1K=50, low 2K=80, medium 1K=80, medium 2K=100 credits). Omit for default."New value: +"Optional rendering quality for models that support it (gpt-image-2: low/medium/high; gpt-image-2.5-sunburst and gpt-image-2.5-flare: low/medium/high/xhigh/max; gpt-image-2.6-sunburst and gpt-image-2.6-flare: low 70, medium 120, high 175, xhigh 340 or max 675 credits per image at any size; grok-imagine-image-2: low/medium — no high tier). Higher costs more. On grok-imagine-image-2 quality x resolution sets the price (low 1K=50, low 2K=80, medium 1K=80, medium 2K=100 credits). Omit for default."
  7. Changed3 schema fields changed
    • changedInput schema / properties / aspect_ratio / description
      Previous value: -"Aspect ratio of the generated image. Omit for the default: 1:1 — except an edit with flux-3-image or nano-banana-2.1, which keeps the first input image's shape unless you set a ratio here."New value: +"Aspect ratio of the generated image. Omit for the default: 1:1 — except an edit with flux-3-image, flux-3-image-klein or nano-banana-2.1, which keeps the first input image's shape unless you set a ratio here."
    • changedInput schema / properties / model / description
      Previous value: -"AI model id. Omit for the default (seedream-5.0-pro — strong identity preservation, good for edits, up to 9 reference images). For fast, low-cost drafts pick flux-2-klein or seedream-5.0-flash (flat 25 credits, free references). By job: gpt-image-2.5-sunburst (precise edits), gpt-image-2.5-flare (fast everyday generation), seedream-4.5 (photorealism), gpt-image-2 (text in images), nano-banana-2.1 (fast, sharp text in images, up to 9 free references; optional paid search grounding), nano-banana-2 (editing), qwen-image-3.0 (all-rounder), flux-3-image (FLUX 3: up to 10 free references, optional web grounding; priced by size, 55 credits at 768px up to 790 at 4K). Call list_models for the full catalog with prices and input limits."New value: +"AI model id. Omit for the default (seedream-5.0-pro — strong identity preservation, good for edits, up to 9 reference images). For fast, low-cost drafts pick flux-3-image-klein (FLUX 3 Klein: 12 credits at 1K, up to 10 free references, images in seconds) or seedream-5.0-flash (flat 25 credits, free references). By job: gpt-image-2.5-sunburst (precise edits), gpt-image-2.5-flare (fast everyday generation), seedream-4.5 (photorealism), gpt-image-2 (text in images), nano-banana-2.1 (fast, sharp text in images, up to 9 free references; optional paid search grounding), nano-banana-2 (editing), qwen-image-3.0 (all-rounder), flux-3-image (FLUX 3: up to 10 free references, optional web grounding; priced by size, 55 credits at 768px up to 790 at 4K). Call list_models for the full catalog with prices and input limits."
    • changedInput schema / properties / resolution / description
      Previous value: -"Optional output size (per-model options, e.g. seedream-5.0-pro & seedream-5.0-flash: 1K/2K; gpt-image-2 & nano-banana-2: up to 4K; nano-banana-2.1: 1K/2K/4K; flux-3-image: 768px/1K/1.5K/2K/4K — see list_models for what each size costs). Omit for the model default. Larger costs more, sometimes far more: flux-3-image is 55/65/90/130/790 credits per image at 768px/1K/1.5K/2K/4K, so confirm with the user before choosing 4K."New value: +"Optional output size (per-model options, e.g. seedream-5.0-pro & seedream-5.0-flash: 1K/2K; gpt-image-2 & nano-banana-2: up to 4K; nano-banana-2.1: 1K/2K/4K; flux-3-image and flux-3-image-klein: 768px/1K/1.5K/2K/4K — see list_models for what each size costs). Omit for the model default. Larger costs more, sometimes far more: flux-3-image is 55/65/90/130/790 credits per image at 768px/1K/1.5K/2K/4K (flux-3-image-klein 11/12/15/19/48), so confirm with the user before choosing 4K."
  8. Changed5 schema fields changed
    • changedInput schema / properties / aspect_ratio / description
      Previous value: -"Aspect ratio of the generated image. Omit for the default: 1:1 — except an edit with flux-3-image, which keeps the first input image's shape unless you set a ratio here."New value: +"Aspect ratio of the generated image. Omit for the default: 1:1 — except an edit with flux-3-image or nano-banana-2.1, which keeps the first input image's shape unless you set a ratio here."
    • addedInput schema / properties / google_search
      Added value: +{
      +  "description": "Optional, nano-banana-2.1 only: ground the image in live Google Search results (weather, scores, recent events, current facts). Off by default. Costs extra: 10 credits per image (list_models shows the current price). Turn it on only when the request needs current, real-world information, and tell the user it adds to the cost.",
      +  "type": "boolean"
      +}
    • addedInput schema / properties / image_search
      Added value: +{
      +  "description": "Optional, nano-banana-2.1 only: let the model look up web images as visual reference before rendering (what a real place, product or landmark looks like). Off by default. It runs a Google Search too, so it costs 20 credits per image in total, with or without google_search (list_models shows the current price). Tell the user it adds to the cost.",
      +  "type": "boolean"
      +}
    • changedInput schema / properties / model / description
      Previous value: -"AI model id. Omit for the default (seedream-5.0-pro — strong identity preservation, good for edits, up to 9 reference images). For fast, low-cost drafts pick flux-2-klein or seedream-5.0-flash (flat 25 credits, free references). By job: gpt-image-2.5-sunburst (precise edits), gpt-image-2.5-flare (fast everyday generation), seedream-4.5 (photorealism), gpt-image-2 (text in images), nano-banana-2 (editing), qwen-image-3.0 (all-rounder), flux-3-image (FLUX 3: up to 10 free references, optional web grounding; priced by size, 55 credits at 768px up to 790 at 4K). Call list_models for the full catalog with prices and input limits."New value: +"AI model id. Omit for the default (seedream-5.0-pro — strong identity preservation, good for edits, up to 9 reference images). For fast, low-cost drafts pick flux-2-klein or seedream-5.0-flash (flat 25 credits, free references). By job: gpt-image-2.5-sunburst (precise edits), gpt-image-2.5-flare (fast everyday generation), seedream-4.5 (photorealism), gpt-image-2 (text in images), nano-banana-2.1 (fast, sharp text in images, up to 9 free references; optional paid search grounding), nano-banana-2 (editing), qwen-image-3.0 (all-rounder), flux-3-image (FLUX 3: up to 10 free references, optional web grounding; priced by size, 55 credits at 768px up to 790 at 4K). Call list_models for the full catalog with prices and input limits."
    • changedInput schema / properties / resolution / description
      Previous value: -"Optional output size (per-model options, e.g. seedream-5.0-pro & seedream-5.0-flash: 1K/2K; gpt-image-2 & nano-banana-2: up to 4K; flux-3-image: 768px/1K/1.5K/2K/4K — see list_models for what each size costs). Omit for the model default. Larger costs more, sometimes far more: flux-3-image is 55/65/90/130/790 credits per image at 768px/1K/1.5K/2K/4K, so confirm with the user before choosing 4K."New value: +"Optional output size (per-model options, e.g. seedream-5.0-pro & seedream-5.0-flash: 1K/2K; gpt-image-2 & nano-banana-2: up to 4K; nano-banana-2.1: 1K/2K/4K; flux-3-image: 768px/1K/1.5K/2K/4K — see list_models for what each size costs). Omit for the model default. Larger costs more, sometimes far more: flux-3-image is 55/65/90/130/790 credits per image at 768px/1K/1.5K/2K/4K, so confirm with the user before choosing 4K."
  9. Changed4 schema fields changed
    • changedInput schema / properties / aspect_ratio / description
      Previous value: -"Aspect ratio of the generated image"New value: +"Aspect ratio of the generated image. Omit for the default: 1:1 — except an edit with flux-3-image, which keeps the first input image's shape unless you set a ratio here."
    • addedInput schema / properties / grounding
      Added value: +{
      +  "description": "Optional, flux-3-image only: let the model research the prompt with web and image search before rendering. On by default and free. Set false for faster, self-contained generation. Omit for the default.",
      +  "type": "boolean"
      +}
    • changedInput schema / properties / model / description
      Previous value: -"AI model id. Omit for the default (seedream-5.0-pro — premium flagship: top quality, strongest identity preservation, great for edits). For fast & cheap drafts pick flux-2-klein (free on Pro/Ultra plans) or seedream-5.0-flash (flat 25 credits, free references). Other strong picks: gpt-image-2.5-sunburst (OpenAI precision edits, premium quality), gpt-image-2.5-flare (fast OpenAI everyday model), seedream-4.5 (photorealism), gpt-image-2 (text in images), nano-banana-2 (premium editing), qwen-image-3.0 (all-rounder). Call list_models for the full catalog with prices and input limits."New value: +"AI model id. Omit for the default (seedream-5.0-pro — strong identity preservation, good for edits, up to 9 reference images). For fast, low-cost drafts pick flux-2-klein or seedream-5.0-flash (flat 25 credits, free references). By job: gpt-image-2.5-sunburst (precise edits), gpt-image-2.5-flare (fast everyday generation), seedream-4.5 (photorealism), gpt-image-2 (text in images), nano-banana-2 (editing), qwen-image-3.0 (all-rounder), flux-3-image (FLUX 3: up to 10 free references, optional web grounding; priced by size, 55 credits at 768px up to 790 at 4K). Call list_models for the full catalog with prices and input limits."
    • changedInput schema / properties / resolution / description
      Previous value: -"Optional output size (per-model options, e.g. seedream-5.0-pro & seedream-5.0-flash: 1K/2K; gpt-image-2 & nano-banana-2: up to 4K — see list_models). Omit for the model default. Larger costs more."New value: +"Optional output size (per-model options, e.g. seedream-5.0-pro & seedream-5.0-flash: 1K/2K; gpt-image-2 & nano-banana-2: up to 4K; flux-3-image: 768px/1K/1.5K/2K/4K — see list_models for what each size costs). Omit for the model default. Larger costs more, sometimes far more: flux-3-image is 55/65/90/130/790 credits per image at 768px/1K/1.5K/2K/4K, so confirm with the user before choosing 4K."
  10. Changed3 schema fields changed
    • addedInput schema / properties / background
      Added value: +{
      +  "description": "Optional output background for models that support it (seedream-5.0-flash, seedream-5.0-pro — see list_models). \"transparent\" keeps a transparent background when EDITING: pass exactly one input image, a PNG that already has transparent pixels (a cutout, sticker or logo), and you get back a PNG with transparency. It cannot make a transparent image from text alone. Omit (or \"opaque\") for a normal image.",
      +  "enum": [
      +    "opaque",
      +    "transparent"
      +  ],
      +  "type": "string"
      +}
    • changedInput schema / properties / model / description
      Previous value: -"AI model id. Omit for the default (seedream-5.0-pro — premium flagship: top quality, strongest identity preservation, great for edits). For fast & cheap drafts pick flux-2-klein (free on Pro/Ultra plans). Other strong picks: gpt-image-2.5-sunburst (OpenAI precision edits, premium quality), gpt-image-2.5-flare (fast OpenAI everyday model), seedream-4.5 (photorealism), gpt-image-2 (text in images), nano-banana-2 (premium editing), qwen-image-3.0 (all-rounder). Call list_models for the full catalog with prices and input limits."New value: +"AI model id. Omit for the default (seedream-5.0-pro — premium flagship: top quality, strongest identity preservation, great for edits). For fast & cheap drafts pick flux-2-klein (free on Pro/Ultra plans) or seedream-5.0-flash (flat 25 credits, free references). Other strong picks: gpt-image-2.5-sunburst (OpenAI precision edits, premium quality), gpt-image-2.5-flare (fast OpenAI everyday model), seedream-4.5 (photorealism), gpt-image-2 (text in images), nano-banana-2 (premium editing), qwen-image-3.0 (all-rounder). Call list_models for the full catalog with prices and input limits."
    • changedInput schema / properties / resolution / description
      Previous value: -"Optional output size (per-model options, e.g. seedream-5.0-pro: 1K/2K; gpt-image-2 & nano-banana-2: up to 4K — see list_models). Omit for the model default. Larger costs more."New value: +"Optional output size (per-model options, e.g. seedream-5.0-pro & seedream-5.0-flash: 1K/2K; gpt-image-2 & nano-banana-2: up to 4K — see list_models). Omit for the model default. Larger costs more."
  11. Changed2 schema fields changed
    • changedInput schema / properties / model / description
      Previous value: -"AI model id. Omit for the default (seedream-5.0-pro — premium flagship: top quality, strongest identity preservation, great for edits). For fast & cheap drafts pick flux-2-klein (free on Pro/Ultra plans). Other strong picks: seedream-4.5 (photorealism), gpt-image-2 (text in images), nano-banana-2 (premium editing), qwen-image-3.0 (all-rounder). Call list_models for the full catalog with prices and input limits."New value: +"AI model id. Omit for the default (seedream-5.0-pro — premium flagship: top quality, strongest identity preservation, great for edits). For fast & cheap drafts pick flux-2-klein (free on Pro/Ultra plans). Other strong picks: gpt-image-2.5-sunburst (OpenAI precision edits, premium quality), gpt-image-2.5-flare (fast OpenAI everyday model), seedream-4.5 (photorealism), gpt-image-2 (text in images), nano-banana-2 (premium editing), qwen-image-3.0 (all-rounder). Call list_models for the full catalog with prices and input limits."
    • changedInput schema / properties / quality / description
      Previous value: -"Optional rendering quality for models that support it (gpt-image-2: low/medium/high; grok-imagine-image-2: low/medium — no high tier). Higher costs more. On grok-imagine-image-2 quality x resolution sets the price (low 1K=50, low 2K=80, medium 1K=80, medium 2K=100 credits). Omit for default."New value: +"Optional rendering quality for models that support it (gpt-image-2: low/medium/high; gpt-image-2.5-sunburst and gpt-image-2.5-flare: low/medium/high/xhigh/max; grok-imagine-image-2: low/medium — no high tier). Higher costs more. On grok-imagine-image-2 quality x resolution sets the price (low 1K=50, low 2K=80, medium 1K=80, medium 2K=100 credits). Omit for default."
  12. First observed

TDQS

A4.7/5.0
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations only say destructiveHint=true and openWorldHint=true; the description adds the crucial operational facts: it submits an async job returning a job_id, images are usually ready in seconds, the finished image comes back inline to display, and every call spends credits from a BudgetPixel balance with failed jobs uncharged. It also warns about large cost jumps (flux-3-image up to 790 credits at 4K) and tells the agent to confirm with the user before choosing 4K.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness3/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The core workflow (mode → async job → poll → display) is front-loaded correctly, but the single dense paragraph then repeats per-model pricing that the schema already documents for model, quality and resolution. The @handle casting sentence is a three-clause example chain that could be trimmed without losing meaning.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a 13-parameter, credit-spending, open-world generator with no output schema, the definition covers everything an agent needs: the async polling loop, that the finished image is returned inline, per-model capability limits, default model, and cost guardrails. Nothing required to call it correctly is missing.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so the baseline is 3, but the description adds real cross-parameter semantics the schema alone doesn't convey: the aspect_ratio default is overridden for edits on specific models, transparent background only works while editing for seedream-5.0-flash/pro, and image_search/google_search both add 20/10 credits that must be surfaced to the user. The cost-model prefixes are partly duplicative with the schema's own per-parameter prose, which keeps it from a 5.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

Opens with a specific verb+resource ("create or edit an AI image") and immediately enumerates both operating modes: text-to-image from a prompt, or image-to-image/editing/multi-reference via input_images. An agent can distinguish this from siblings like check_generation_status or upscale_image without opening any schema.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Explicitly routes the agent: pass input_images for editing, pass a generated image's URL to restyle it, call list_models for per-model input limits, then call check_generation_status to poll. It also names the @handle casting workflow and the exact sibling tools to use for characters, wardrobe items and poses.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.