GET
/v1/schemas/fal/image/fal-ai/ideogram/v3/replace-background
Accept:
| field | recorded source |
|---|---|
| schema | Source linked above. upstream-spec Source trace22fcc414245fce34f59f15514fb6750198fd4e0da30310dbb47b2c22529d0441{
"fetchedAt": 1793250001,
"extractorVersion": "1",
"verifiedAt": null
} |
Request body
13 properties · 2 required · 3 $defs| property | type | description | constraints |
|---|---|---|---|
| prompt* | string | Cyber punk city with neon lights and skyscrappers | |
| image_url* | string | The image URL whose background needs to be replaced | |
| image_urls | string[] | 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 | nullable |
| seed | integer | Seed for the random number generator | nullable |
| style_preset | enum | Style preset for generation. The chosen style preset will guide the generation. | 80S_ILLUSTRATION | 90S_NOSTALGIA | ABSTRACT_ORGANIC | ANALOG_NOSTALGIA | ART_BRUT | ART_DECO · +56 more · nullable |
| enable_safety_checker | boolean | Authorized callers may set false to request relaxed screening. | default: true |
| style_codes | string[] | A list of 8 character hexadecimal codes representing the style of the image. Cannot be used in conjunction with style_reference_images or style | nullable |
| num_images | integer | Number of images to generate. | 1 ≤ n ≤ 8 · default: 1 |
| sync_mode | boolean | 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 |
| rendering_speed | enum | The rendering speed to use. | TURBO | BALANCED | QUALITY · default: "BALANCED" |
| style | enum | The style type to generate with. Cannot be used with style_codes. | AUTO | GENERAL | REALISTIC | DESIGN · nullable |
| enable_prompt_expansion | boolean | Determine if MagicPrompt should be used in generating the request or not. | default: true |
| color_palette | ColorPalette | 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) | nullable |
Types
3 $defsColorPaletteobject
| members | ColorPaletteMember[] | A list of color palette members that define the color palette | nullable |
| name | enum | A color palette preset value | EMBER | FRESH | JUNGLE | MAGIC | MELON | MOSAIC · +2 more · nullable |
ColorPaletteMemberobject
| color_weight | number | The weight of the color in the color palette | 0.05 ≤ n ≤ 1 · nullable |
| rgb* | RGBColor | RGB color value for the palette member |
RGBColorobject
| b | integer | Blue color value | 0 ≤ n ≤ 255 · default: 0 |
| g | integer | Green color value | 0 ≤ n ≤ 255 · default: 0 |
| r | integer | Red color value | 0 ≤ n ≤ 255 · default: 0 |
Validate a payload
before you spend tokensshell
$ curl -X POST https://modelschemas.com/v1/validate \
-d '{"provider":"fal","endpointId":"fal-ai/ideogram/v3/replace-background","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}