Documentation Index Fetch the complete documentation index at: https://docs.oxen.ai/llms.txt
Use this file to discover all available pages before exploring further.
Try FLUX.2 Klein 9B in the Workbench Run this model interactively, tune parameters, and compare outputs.
Model ID: black-forest-labs-flux-2-klein-9bFLUX.2 Klein 9B from Black Forest Labs is a lightweight version of the FLUX.2 family featuring 9 billion parameters, designed for efficient text-to-image generation with support for various aspect ratios and quality settings. It accepts text prompts and optional image inputs for reference, producing high-quality PNG, JPEG, or WebP images. Key features include customizable inference steps (1-50), guidance scale, and seed control for reproducible results. Ideal for real-time applications and resource-constrained environments.
Example request Use the Workbench as a request builder: configure parameters for this model in the UI, then open the API tab to copy the exact cURL or Python call. Sync
Async
Async with SSE
See the image editing reference for more details. Minimal
Basic parameters
All parameters
curl -X POST https://hub.oxen.ai/api/ai/images/edit \ -H "Content-Type: application/json" \ -H "Authorization: Bearer $OXEN_API_KEY " \ -d '{ "model": "black-forest-labs-flux-2-klein-9b", "prompt": "<prompt>" }'
curl -X POST https://hub.oxen.ai/api/ai/images/edit \ -H "Content-Type: application/json" \ -H "Authorization: Bearer $OXEN_API_KEY " \ -d '{ "model": "black-forest-labs-flux-2-klein-9b", "prompt": "<prompt>", "input_image": [ "https://hub.oxen.ai/api/repos/elau/assets/file/main/bloxy/bloxy_cropped_512x512.png" ] }'
curl -X POST https://hub.oxen.ai/api/ai/images/edit \ -H "Content-Type: application/json" \ -H "Authorization: Bearer $OXEN_API_KEY " \ -d '{ "model": "black-forest-labs-flux-2-klein-9b", "prompt": "<prompt>", "input_image": [ "https://hub.oxen.ai/api/repos/elau/assets/file/main/bloxy/bloxy_cropped_512x512.png" ], "aspect_ratio": "1:1", "output_quality": "standard", "output_format": "png", "num_inference_steps": 28, "guidance_scale": 2.0 }'
See the async queue reference for more details. Minimal
Basic parameters
All parameters
# Enqueue, capture the generation id. GEN_ID = $( curl -s -X POST https://hub.oxen.ai/api/ai/queue \ -H "Content-Type: application/json" \ -H "Authorization: Bearer $OXEN_API_KEY " \ -d '{ "model": "black-forest-labs-flux-2-klein-9b", "prompt": "<prompt>" }' | jq -r '.generations[0].generation_id' ) # Poll until the generation reaches a terminal status. while true ; do STATUS = $( curl -s -H "Authorization: Bearer $OXEN_API_KEY " \ "https://hub.oxen.ai/api/ai/queue/ $GEN_ID " | jq -r '.status' ) echo "Status: $STATUS " case $STATUS in succeeded | failed | cancelled ) break ;; esac sleep 5 done # Print the result. curl -s -H "Authorization: Bearer $OXEN_API_KEY " \ "https://hub.oxen.ai/api/ai/queue/ $GEN_ID " | jq .
# Enqueue, capture the generation id. GEN_ID = $( curl -s -X POST https://hub.oxen.ai/api/ai/queue \ -H "Content-Type: application/json" \ -H "Authorization: Bearer $OXEN_API_KEY " \ -d '{ "model": "black-forest-labs-flux-2-klein-9b", "prompt": "<prompt>", "input_image": [ "https://hub.oxen.ai/api/repos/elau/assets/file/main/bloxy/bloxy_cropped_512x512.png" ] }' | jq -r '.generations[0].generation_id' ) # Poll until the generation reaches a terminal status. while true ; do STATUS = $( curl -s -H "Authorization: Bearer $OXEN_API_KEY " \ "https://hub.oxen.ai/api/ai/queue/ $GEN_ID " | jq -r '.status' ) echo "Status: $STATUS " case $STATUS in succeeded | failed | cancelled ) break ;; esac sleep 5 done # Print the result. curl -s -H "Authorization: Bearer $OXEN_API_KEY " \ "https://hub.oxen.ai/api/ai/queue/ $GEN_ID " | jq .
# Enqueue, capture the generation id. GEN_ID = $( curl -s -X POST https://hub.oxen.ai/api/ai/queue \ -H "Content-Type: application/json" \ -H "Authorization: Bearer $OXEN_API_KEY " \ -d '{ "model": "black-forest-labs-flux-2-klein-9b", "prompt": "<prompt>", "input_image": [ "https://hub.oxen.ai/api/repos/elau/assets/file/main/bloxy/bloxy_cropped_512x512.png" ], "aspect_ratio": "1:1", "output_quality": "standard", "output_format": "png", "num_inference_steps": 28, "guidance_scale": 2.0 }' | jq -r '.generations[0].generation_id' ) # Poll until the generation reaches a terminal status. while true ; do STATUS = $( curl -s -H "Authorization: Bearer $OXEN_API_KEY " \ "https://hub.oxen.ai/api/ai/queue/ $GEN_ID " | jq -r '.status' ) echo "Status: $STATUS " case $STATUS in succeeded | failed | cancelled ) break ;; esac sleep 5 done # Print the result. curl -s -H "Authorization: Bearer $OXEN_API_KEY " \ "https://hub.oxen.ai/api/ai/queue/ $GEN_ID " | jq .
See the async queue reference for more details. Minimal
Basic parameters
All parameters
# Enqueue, capture the generation id. GEN_ID = $( curl -s -X POST https://hub.oxen.ai/api/ai/queue \ -H "Content-Type: application/json" \ -H "Authorization: Bearer $OXEN_API_KEY " \ -d '{ "model": "black-forest-labs-flux-2-klein-9b", "prompt": "<prompt>" }' | jq -r '.generations[0].generation_id' ) # Stream the SSE channel, grab the data line that follows a # media_generation_completed event for our id, and pretty-print it. curl -sN -H "Authorization: Bearer $OXEN_API_KEY " https://hub.oxen.ai/api/events \ | awk -v id=" $GEN_ID " ' /^event: media_generation_completed$/ { expect=1; next } /^data: / && expect { payload = substr($0, 7) if (index(payload, "\"generation_id\":\"" id "\"")) { print payload; exit } expect = 0 } ' | jq .
# Enqueue, capture the generation id. GEN_ID = $( curl -s -X POST https://hub.oxen.ai/api/ai/queue \ -H "Content-Type: application/json" \ -H "Authorization: Bearer $OXEN_API_KEY " \ -d '{ "model": "black-forest-labs-flux-2-klein-9b", "prompt": "<prompt>", "input_image": [ "https://hub.oxen.ai/api/repos/elau/assets/file/main/bloxy/bloxy_cropped_512x512.png" ] }' | jq -r '.generations[0].generation_id' ) # Stream the SSE channel, grab the data line that follows a # media_generation_completed event for our id, and pretty-print it. curl -sN -H "Authorization: Bearer $OXEN_API_KEY " https://hub.oxen.ai/api/events \ | awk -v id=" $GEN_ID " ' /^event: media_generation_completed$/ { expect=1; next } /^data: / && expect { payload = substr($0, 7) if (index(payload, "\"generation_id\":\"" id "\"")) { print payload; exit } expect = 0 } ' | jq .
# Enqueue, capture the generation id. GEN_ID = $( curl -s -X POST https://hub.oxen.ai/api/ai/queue \ -H "Content-Type: application/json" \ -H "Authorization: Bearer $OXEN_API_KEY " \ -d '{ "model": "black-forest-labs-flux-2-klein-9b", "prompt": "<prompt>", "input_image": [ "https://hub.oxen.ai/api/repos/elau/assets/file/main/bloxy/bloxy_cropped_512x512.png" ], "aspect_ratio": "1:1", "output_quality": "standard", "output_format": "png", "num_inference_steps": 28, "guidance_scale": 2.0 }' | jq -r '.generations[0].generation_id' ) # Stream the SSE channel, grab the data line that follows a # media_generation_completed event for our id, and pretty-print it. curl -sN -H "Authorization: Bearer $OXEN_API_KEY " https://hub.oxen.ai/api/events \ | awk -v id=" $GEN_ID " ' /^event: media_generation_completed$/ { expect=1; next } /^data: / && expect { payload = substr($0, 7) if (index(payload, "\"generation_id\":\"" id "\"")) { print payload; exit } expect = 0 } ' | jq .
Fetch model details The models endpoint returns the full model object, including its json_request_schema.
curl -H "Authorization: Bearer $OXEN_API_KEY " https://hub.oxen.ai/api/ai/models/black-forest-labs-flux-2-klein-9b
Request parameters Required parameters Field Type Default Description promptstring— Text description of the image to generate
Optional parameters Field Type Default Description input_imagearray<string>— Input images to transform or use as reference (supports multiple image urls) aspect_ratiostring"1:1"Aspect ratio for the generated image One of: 1:1, 16:9, 9:16, 4:3, 3:4. output_qualitystring"standard"Quality setting for output image One of: standard, high. output_formatstring"png"Format of the output image One of: png, jpeg, webp. seedinteger— Random seed. Leave blank to randomize num_inference_stepsinteger28Number of denoising steps Range: 1 – 50. guidance_scalenumber2.0Scale for classifier-free guidance Range: 0.0 – 10.0.
