falImage to imageComing soon

fal-ai/ideogram/character/edit

Name: fal-ai/ideogram/character/edit
Brand: fal

fal-ai/ideogram/character/edit is an image to image tool from fal that runs in the background and returns images. Coming soon: listed with its price, not yet open to runs.

This tool is listed but not yet available to run.

Priced by usage

Pricing

$0.065 per image. Billed on num_images, default 1. The final charge comes from usage.

Limits

Runs: In the background
Returns: image
Longest queue wait: 3600s
Run deadline: 1800s
Largest inline input: 1024 KB
Largest input file: 500 MB
Largest output: 4768 MB
Outputs per run: 16

Input

Field	Kind	Default	Description
`image_urls`	URLs or files	—	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
`rendering_speed`	one of TURBO, BALANCED, QUALITY	BALANCED	The rendering speed to use.
`color_palette`	JSON	—	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_codes`	list	—	A list of 8 character hexadecimal codes representing the style of the image. Cannot be used in conjunction with style_reference_images or style
`expand_prompt`	true or false	true	Determine if MagicPrompt should be used in generating the request or not.
`num_images`	number (whole) 1 to 8	1	Number of images to generate.
`seed`	number (whole)	—	Seed for the random number generator
`prompt` required	text	—	The prompt to fill the masked part of the image.
`image_url` required	URL or file	—	The image URL to generate an image from. MUST have the exact same dimensions (width and height) as the mask image.
`mask_url` required	URL or file	—	The mask URL to inpaint the image. MUST have the exact same dimensions (width and height) as the input image.
`reference_image_urls` required	URLs or files	—	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
`reference_mask_urls`	list	—	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

Same request in code

curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "fal",
    "model": "fal-ai/ideogram/character/edit",
    "input": {
      "prompt": "woman holding bag",
      "image_url": "https://v3.fal.media/files/panda/-LC_gNNV3wUHaGMQT3klE_output.png",
      "mask_url": "https://v3.fal.media/files/panda/jVDAgSkpsZFDP080ceSZJ_woman_face_mask.png",
      "reference_image_urls": [
        "<reference_image_urls>"
      ]
    }
  }'