Flux Pro - Image Generator

Premium AI image generation model by Black Forest Labs. Flux Pro delivers exceptional quality with advanced prompt understanding, superior detail rendering, and professional-grade output suitable for commercial applications.

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_GENERATOR`
`model`	string	Yes	AI model identifier. Must be `black-forest-labs/flux-pro`
`promptObject`	object	Yes	Configuration object containing all generation parameters

Prompt Object Parameters

Parameter	Type	Required	Description	Default
`prompt`	string	Yes	Text description of the image to generate	-
`image_prompt`	string	No	Path to input image from Asset API for image-to-image generation	-
`aspect_ratio`	string	No	Image aspect ratio (1:1, 16:9, 9:16, 3:2, 2:3, 4:5, 5:4, custom)	custom
`width`	number	No	Image width in pixels (256-1440, multiple of 32)	1024
`height`	number	No	Image height in pixels (256-1440, multiple of 32)	1024
`steps`	number	No	Number of inference steps (1-50)	25
`guidance`	number	No	Guidance scale for prompt adherence (0-50)	3.5
`interval`	number	No	Processing interval parameter	-
`prompt_upsampling`	boolean	No	Enhance prompt for better results	false
`seed`	number	No	Random seed for reproducibility (0-4294967295)	Random
`output_format`	string	No	Output image format (webp, jpg, png)	webp
`output_quality`	number	No	Output image quality (0-100)	80
`safety_tolerance`	number	No	Safety filter sensitivity (1-5)	2

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
custom	Use specific width/height values

Quality Settings

Setting	Range	Description
Steps	1-50	More steps = higher quality but longer generation time
Guidance	0-50	How closely to follow the prompt (higher = more adherence)
Output Quality	0-100	Image compression quality for final output
Safety Tolerance	1-5	Content filtering sensitivity (1=strict, 5=permissive)

Code Examples

cURL
JavaScript
Python

curl --location 'https://api.1min.ai/api/features' \
--header 'API-KEY: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
"type": "IMAGE_GENERATOR",
"model": "black-forest-labs/flux-pro",
"promptObject": {
  "prompt": "Professional portrait photography, studio lighting, high detail",
  "width": 1024,
  "height": 1024,
  "steps": 30,
  "prompt_upsampling": true,
  "output_quality": 90
}
}'

fetch('https://api.1min.ai/api/features', {
method: 'POST',
headers: {
  'Content-Type': 'application/json',
  'API-KEY': 'YOUR_API_KEY'
},
body: JSON.stringify({
  type: 'IMAGE_GENERATOR',
  model: 'black-forest-labs/flux-pro',
  promptObject: {
    prompt: 'Professional portrait photography, studio lighting, high detail',
    width: 1024,
    height: 1024,
    steps: 30,
    prompt_upsampling: true,
    output_quality: 90
  }
})
})

import requests

url = "https://api.1min.ai/api/features"
headers = {
"Content-Type": "application/json",
"API-KEY": "YOUR_API_KEY"
}

data = {
"type": "IMAGE_GENERATOR",
"model": "black-forest-labs/flux-pro",
"promptObject": {
  "prompt": "Professional portrait photography, studio lighting, high detail",
  "width": 1024,
  "height": 1024,
  "steps": 30,
  "prompt_upsampling": True,
  "output_quality": 90
}
}

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

Interactive Playground

API Playground

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

AI Model *

Prompt *

Describe the image you want to generate

Width

Image width in pixels (256-1440, multiple of 32)

Height

Image height in pixels (256-1440, multiple of 32)

Steps

Number of inference steps (1-50)

Prompt Upsampling

Enhance prompt for better results

Output Format

Output image format

Output Quality

Output image quality (0-100)

Safety Tolerance

Safety filter sensitivity (1-5, higher = more permissive)

Seed

Random seed for reproducibility (0-4294967295)

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_GENERATOR",
  "model": "black-forest-labs/flux-pro",
  "promptObject": {
    "prompt": "Professional portrait photography, studio lighting, high detail",
    "aspect_ratio": "16:9",
    "width": 1024,
    "height": 1024,
    "num_outputs": 1,
    "steps": 25,
    "guidance": 3.5,
    "prompt_upsampling": false,
    "output_quality": 80
  }
}'

Response Format

{
"aiRecord": {
  "uuid": "e8e3d645-d5a4-4c18-975b-95395d3b49e1",
  "userId": "c937fbcc-fa8f-4565-a440-c4d87f56fcb2",
  "teamId": "a4e176b2-dabb-451e-9c58-62b451fa9630",
  "teamUser": {
    "teamId": "a4e176b2-dabb-451e-9c58-62b451fa9630",
    "userId": "c937fbcc-fa8f-4565-a440-c4d87f56fcb2",
    "userName": "John Doe",
    "userAvatar": "https://lh3.googleusercontent.com/a/ACg8ocLqgsNsHRfmWF9d-E1RvJetVsEzxNOsOg-NXWNTpMxLDPJbwELI=s96-c",
    "status": "ACTIVE",
    "role": "ADMIN",
    "creditLimit": 100000000,
    "usedCredit": 1895205,
    "createdAt": "2025-10-20T04:13:40.847Z",
    "createdBy": "SYSTEM",
    "updatedAt": "2025-10-23T10:44:02.196Z",
    "updatedBy": "SYSTEM"
  },
  "model": "black-forest-labs/flux-pro",
  "type": "IMAGE_GENERATOR",
  "metadata": null,
  "rating": null,
  "feedback": null,
  "conversationId": null,
  "status": "SUCCESS",
  "createdAt": "2025-10-24T08:00:44.752Z",
  "aiRecordDetail": {
    "promptObject": {
      "steps": 25,
      "width": 1024,
      "height": 1024,
      "prompt": "Professional portrait photography, studio lighting, high detail",
      "output_quality": 80,
      "prompt_upsampling": false
    },
    "resultObject": [
      "development/images/2025_10_24_15_00_52_401_480067.undefined"
    ],
    "responseObject": {}
  },
  "additionalData": null,
  "temporaryUrl": "https://s3.us-east-1.amazonaws.com/asset.1min.ai/development/images/2025_10_24_15_00_52_401_480067.undefined?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIAVRUVQEFIHSKAXGE7%2F20251024%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20251024T080054Z&X-Amz-Expires=604800&X-Amz-Signature=9b0012b3e3858de65048c405fe5767f2bc0e50af66d92a4476a4f9eb0f8e66ac&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject"
}
}

Use Cases

Professional Photography: High-quality portraits, product shots, architectural imagery
Commercial Design: Marketing materials, advertising campaigns, brand content
Digital Art: Detailed illustrations, concept art, fine art pieces
Print Media: High-resolution images for magazines, posters, brochures
Creative Projects: Book covers, album artwork, game assets

Tips for Best Results

Quality Settings:
- Use 25-35 steps for high quality
- Enable prompt upsampling for complex descriptions
- Set output quality to 85-95 for professional work
Resolution Planning:
- Choose dimensions that match your intended use
- Use multiples of 32 for optimal results
- Higher resolutions increase generation time
Prompt Optimization:
- Be specific about lighting, style, and composition
- Include technical photography terms for realistic images
- Use artistic style references for creative work

Notes

Safety Filters

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

Endpoint​

Request Headers​

Parameters​

Prompt Object Parameters​

Supported Aspect Ratios​

Quality Settings​

Code Examples​

Interactive Playground​