About FLUX 3 Image
FLUX 3 Image generates images from a text prompt, edits an existing image from a written instruction, and combines up to ten reference images into one output. Output ranges from 768 x 768 drafts to roughly 16 megapixels at 4K, across 15 aspect ratios from 21:9 to 9:21.
Edits name what to change and leave the rest of the image untouched: recolor, replace, move or remove an element, or restyle the whole frame. With several references, each image is cited by its position ("image 1", "image 2") and can supply a subject, product, setting or style. For exact placement, a JSON list of bounding boxes appended to the prompt positions each element on a 0 to 1000 grid, both for new layouts and for targeted edits. Optional grounding lets the model search the web and images so real places, products and events are rendered accurately; without it, generation is faster and uses the prompt alone.
Ready to build with FLUX 3 Image?
Try FLUX 3 Image in the Workbench to prompt it, compare outputs, and iterate on prompts without writing any code. When you're ready to ship, call the same model from our API and build your own apps on top of it.
curl -sSf -X POST https://hub.oxen.ai/api/ai/images/edit \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $OXEN_API_KEY" \
-d '{
"model": "flux-3-image",
"prompt": "A cat sitting on a chair",
"aspect_ratio": "auto",
"resolution": "1k",
"grounding": false,
"safety_tolerance": 2
}'Request parameters
Every field FLUX 3 Image accepts in the request body. See the API reference for response formats.
https://hub.oxen.ai/api/ai/images/edit| Field | Type | Required | Default | Description |
|---|---|---|---|---|
prompt | string | Yes | — | Prompt for the generated image. Use @Image1, @Image2, etc. to reference the input images. |
input_image | array<string>nullable | No | — | Input images to edit or use as reference, up to 10. Reference them in the prompt as @Image1, @Image2, etc. |
aspect_ratio | string | No | "auto" | auto21:92:116:93:27:54:35:41:14:53:45:72:39:161:29:21 |
resolution | string | No | "1k" | 768sq1k2k4k |
grounding | boolean | No | false | Search the web and images before generating, so real places, products and events come out right. Slower than generating from the prompt alone. |
safety_tolerance | integer | No | 2 | Safety filter strictness, 0 is strictest.01234 |