Flux 2 Max - Image Editor

Highest-fidelity text-based image editing by Black Forest Labs. Applies natural language edits with maximum quality and consistency, preserving fine details across professional photography, fine art, and premium commercial imagery.

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-max
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 (jpg, png)	png
output_quality	number	No	Output image quality (0-100)	80
steps	number	No	Number of diffusion steps (15-50)	50
guidance	number	No	Prompt adherence scale (2-5)	3
safety_tolerance	number	No	Content safety threshold (1=strictest, 6=most permissive)	2
prompt_upsampling	boolean	No	Automatically enhance prompt for more creative output	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-max",
  "promptObject": {
    "imageUrl": "development/images/2025_12_04_18_10_29_882_cat.png",
    "prompt": "Transform the setting to golden hour lighting with warm tones",
    "steps": 50,
    "guidance": 3,
    "output_format": "png",
    "output_quality": 95,
    "safety_tolerance": 2
  }
}'

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-max',
  promptObject: {
    imageUrl: 'development/images/2025_12_04_18_10_29_882_cat.png',
    prompt: 'Transform the setting to golden hour lighting with warm tones',
    steps: 50,
    guidance: 3,
    output_format: 'png',
    output_quality: 95,
    safety_tolerance: 2
  }
})
})

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-max",
"promptObject": {
  "imageUrl": "development/images/2025_12_04_18_10_29_882_cat.png",
  "prompt": "Transform the setting to golden hour lighting with warm tones",
  "steps": 50,
  "guidance": 3,
  "output_format": "png",
  "output_quality": 95,
  "safety_tolerance": 2
}
}

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

Interactive Playground

API Playground

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

AI Model *Flux 2 Max - Black Forest Labs

Image URL *

Asset path of the source image to edit

Prompt *

Describe the edit you want to apply

Transform the setting to golden hour lighting with warm tones

Steps

Number of diffusion steps (15-50)

Guidance

Prompt adherence scale (2-5)

Safety Tolerance

Content safety threshold (1=strictest, 6=most permissive)

Prompt Upsampling TrueFalse

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-max",
  "promptObject": {
    "imageUrl": "development/images/2025_12_04_18_10_29_882_cat.png",
    "prompt": "Transform the setting to golden hour lighting with warm tones",
    "steps": 50,
    "guidance": 3,
    "output_format": "png",
    "output_quality": 95,
    "safety_tolerance": 2
  }
}'

Response Format

{
"aiRecord": {
  "uuid": "d4e5f6a7-b8c9-0123-defa-234567890123",
  "model": "black-forest-labs/flux-2-max",
  "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": "Transform the setting to golden hour lighting with warm tones",
      "steps": 50,
      "guidance": 3,
      "output_format": "png",
      "output_quality": 95,
      "safety_tolerance": 2
    },
    "resultObject": [
      "development/images/2026_03_27_10_00_04_001_edited.png"
    ]
  },
  "temporaryUrl": "https://s3.us-east-1.amazonaws.com/asset.1min.ai/development/images/2026_03_27_10_00_04_001_edited.png?..."
}
}

Use Cases

• Lighting & Atmosphere: Transform time of day, weather, or mood with maximum fidelity
• Professional Retouching: Fine-detail edits for product and portrait photography
• Fine Art Editing: Apply complex style transformations to high-resolution artwork
• Premium Campaign Imagery: Modify commercial visuals while preserving production quality