Spiral gives your agent every tool with one account. Browse the tools →

falImageAvailable now

Ideogram V3 Edit

fal-ai/ideogram/v3/edit

Edit and enhance images with Ideogram V3 Edit from fal through one Spiral API key. It runs in the background and returns images. Pay as you go, with no subscription.

Pricing

$0.039 per image. Billed on num_images, default 1.

Limits

Runs
In the background
Returns
image
Longest queue wait
1 hour
Run deadline
30 minutes
Longest run, end to end
225 minutes
Largest inline input
1 MB
Largest input file
2 GB
Largest output
5 GB

Input

FieldKindDefaultDescription
image_urlsURLs 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_speedone of
TURBO, BALANCED, QUALITY
BALANCED

The rendering speed to use.

color_paletteJSON—

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_codeslist—

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_prompttrue or falsetrue

Determine if MagicPrompt should be used in generating the request or not.

num_imagesnumber (whole)
1 to 8
1

Number of images to generate.

seednumber (whole)—

Seed for the random number generator

style_presetone of
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
—

Style preset for generation. The chosen style preset will guide the generation.

prompt requiredtext—

The prompt to fill the masked part of the image.

image_url requiredURL 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 requiredURL or file—

The mask URL to inpaint the image. MUST have the exact same dimensions (width and height) as the input image.

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/v3/edit",
    "input": {
      "prompt": "black bag",
      "image_url": "https://v3.fal.media/files/panda/-LC_gNNV3wUHaGMQT3klE_output.png",
      "mask_url": "https://v3.fal.media/files/kangaroo/1dd3zEL5MXQ3Kb4-mRi9d_indir%20(20).png"
    }
  }'

Frequently asked questions

How much does Ideogram V3 Edit cost?

$0.039 per image. Billed on `num_images`, default 1. You pay as you go from one Spiral balance, with no subscription, and a failed run is not charged.

How do I use Ideogram V3 Edit through an API?

Send `POST /v1/runs` with `"provider": "fal"`, `"model": "fal-ai/ideogram/v3/edit"` and the input fields on this page, using one Spiral API key. It runs in the background: poll the run, or name a webhook to be told when it finishes.

Do I need an account with fal to use Ideogram V3 Edit?

No. Spiral runs it on its own fal account and charges your Spiral balance.

Can my AI agent use Ideogram V3 Edit?

Yes. Agents find and run it through Spiral's MCP server, CLI or agent skill, with the same API key.