Flux Kontext Max - Image Text Editor

Premium AI image editing model with maximum quality output and advanced contextual understanding. Flux Kontext Max excels at complex transformations while preserving image coherence and maintaining natural-looking results.

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	Feature type identifier. Must be IMAGE_EDITOR
model	string	Yes	AI model identifier. Must be black-forest-labs/flux-kontext-max
promptObject	object	Yes	Configuration object containing all image editing parameters

Prompt Object Parameters

Parameter	Type	Required	Description	Default
imageUrl	string	Yes	Path to the source image to be edited	-
prompt	string	Yes	Text description of the desired image transformation	-
aspect_ratio	string	No	Output aspect ratio (1:1, 16:9, 9:16, 3:2, 2:3, 4:5, 5:4)	match_input_image
prompt_upsampling	boolean	No	Enable advanced prompt interpretation	false
seed	number	No	Random seed for reproducibility (0-4294967295)	0
safety_tolerance	number	No	Content safety threshold (1-6)	2
format	string	No	Output image format (png, jpeg, webp)	png

Supported Aspect Ratios

Ratio	Use Case
1:1	Square images, social media posts
16:9	Widescreen, video thumbnails
9:16	Vertical video, mobile screens
3:2	Standard photography
2:3	Portrait photography
4:5	Instagram posts
5:4	Landscape photography

Quality Settings

Setting	Range	Description
Safety Tolerance	1-6	Content filtering sensitivity (1=strict, 6=permissive)
Prompt Upsampling	true/false	Enhanced prompt interpretation
Format	png/jpeg/webp	Output image format

Code Examples

cURL

curl --location 'https://api.1min.ai/api/features' \
--header 'API-KEY: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
"type": "IMAGE_EDITOR",
"model": "black-forest-labs/flux-kontext-max",
"promptObject": {
  "imageUrl": "development/images/2025_02_16_15_42_40_711_human.jpg",
  "prompt": "transform into a professional studio portrait with dramatic lighting and elegant composition",
  "aspect_ratio": "match_input_image",
  "prompt_upsampling": true,
  "seed": 42,
  "safety_tolerance": 3,
  "format": "png"
}
}'

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-kontext-max',
  promptObject: {
    imageUrl: 'development/images/2025_02_16_15_42_40_711_human.jpg',
    prompt: 'transform into a professional studio portrait with dramatic lighting and elegant composition',
    aspect_ratio: 'match_input_image',
    prompt_upsampling: true,
    seed: 42,
    safety_tolerance: 3,
    format: 'png'
  }
})
})

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-kontext-max",
"promptObject": {
  "imageUrl": "development/images/2025_02_16_15_42_40_711_human.jpg",
  "prompt": "transform into a professional studio portrait with dramatic lighting and elegant composition",
  "aspect_ratio": "match_input_image",
  "prompt_upsampling": True,
  "seed": 42,
  "safety_tolerance": 3,
  "format": "png"
}
}

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

Interactive Playground

API Playground

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

AI Model *Flux Kontext Max

Image URL *

Path to the source image to be edited

Prompt *

Describe the transformation you want to apply

transform into a professional studio portrait with dramatic lighting and elegant composition

Aspect Ratio

Output aspect ratio

Match Input Value1:1 (Square)16:9 (Widescreen)9:16 (Portrait)3:2 (Standard)2:3 (Portrait)4:5 (Instagram)5:4 (Landscape)

Prompt Upsampling

Enable advanced prompt interpretation

falsetrue

Seed

Random seed for reproducibility (0-4294967295)

Safety Tolerance

Content safety threshold (1-6, higher = more permissive)

Output Format

Output image format

PNGJPEGWebP

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-kontext-max",
  "promptObject": {
    "imageUrl": "development/images/2025_02_16_15_42_40_711_human.jpg",
    "prompt": "transform into a professional studio portrait with dramatic lighting and elegant composition",
    "aspect_ratio": "match_input_image",
    "prompt_upsampling": true,
    "seed": 42,
    "safety_tolerance": 3,
    "format": "png"
  }
}'

Response Format

{
"aiRecord": {
  "uuid": "e8e3d645-d5a4-4c18-975b-95395d3b49e1",
  "userId": "c937fbcc-fa8f-4565-a440-c4d87f56fcb2",
  "teamId": "a4e176b2-dabb-451e-9c58-62b451fa9630",
  "model": "black-forest-labs/flux-kontext-max",
  "type": "IMAGE_EDITOR",
  "status": "SUCCESS",
  "createdAt": "2025-10-24T08:00:44.752Z",
  "aiRecordDetail": {
    "promptObject": {
      "imageUrl": "development/images/2025_02_16_15_42_40_711_human.jpg",
      "prompt": "transform into a professional studio portrait with dramatic lighting and elegant composition",
      "aspect_ratio": "match_input_image",
      "prompt_upsampling": true,
      "seed": 42,
      "safety_tolerance": 3,
      "format": "png"
    },
    "resultObject": [
      "development/images/2025_10_24_15_00_52_401_480067.png"
    ]
  },
  "temporaryUrl": "https://s3.us-east-1.amazonaws.com/asset.1min.ai/development/images/2025_10_24_15_00_52_401_480067.png?X-Amz-Algorithm=AWS4-HMAC-SHA256..."
}
}

Use Cases

• Professional Photography: High-quality portraits, product shots, architectural imagery
• Digital Art: Detailed illustrations, concept art, fine art pieces
• Commercial Design: Marketing materials, advertising campaigns, brand content
• Creative Projects: Style transfers, artistic transformations, mood adjustments
• Social Media: Platform-optimized content creation in various aspect ratios

Tips for Best Results

1. Quality Settings:

   • Enable prompt upsampling for complex descriptions
   • Use appropriate safety tolerance for your content type
   • Choose PNG for maximum quality, JPEG for smaller files

2. Aspect Ratio Planning:

   • Select ratios that match your intended use case
   • Consider platform requirements (Instagram 1:1, Stories 9:16)
   • Use 16:9 for presentations and widescreen content

3. Prompt Optimization:

   • Be specific about style, lighting, and composition
   • Include technical photography or art terms
   • Reference specific artistic styles or techniques

Safety Filters

Content filtering is automatically applied. Adjust safety tolerance (1-6) to balance creative freedom with content guidelines.