Skip to main content

Flux Kontext Dev - Image Text Editor

Development-focused AI image editing model with advanced parameter control and high-quality output. Perfect for developers and researchers who need fine-grained control over the image generation process.

Endpoint​

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

Request Headers​

FieldValue
API-KEY<api-key>
Content-Typeapplication/json

Parameters​

ParameterTypeRequiredDescription
typestringYesFeature type identifier. Must be IMAGE_EDITOR
modelstringYesAI model identifier. Must be black-forest-labs/flux-kontext-dev
promptObjectobjectYesConfiguration object containing all image editing parameters

Prompt Object Parameters​

ParameterTypeRequiredDescriptionDefault
imageUrlstringYesPath to the source image to be edited-
promptstringYesText description of the desired image transformation-
aspect_ratiostringNoOutput aspect ratio (1:1, 16:9, 9:16, 3:2, 2:3, 4:5, 5:4)match_input_image
num_inference_stepsnumberNoNumber of denoising steps (1-50)28
guidancenumberNoGuidance scale for prompt adherence (1.0-20.0)3.5
seednumberNoRandom seed for reproducibility (0-4294967295)0
output_qualitynumberNoOutput quality level (0-100)80
disable_safety_checkerbooleanNoDisable content safety filteringfalse
go_fastbooleanNoEnable faster processing with reduced qualityfalse
formatstringNoOutput image format (png, jpeg, webp)webp

Code Examples​

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-dev",
"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",
  "num_inference_steps": 28,
  "guidance": 3.5,
  "seed": 0,
  "output_quality": 80,
  "disable_safety_checker": false,
  "go_fast": true,
  "format": "webp"
}
}'

Interactive Playground​

API Playground

https://api.1min.ai/api/features
Path to the source image to be edited
Describe the transformation you want to apply
Output aspect ratio
Number of denoising steps (1-50)
Guidance scale for prompt adherence (1.0-20.0)
Random seed for reproducibility (0-4294967295)
Output quality level (0-100)
Disable content safety filtering
Enable faster processing with reduced quality
Output image format

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-dev",
  "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",
    "num_inference_steps": 28,
    "guidance": 3.5,
    "seed": 0,
    "output_quality": 80,
    "disable_safety_checker": false,
    "go_fast": true,
    "format": "webp"
  }
}'

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-dev",
  "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",
      "num_inference_steps": 28,
      "guidance": 3.5,
      "seed": 0,
      "output_quality": 80,
      "disable_safety_checker": false,
      "go_fast": true,
      "format": "webp"
    },
    "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​

  • Development & Testing: Fine-tune parameters for optimal results in research environments
  • Professional Photography: High-quality portrait and commercial photography enhancement
  • Creative Projects: Artistic transformations with precise control over generation parameters
  • Content Creation: Platform-optimized imagery with customizable quality levels
  • Prototyping: Rapid iteration with adjustable inference steps and guidance

Tips for Best Results​

  1. Parameter Tuning:

    • Use higher inference steps (30-50) for better quality
    • Adjust guidance scale (7.5-10.0) for prompt adherence
    • Set output quality to "high" for final production images

  2. Development Workflow:

    • Start with "draft" quality for quick iterations
    • Use consistent seeds for reproducible results
    • Fine-tune guidance for your specific use case

  3. Quality Optimization:

    • Higher inference steps = better quality but slower generation
    • Standard quality sufficient for most use cases
    • Use specific aspect ratios for platform requirements
Development Focus

This model provides extensive parameter control ideal for developers and researchers who need fine-grained control over the generation process.

  • Creative experimentation: Explore different guidance scales and inference steps for artistic effects
  • Batch processing: Use consistent seeds for reproducible results across image sets
  • Quality control: Adjust output quality based on speed vs quality requirements
  • Custom workflows: Integrate precise parameter control into automated image processing pipelines

Tips for Best Results​

  • Adjust inference steps for quality: Use 30-50 steps for high quality, 15-25 for faster results
  • Fine-tune guidance scale: Higher values (10-15) for strict prompt adherence, lower (5-8) for creative freedom
  • Use consistent seeds: Save successful seeds for reproducible results across similar images
  • Match quality to use case: Use 'high' for final outputs, 'draft' for quick previews
  • Experiment with aspect ratios: Choose ratios that complement your subject matter
  • Balance speed vs quality: Lower inference steps and draft quality for rapid iteration