Flux 2 Flex - Image Editor

Maximum-quality text-based image editing with adjustable quality-speed trade-offs. Particularly strong at edits involving typography, design elements, and structured layouts.

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-flex
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	Diffusion steps; 6-10 for speed, 20-50 for quality	25
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-flex",
  "promptObject": {
    "imageUrl": "development/images/2025_12_04_18_10_29_882_cat.png",
    "prompt": "Add the text SALE 50% OFF in bold red letters at the top",
    "steps": 30,
    "guidance": 4,
    "output_format": "png",
    "output_quality": 90,
    "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-flex',
  promptObject: {
    imageUrl: 'development/images/2025_12_04_18_10_29_882_cat.png',
    prompt: 'Add the text SALE 50% OFF in bold red letters at the top',
    steps: 30,
    guidance: 4,
    output_format: 'png',
    output_quality: 90,
    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-flex",
"promptObject": {
  "imageUrl": "development/images/2025_12_04_18_10_29_882_cat.png",
  "prompt": "Add the text SALE 50% OFF in bold red letters at the top",
  "steps": 30,
  "guidance": 4,
  "output_format": "png",
  "output_quality": 90,
  "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 Flex - Black Forest Labs

Image URL *

Asset path of the source image to edit

Prompt *

Describe the edit you want to apply

Add the text SALE 50% OFF in bold red letters at the top

Steps

Diffusion steps: 6-10 for speed, 20-50 for quality

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-flex",
  "promptObject": {
    "imageUrl": "development/images/2025_12_04_18_10_29_882_cat.png",
    "prompt": "Add the text SALE 50% OFF in bold red letters at the top",
    "steps": 30,
    "guidance": 4,
    "output_format": "png",
    "output_quality": 90,
    "safety_tolerance": 2
  }
}'

Response Format

{
"aiRecord": {
  "uuid": "c3d4e5f6-a7b8-9012-cdef-123456789012",
  "model": "black-forest-labs/flux-2-flex",
  "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": "Add the text SALE 50% OFF in bold red letters at the top",
      "steps": 30,
      "guidance": 4,
      "output_format": "png",
      "output_quality": 90,
      "safety_tolerance": 2
    },
    "resultObject": [
      "development/images/2026_03_27_10_00_03_001_edited.png"
    ]
  },
  "temporaryUrl": "https://s3.us-east-1.amazonaws.com/asset.1min.ai/development/images/2026_03_27_10_00_03_001_edited.png?..."
}
}

Use Cases

• Typography Editing: Add or modify text overlays with sharp rendering
• Design Iteration: Adjust layouts, colors, and graphic elements
• Banner & Ad Creation: Modify promotional images with readable text
• UI Mockup Editing: Iterate on design assets with fast step settings