GET
/v1/schemas/fal/image/fal-ai/ideogram/v3/reframe
Accept:
| field | recorded source |
|---|---|
| schema | Source linked above. upstream-spec Source tracefc6d7a7695dee6e4e9b243dbf5033c699c808942a88427bfc3f976ce20da700f{
"fetchedAt": 1793163602,
"extractorVersion": "1",
"verifiedAt": null
} |
Request body
12 properties · 2 required · 4 $defs| property | type | description | constraints |
|---|---|---|---|
| image_size* | ImageSize | enum | The resolution for the reframed output image | |
| image_url* | string | The image URL to reframe | |
| 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 |
| num_images | integer | Number of images to generate. | 1 ≤ n ≤ 8 · default: 1 |
| 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 |
| 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 |
| enable_safety_checker | boolean | Authorized callers may set false to request relaxed screening. | default: true |
| seed | integer | Seed for the random number generator | nullable |
| style | enum | The style type to generate with. Cannot be used with style_codes. | AUTO | GENERAL | REALISTIC | DESIGN · nullable |
| rendering_speed | enum | The rendering speed to use. | TURBO | BALANCED | QUALITY · default: "BALANCED" |
| 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 |
| 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 |
Types
4 $defsColorPaletteobject
| name | enum | A color palette preset value | EMBER | FRESH | JUNGLE | MAGIC | MELON | MOSAIC · +2 more · nullable |
| members | ColorPaletteMember[] | A list of color palette members that define the color palette | 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
| height | integer | The height of the generated image. | 0 < n ≤ 14142 · default: 512 |
| width | integer | The width of the generated image. | 0 < n ≤ 14142 · default: 512 |
RGBColorobject
| r | integer | Red color value | 0 ≤ n ≤ 255 · default: 0 |
| b | integer | Blue color value | 0 ≤ n ≤ 255 · default: 0 |
| g | integer | Green 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/reframe","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}