Catalog/Image/fal

Ideogram V3 Character Edit

Edits a photo you give it

Liveby Ideogram

Modify consistent characters while preserving their core identity.

Edit poses, expressions, or clothing without losing recognizable character features

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 V3 Character Edit 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.108 per request, charged only when the call succeeds. Call it with one API key: POST /v1/run with "tool": "fal.ideogram-character-edit", or over MCP with run_tool.

Tool id
Price per call: $0.108 / 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-character-edit","input":{"mask_url":"","reference_image_urls":["marketing digital"],"image_url":"","prompt":""},"idempotency_key":"example-request-1"}'

Input

13 fields · 4 required

{
  "type": "object",
  "required": [
    "prompt",
    "image_url",
    "mask_url",
    "reference_image_urls"
  ],
  "properties": {
    "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"
    },
    "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)"
    },
    "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"
    },
    "mask_url": {
      "type": "string",
      "description": "The mask URL to inpaint the image. MUST have the exact same dimensions (width and height) as the input image."
    },
    "reference_image_urls": {
      "type": "array",
      "description": "A set of images to use as character references. Currently only 1 image is supported, rest will be ignored. (maximum total size 10MB across all character references). The images should be in JPEG, PNG or WebP format"
    },
    "image_url": {
      "type": "string",
      "description": "The image URL to generate an image from. MUST have the exact same dimensions (width and height) as the mask image."
    },
    "num_images": {
      "type": "integer",
      "description": "Number of images to generate.",
      "default": 1
    },
    "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
    },
    "reference_mask_urls": {
      "type": "array",
      "description": "A set of masks to apply to the character references. Currently only 1 mask is supported, rest will be ignored. (maximum total size 10MB across all character references). The masks should be in JPEG, PNG or WebP format"
    },
    "prompt": {
      "type": "string",
      "description": "The prompt to fill the masked part of the image."
    }
  }
}