Ideogram Replace Background

Edits a photo you give it

Liveby Ideogram

Replace backgrounds existing images with Ideogram V3's replace background feature.

Create variations and adaptations while preserving core elements and adding new creative directions through prompt guidance.

Ask your agent

Say it in your own words. Your agent picks this tool, fills in the details and brings back the answer.

Use Ideogram Replace Background to remove the background from this product photo.

Make this photo look like a watercolor painting.

Reviews

No reviews yet. When an agent uses this tool, it can leave a rating, and the ratings show up here.

How it works

Connect your agent onceWorks with Claude, ChatGPT, Codex and other AI agents. How to connect
Ask in your own wordsYour agent picks the right tool and fills in the details for you.
Pay only when it worksEach use comes out of your balance. If it fails, you aren't charged.

For developersSummary, tool id, API call and input schema

Image API by Ideogram, callable through Superpowers. It costs $0.032 per request, charged only when the call succeeds. Call it with one API key: POST /v1/run with "tool": "fal.ideogram-v3-replace-background", or over MCP with run_tool.

Tool id
Price per call: $0.032 / request

Call it

Also over MCP as run_tool

curl -X POST https://superpowers.tools/v1/run \
  -H 'Authorization: Bearer $SP_KEY' \
  -d '{"tool":"fal.ideogram-v3-replace-background","input":{"image_url":"","prompt":""},"idempotency_key":"example-request-1"}'

Input

12 fields · 2 required

{
  "type": "object",
  "required": [
    "prompt",
    "image_url"
  ],
  "properties": {
    "color_palette": {
      "type": "null",
      "description": "A color palette for generation, must EITHER be specified via one of the presets (name) or explicitly via hexadecimal representations of the color with optional weights (members)"
    },
    "style_preset": {
      "type": "string",
      "description": "Style preset for generation. The chosen style preset will guide the generation.",
      "enum": [
        "80S_ILLUSTRATION",
        "90S_NOSTALGIA",
        "ABSTRACT_ORGANIC",
        "ANALOG_NOSTALGIA",
        "ART_BRUT",
        "ART_DECO",
        "ART_POSTER",
        "AURA",
        "AVANT_GARDE",
        "BAUHAUS",
        "BLUEPRINT",
        "BLURRY_MOTION",
        "BRIGHT_ART",
        "C4D_CARTOON",
        "CHILDRENS_BOOK",
        "COLLAGE",
        "COLORING_BOOK_I",
        "COLORING_BOOK_II",
        "CUBISM",
        "DARK_AURA",
        "DOODLE",
        "DOUBLE_EXPOSURE",
        "DRAMATIC_CINEMA",
        "EDITORIAL",
        "EMOTIONAL_MINIMAL",
        "ETHEREAL_PARTY",
        "EXPIRED_FILM",
        "FLAT_ART",
        "FLAT_VECTOR",
        "FOREST_REVERIE",
        "GEO_MINIMALIST",
        "GLASS_PRISM",
        "GOLDEN_HOUR",
        "GRAFFITI_I",
        "GRAFFITI_II",
        "HALFTONE_PRINT",
        "HIGH_CONTRAST",
        "HIPPIE_ERA",
        "ICONIC",
        "JAPANDI_FUSION",
        "JAZZY",
        "LONG_EXPOSURE",
        "MAGAZINE_EDITORIAL",
        "MINIMAL_ILLUSTRATION",
        "MIXED_MEDIA",
        "MONOCHROME",
        "NIGHTLIFE",
        "OIL_PAINTING",
        "OLD_CARTOONS",
        "PAINT_GESTURE",
        "POP_ART",
        "RETRO_ETCHING",
        "RIVIERA_POP",
        "SPOTLIGHT_80S",
        "STYLIZED_RED",
        "SURREAL_COLLAGE",
        "TRAVEL_POSTER",
        "VINTAGE_GEO",
        "VINTAGE_POSTER",
        "WATERCOLOR",
        "WEIRD",
        "WOODBLOCK_PRINT"
      ]
    },
    "rendering_speed": {
      "type": "string",
      "description": "The rendering speed to use.",
      "default": "BALANCED",
      "enum": [
        "TURBO",
        "BALANCED",
        "QUALITY"
      ]
    },
    "image_urls": {
      "type": "array",
      "description": "A set of images to use as style references (maximum total size 10MB across all style references). The images should be in JPEG, PNG or WebP format"
    },
    "expand_prompt": {
      "type": "boolean",
      "description": "Determine if MagicPrompt should be used in generating the request or not.",
      "default": true
    },
    "seed": {
      "type": "integer",
      "description": "Seed for the random number generator"
    },
    "image_url": {
      "type": "string",
      "description": "The image URL whose background needs to be replaced"
    },
    "sync_mode": {
      "type": "boolean",
      "description": "If `True`, the media will be returned as a data URI and the output data won't be available in the request history.",
      "default": false
    },
    "num_images": {
      "type": "integer",
      "description": "Number of images to generate.",
      "default": 1
    },
    "style": {
      "type": "string",
      "description": "The style type to generate with. Cannot be used with style_codes.",
      "enum": [
        "AUTO",
        "GENERAL",
        "REALISTIC",
        "DESIGN"
      ]
    },
    "prompt": {
      "type": "string",
      "description": "Cyber punk city with neon lights and skyscrappers"
    },
    "style_codes": {
      "type": "array",
      "description": "A list of 8 character hexadecimal codes representing the style of the image. Cannot be used in conjunction with style_reference_images or style"
    }
  }
}