Image GenerationFlux
Flux 2 Dev
Quality image generation and editing with open weights and reference image support.
POST /v2/images/generate — model: "flux-2-dev"
Open-weight image generation and editing model with support for up to 5 reference images. Optimized for efficiency through guidance distillation, making it faster than typical models of this size.
See Image Generation overview for common request fields, response format, and error codes.
Model-specific parameters
| Parameter | Type | Description |
|---|---|---|
fluxParams.aspect_ratio | string | Aspect ratio in "W:H" format. Use "match_input_image" to match the first input image |
fluxParams.output_format | string | Output format: "jpg", "png", or "webp" |
fluxParams.output_quality | integer | Output quality (0–100). Not relevant for PNG |
fluxParams.seed | integer | Random seed for reproducible generation |
fluxParams.width | integer | Width (256–2048). Only used when aspect_ratio is custom |
fluxParams.height | integer | Height (256–2048). Only used when aspect_ratio is custom |
fluxParams.input_images | string[] | Up to 5 reference image URLs for image-to-image / multi-reference editing |
fluxParams.go_fast | boolean | Enable additional optimizations for faster predictions |
Code examples
curl -X POST https://api.apiframe.ai/v2/images/generate \
-H "X-API-Key: afk_your_api_key_here" \
-H "Content-Type: application/json" \
-d '{
"prompt": "a minimalist ceramic coffee mug with steam rising, product photography",
"model": "flux-2-dev",
"fluxParams": {
"aspect_ratio": "1:1",
"output_format": "jpg",
"go_fast": true
}
}'import requests
response = requests.post(
"https://api.apiframe.ai/v2/images/generate",
headers={
"X-API-Key": "afk_your_api_key_here",
"Content-Type": "application/json",
},
json={
"prompt": "a minimalist ceramic coffee mug with steam rising, product photography",
"model": "flux-2-dev",
"fluxParams": {
"aspect_ratio": "1:1",
"output_format": "jpg",
"go_fast": True,
},
},
)
print(response.json())const response = await fetch("https://api.apiframe.ai/v2/images/generate", {
method: "POST",
headers: {
"X-API-Key": "afk_your_api_key_here",
"Content-Type": "application/json",
},
body: JSON.stringify({
prompt: "a minimalist ceramic coffee mug with steam rising, product photography",
model: "flux-2-dev",
fluxParams: { aspect_ratio: "1:1", output_format: "jpg", go_fast: true },
}),
});
console.log(await response.json());Try it
POST
/v2/images/generateTry it