GET
/v1/schemas/bfl/image/v1/flux-3-image-klein
Accept:
| field | recorded source |
|---|---|
| schema | Source linked above. upstream-spec Source traceea458c661ef8b0e03d72ee6b29267451f5a04ae65f35e55ea8a87e53645ef670{
"fetchedAt": 1792645846,
"extractorVersion": "1",
"verifiedAt": null
} |
Request body
11 properties · 1 required · 0 $defs| property | type | description | constraints |
|---|---|---|---|
| prompt* | string | Free-form prompt describing the image. | |
| user | string | Opaque identifier for the end user supplied by the calling platform. | length ≥ 1 · length ≤ 256 · nullable |
| images | string | string[] | Optional reference image(s), each an http(s) URL or base64, one to 10 total. The first is the image being edited and sets the default output size. | nullable |
| aspect_ratio | string | Output aspect ratio, as in flux-3-image. `auto` (default): for edits, the first reference's exact aspect; for text-to-image, a ratio picked from the prompt (prompt rewrite, else ratio keywords, else 16:9) at the requested tier. Ignored when width and height ar… | 1 known values · default: "auto" |
| resolution | enum | Equal-area size tier, as in flux-3-image: `768sq`, `1k`, `1.5k`, `2k` or `4k`. Omitted: `1k` for text-to-image; for edits the first reference's own size, or its nearest tier when aspect_ratio is set. Ignored when width and height are set. | 768sq | 1k | 1.5k | 2k | 4k · nullable |
| width | integer | Exact output width in pixels, [64, 6256]; set together with height. Overrides resolution and aspect_ratio. | nullable |
| height | integer | Exact output height in pixels, [64, 6256]; width x height at most 16822272 pixels (16.8 MP, the largest 4k bin). | nullable |
| seed | integer | Seed for reproducibility; random when omitted. | 0 ≤ n ≤ 4294967295 · nullable |
| safety_tolerance | integer | Harm moderation tolerance from 0 to 7, with 0 the strictest. The route and organization determine the approved maximum and per-category ceilings. Unapproved levels return 422 with approved levels. | 0 ≤ n ≤ 7 · default: 2 |
| output_format | enum | Output image format: `jpeg` (default) or `png`. | jpeg | png · default: "jpeg" |
| steps | integer | Denoising steps (default 16). | 1 ≤ n ≤ 16 · nullable |
Validate a payload
before you spend tokensshell
$ curl -X POST https://modelschemas.com/v1/validate \
-d '{"provider":"bfl","endpointId":"v1/flux-3-image-klein","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}