Flux 2 Pro - Image Editor

High-quality text-based image editing model by Black Forest Labs. Describe the change you want in plain language and Flux 2 Pro applies it while preserving the rest of the image.

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-pro`
`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)	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
JavaScript
Python

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-pro",
  "promptObject": {
    "imageUrl": "development/images/2025_12_04_18_10_29_882_cat.png",
    "prompt": "Change the background to a snowy mountain landscape",
    "aspect_ratio": "match_input_image",
    "steps": 25,
    "guidance": 3,
    "output_format": "png",
    "safety_tolerance": 2
  }
}'

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-pro',
  promptObject: {
    imageUrl: 'development/images/2025_12_04_18_10_29_882_cat.png',
    prompt: 'Change the background to a snowy mountain landscape',
    aspect_ratio: 'match_input_image',
    steps: 25,
    guidance: 3,
    output_format: 'png',
    safety_tolerance: 2
  }
})
})

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-pro",
"promptObject": {
  "imageUrl": "development/images/2025_12_04_18_10_29_882_cat.png",
  "prompt": "Change the background to a snowy mountain landscape",
  "aspect_ratio": "match_input_image",
  "steps": 25,
  "guidance": 3,
  "output_format": "png",
  "safety_tolerance": 2
}
}

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

Interactive Playground

API Playground

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

AI Model *

Image URL *

Asset path of the source image to edit

Prompt *

Describe the edit you want to apply

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

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-pro",
  "promptObject": {
    "imageUrl": "development/images/2025_12_04_18_10_29_882_cat.png",
    "prompt": "Change the background to a snowy mountain landscape",
    "aspect_ratio": "match_input_image",
    "steps": 25,
    "guidance": 3,
    "output_format": "png",
    "safety_tolerance": 2
  }
}'

Response Format

{
"aiRecord": {
  "uuid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "model": "black-forest-labs/flux-2-pro",
  "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": "Change the background to a snowy mountain landscape",
      "steps": 25,
      "guidance": 3,
      "output_format": "png",
      "safety_tolerance": 2
    },
    "resultObject": [
      "development/images/2026_03_27_10_00_01_001_edited.png"
    ]
  },
  "temporaryUrl": "https://s3.us-east-1.amazonaws.com/asset.1min.ai/development/images/2026_03_27_10_00_01_001_edited.png?..."
}
}

Use Cases

Background Replacement: Swap backgrounds while preserving subjects
Style Transfer: Reframe existing images in a new visual style
Product Retouching: Modify product imagery for different campaigns
Scene Modification: Add, remove, or change elements with natural language

Endpoint​

Request Headers​

Parameters​

Prompt Object Parameters​

Code Examples​

Interactive Playground​