Flux 2 Dev - Image Editor

Open-weight text-based image editing model by Black Forest Labs. Uses a 32B parameter architecture to apply natural language instructions to existing images with fine control over inference steps and guidance.

Endpoint

POSThttps://api.1min.ai/api/features

Request Headers

Field	Value
API-KEY	<api-key>
Content-Type	application/json

Parameters

Parameter	Type	Required	Description
type	string	Yes	Must be IMAGE_EDITOR
model	string	Yes	Must be black-forest-labs/flux-2-dev
promptObject	object	Yes	Configuration object containing all editing parameters

Prompt Object Parameters

Parameter	Type	Required	Description	Default
imageUrl	string	Yes	Asset path of the image to edit (from Asset API)	-
prompt	string	Yes	Text description of the desired edit	-
aspect_ratio	string	No	Output aspect ratio (1:1, 16:9, 9:16, 3:2, 2:3, 4:5, 5:4)	match_input_image
output_format	string	No	Output file format (webp, jpg, png)	webp
output_quality	number	No	Output image quality (0-100)	80
num_inference_steps	number	No	Number of denoising steps (1-50)	28
guidance	number	No	Prompt adherence scale (0-10)	3
prompt_strength	number	No	How strongly to apply edits (0-1); lower = more conservative	0.8
go_fast	boolean	No	Enable speed-optimized generation	false
megapixels	string	No	Output resolution in megapixels (0.25, 1)	1
disable_safety_checker	boolean	No	Disable built-in safety filtering	false
seed	number	No	Random seed for reproducibility	Random

Code Examples

cURL

curl -X POST "https://api.1min.ai/api/features" \
-H "API-KEY: <api-key>" \
-H "Content-Type: application/json" \
-d '{
  "type": "IMAGE_EDITOR",
  "model": "black-forest-labs/flux-2-dev",
  "promptObject": {
    "imageUrl": "development/images/2025_12_04_18_10_29_882_cat.png",
    "prompt": "Make it look like a watercolor painting with soft pastel tones",
    "num_inference_steps": 28,
    "guidance": 3.5,
    "prompt_strength": 0.75,
    "output_format": "webp",
    "output_quality": 85
  }
}'

JavaScript

fetch('https://api.1min.ai/api/features', {
method: 'POST',
headers: {
  'Content-Type': 'application/json',
  'API-KEY': 'YOUR_API_KEY'
},
body: JSON.stringify({
  type: 'IMAGE_EDITOR',
  model: 'black-forest-labs/flux-2-dev',
  promptObject: {
    imageUrl: 'development/images/2025_12_04_18_10_29_882_cat.png',
    prompt: 'Make it look like a watercolor painting with soft pastel tones',
    num_inference_steps: 28,
    guidance: 3.5,
    prompt_strength: 0.75,
    output_format: 'webp',
    output_quality: 85
  }
})
})

Python

import requests

url = "https://api.1min.ai/api/features"
headers = {
"Content-Type": "application/json",
"API-KEY": "YOUR_API_KEY"
}

data = {
"type": "IMAGE_EDITOR",
"model": "black-forest-labs/flux-2-dev",
"promptObject": {
  "imageUrl": "development/images/2025_12_04_18_10_29_882_cat.png",
  "prompt": "Make it look like a watercolor painting with soft pastel tones",
  "num_inference_steps": 28,
  "guidance": 3.5,
  "prompt_strength": 0.75,
  "output_format": "webp",
  "output_quality": 85
}
}

response = requests.post(url, headers=headers, json=data)

Interactive Playground

API Playground

GETPOSTPUTDELETEhttps://api.1min.ai/api/features

AI Model *Flux 2 Dev - Black Forest Labs

Image URL *

Asset path of the source image to edit

Prompt *

Describe the edit you want to apply

Make it look like a watercolor painting with soft pastel tones

Inference Steps

Number of denoising steps (1-50)

Guidance

Prompt adherence scale (0-10)

Prompt Strength

How strongly to apply edits (0-1); lower = more conservative

Megapixels 0.25 MP (~512×512)1 MP (~1024×1024)

Output Quality

Output image quality (0-100)

Seed

Random seed for reproducibility

Generated cURL Command:

curl -X POST "https://api.1min.ai/api/features" \
  -H "API-KEY: <your-api-key>" \
  -H "Content-Type: application/json" \
  -d '{
  "type": "IMAGE_EDITOR",
  "model": "black-forest-labs/flux-2-dev",
  "promptObject": {
    "imageUrl": "development/images/2025_12_04_18_10_29_882_cat.png",
    "prompt": "Make it look like a watercolor painting with soft pastel tones",
    "num_inference_steps": 28,
    "guidance": 3.5,
    "prompt_strength": 0.75,
    "output_format": "webp",
    "output_quality": 85
  }
}'

Response Format

{
"aiRecord": {
  "uuid": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
  "model": "black-forest-labs/flux-2-dev",
  "type": "IMAGE_EDITOR",
  "status": "SUCCESS",
  "createdAt": "2026-03-27T10:00:00.000Z",
  "aiRecordDetail": {
    "promptObject": {
      "imageUrl": "development/images/2025_12_04_18_10_29_882_cat.png",
      "prompt": "Make it look like a watercolor painting with soft pastel tones",
      "num_inference_steps": 28,
      "guidance": 3.5,
      "prompt_strength": 0.75,
      "output_format": "webp",
      "output_quality": 85
    },
    "resultObject": [
      "development/images/2026_03_27_10_00_02_001_edited.webp"
    ]
  },
  "temporaryUrl": "https://s3.us-east-1.amazonaws.com/asset.1min.ai/development/images/2026_03_27_10_00_02_001_edited.webp?..."
}
}

Use Cases

• Style Transfer: Apply artistic styles to photos
• Scene Enhancement: Add atmosphere, lighting, or mood changes
• Custom Pipelines: Open-weight model for fine-tuned editing workflows
• Prototype Editing: Rapid iteration with adjustable step count