Skip to main content
Glama

remove image background

remove_image_background
Destructive

Remove an image background using a catalog model that supports remove_background. The selected model determines transparency support. Use get_model_catalog to choose a supported model and its settings. Returns a tracked task and playable result when complete.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
modelYesActive model ID supporting this operation. Use get_model_catalog.
promptNoEdit or enhancement instructions.
maxCostUsdNoMaximum charge for each output. Checked against authoritative pricing before generation.
resolutionNo
aspectRatioNo
endFrameUrlNo
mediaInputsNoNamed media slots from get_model_catalog, for example reference_image_uri or mask_url.
scaleFactorNoUpscaling multiplier when supported by the selected model.
sparkTaskIdNoOriginating Spark task for library history and recovery.
workspaceIdNo
outputFormatNoOutput format when supported by the selected model.
generateAudioNoExplicitly enable or disable generated video audio, when supported.
modelSettingsNoModel-specific controls using keys and options from get_model_catalog inputConstraints.slots.
sourceMediaIdYesCompleted workspace source media. The original is preserved.
idempotencyKeyNoStable request key. Retries with the same key reuse the existing output and do not start another paid generation.
sourceImageUrlNoPublic HTTP(S) source image/start-frame URL. Use mediaId for workspace images.
sourceVideoUrlNoPublic HTTP(S) source-video URL.
endFrameMediaIdNoWorkspace image for the final frame, when supported by the selected model.
referenceImagesNoImages to guide generation. Use labels such as person or product and refer to them as @person or @product in the prompt. Each item accepts a workspace mediaId or a public HTTP(S) URL.
sourceImageMediaIdNoWorkspace image to use as the source image/start frame.
sourceVideoMediaIdNoWorkspace video to edit or transform, when supported by the selected model.

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault
dataNo
errorNo
successYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

A3.7/5.0
Behavior3/5

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

Annotations already declare destructiveHint=true, openWorldHint=true, idempotentHint=false and readOnlyHint=false, so the safety profile is covered structurally. The description adds modest context: model-dependent transparency support and asynchronous completion ('Returns a tracked task... when complete'). It does not discuss cost, credit consumption, or reversibility, which is a real gap given a paid destructive generation tool.

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

Conciseness4/5

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

Three short sentences, front-loaded with the core action before the model-selection and return-behavior details. No filler, though the final sentence restates what the output schema already conveys.

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

Completeness4/5

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

For a 21-parameter async image-generation-adjacent tool with an output schema and full annotations, the description covers the essentials: what it does, model dependency, and task-based return. It is slightly thin on cost/authorization context given destructiveHint=true and the paid-generation nature, but nothing critical for invocation is missing.

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

Parameters3/5

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

Schema description coverage is high (81%) across 21 params, so the schema already documents most arguments. The description only reiterates the model/get_model_catalog relationship already in the schema and adds the transparency-support nuance, which is marginal added meaning. Baseline 3 is appropriate.

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?

States a specific verb+resource ('Remove an image background') and immediately scopes it to catalog models that support remove_background. This clearly distinguishes it from the sibling remove_video_background and remove_video_background_media tools, so an agent can select correctly without opening schemas.

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

Usage Guidelines3/5

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

It gives one actionable routing instruction ('Use get_model_catalog to choose a supported model and its settings'), which is genuinely useful for picking the required model param. However, it offers no when-to-use/when-not guidance relative to the many sibling image/video editing tools, and no prerequisites beyond the model lookup.

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.

Resources