{"version":"1","model":{"id":"fal-ai/ideogram/v3/replace-background","name":"Ideogram v3 Replace BG","kind":"image","availability":"available","available":true,"restricted":false,"api_key_only":false,"description":"Ideogram v3 Replace Background — intelligent background replacement using a reference subject image.","categories":["background","inpaint"],"prompt_required":true,"prompt_supported":true,"supports":{"referenceImage":true},"requires":{"referenceImage":true},"aspect_ratios":["1:1","16:9","9:16","4:3","3:4"],"resolutions":["1024"],"qualities":["low","medium","high"],"durations":[],"max_images":4,"base_credits":4,"api_gross_margin_percent":20,"added_at":"2026-05-03","popularity_rank":169,"example_prompt":"Replace the background with a rustic Nashville honky-tonk stage — warm stage lights in amber and red, weathered wooden floorboards, vintage microphone stand nearby, neon beer signs glowing in the background, the feel of a legendary live music venue","preview":{"image":"https://cdn.artemotion.ai/file/artemotion-ai-bckt/model-previews/ideogram-v3-replace-bg-sm.webp"},"schema_url":"/api/v1/models?id=fal-ai%2Fideogram%2Fv3%2Freplace-background","input_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","$id":"https://www.artemotion.ai/api/v1/models?id=fal-ai%2Fideogram%2Fv3%2Freplace-background","title":"Ideogram v3 Replace BG generation request","description":"Request body accepted by POST /api/v1/generate for fal-ai/ideogram/v3/replace-background.","type":"object","properties":{"model_id":{"type":"string","const":"fal-ai/ideogram/v3/replace-background","description":"ArtEmotion model identifier."},"extra":{"type":"object","additionalProperties":true,"description":"Model-specific settings may also be nested here."},"max_credits":{"type":"number","minimum":1,"description":"Reject before submission if the estimated list price exceeds this cap."},"webhook_url":{"type":"string","format":"uri","maxLength":2048},"webhook_secret":{"type":"string","maxLength":512},"folder_id":{"type":"string"},"prompt":{"type":"string"},"style_preset":{"title":"Style Preset","description":"Style preset for generation. The chosen style preset will guide the generation.","type":"string","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"]},"style":{"title":"Style","description":"The style type to generate with. Cannot be used with style_codes.","type":"string","enum":["AUTO","GENERAL","REALISTIC","DESIGN"]},"expand_prompt":{"title":"Expand Prompt","description":"Determine if MagicPrompt should be used in generating the request or not.","default":true,"type":"boolean"},"color_palette":{"title":"Color Palette","description":"A color palette preset to guide the colors of the generated image.","type":"string","enum":["EMBER","FRESH","JUNGLE","MAGIC","MELON","MOSAIC","PASTEL","ULTRAMARINE"]},"style_codes":{"title":"Style Codes","description":"List of 8-character hex style codes to guide the image style. Cannot be used with style or image_urls.","type":"array","items":{"type":"string"}},"image_urls":{"title":"Style Reference Images","description":"URLs of images to use as style references (max 10MB total, JPEG/PNG/WebP). Cannot be used with style_codes.","type":"array","items":{"type":"string"}},"seed":{"title":"Seed","description":"Seed for the random number generator","type":"integer"},"aspect_ratio":{"type":"string","enum":["1:1","16:9","9:16","4:3","3:4"]},"resolution":{"type":"string","enum":["1024"]},"quality":{"type":"string","enum":["low","medium","high"]},"num_images":{"type":"integer","minimum":1,"maximum":4},"reference_image_url":{"type":"string","format":"uri"}},"required":["model_id","prompt","reference_image_url"],"additionalProperties":false},"parameters":[{"key":"style_preset","label":"Style Preset","type":"select","options":["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"],"description":"Style preset for generation. The chosen style preset will guide the generation."},{"key":"style","label":"Style","type":"select","options":["AUTO","GENERAL","REALISTIC","DESIGN"],"description":"The style type to generate with. Cannot be used with style_codes."},{"key":"expand_prompt","label":"Expand Prompt","type":"toggle","default":true,"description":"Determine if MagicPrompt should be used in generating the request or not."},{"key":"color_palette","label":"Color Palette","type":"select","options":["EMBER","FRESH","JUNGLE","MAGIC","MELON","MOSAIC","PASTEL","ULTRAMARINE"],"description":"A color palette preset to guide the colors of the generated image."},{"key":"style_codes","label":"Style Codes","type":"string_array","description":"List of 8-character hex style codes to guide the image style. Cannot be used with style or image_urls."},{"key":"image_urls","label":"Style Reference Images","type":"string_array","description":"URLs of images to use as style references (max 10MB total, JPEG/PNG/WebP). Cannot be used with style_codes."},{"key":"seed","label":"Seed","type":"seed","description":"Seed for the random number generator"}]}}