GET
/v1/schemas/bfl/image/v1/flux-3-image
Accept:
| field | recorded source |
|---|---|
| schema | Source linked above. upstream-spec Source traceea458c661ef8b0e03d72ee6b29267451f5a04ae65f35e55ea8a87e53645ef670{
"fetchedAt": 1792645846,
"extractorVersion": "1",
"verifiedAt": null
} |
Request body
10 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) the prompt edits or draws from; each is an http(s) URL or base64, one to 10 total. | nullable |
| aspect_ratio | string | Output aspect ratio. Under `auto` a ratio the prompt asks for wins, otherwise the output keeps the first reference image's framing; without references the prompt decides, else 1:1. | 1 known values · default: "auto" |
| resolution | enum | Image resolution class, an equal-pixel-area tier: `768sq`, `1k` (default), `1.5k`, `2k`, or `4k`. Exact dimensions vary with the aspect ratio. `match_input` (edits only): the output keeps the first reference's own size (shrunk to 4 MP when larger), or its near… | 768sq | 1k | 1.5k | 2k | 4k | match_input · default: "1k" |
| width | integer | Exact output width in pixels, [256, 6256]; set together with height. Overrides resolution and aspect_ratio. | nullable |
| height | integer | Exact output height in pixels, [256, 6256]; width x height at most 16822272 pixels, and at most 4194304 with reference images. | 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 |
| grounding | boolean | When true (default) the prompt may be grounded in external research: web search and image search. When false, both are off. | default: true |
| version | const | Endpoint version. `latest` (default) serves the current release; dated pinnable release tags are added here as they are published. | "latest" · default: "latest" |
Validate a payload
before you spend tokensshell
$ curl -X POST https://modelschemas.com/v1/validate \
-d '{"provider":"bfl","endpointId":"v1/flux-3-image","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}