GET
/v1/schemas/fal/image/fal-ai/ideogram/character/remix
Accept:
| field | recorded source |
|---|---|
| schema | Source linked above. upstream-spec Source trace6c8ae27f6e14d4d2be466d2fc220be142c5c781458dbef30e1d077aad985299c{
"fetchedAt": 1793250001,
"extractorVersion": "1",
"verifiedAt": null
} |
Request body
17 properties · 3 required · 4 $defs| property | type | description | constraints |
|---|---|---|---|
| reference_image_urls* | string[] | 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 | |
| prompt* | string | The prompt to remix the image with | |
| image_url* | string | The image URL to remix | |
| seed | integer | Seed for the random number generator | 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 |
| image_size | ImageSize | enum | The resolution of the generated image | nullable · default: "square_hd" |
| strength | number | Strength of the input image in the remix | 0.01 ≤ n ≤ 1 · default: 0.8 |
| 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 | REALISTIC | FICTION · default: "AUTO" |
| 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 |
| 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 |
| negative_prompt | string | Description of what to exclude from an image. Descriptions in the prompt take precedence to descriptions in the negative prompt. | default: "" |
| 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 |
| reference_mask_urls | string[] | 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 | |
| enable_prompt_expansion | boolean | Determine if MagicPrompt should be used in generating the request or not. | default: true |
Types
4 $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 |
ImageSizeobject
| width | integer | The width of the generated image. | 0 < n ≤ 14142 · default: 512 |
| height | integer | The height of the generated image. | 0 < n ≤ 14142 · default: 512 |
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/character/remix","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}