Flux Depth Pro - Image Text Editor

Professional-grade depth-aware AI image editing model designed for advanced image manipulation. Flux Depth Pro specializes in understanding image depth and spatial relationships, enabling sophisticated edits that maintain proper perspective and depth cues.

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-depth-pro`
`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	-
`seed`	number	No	Random seed for reproducibility (0-4294967295)	0
`steps`	number	No	Number of inference steps for generation quality	28
`prompt_upsampling`	boolean	No	Enable advanced prompt interpretation	false
`guidance`	number	No	How closely to follow the prompt (1.0-20.0)	3.5
`safety_tolerance`	number	No	Content safety threshold (1-6)	2
`format`	string	No	Output image format (jpg, png, webp)	jpg

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-depth-pro",
  "promptObject": {
    "imageUrl": "development/images/2025_02_16_15_42_40_711_human.jpg",
    "prompt": "Add realistic depth blur to background while keeping subject sharp",
    "seed": 42,
    "steps": 28,
    "prompt_upsampling": true,
    "guidance": 3.5,
    "safety_tolerance": 2,
    "format": "jpg"
  }
}'

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-depth-pro',
  promptObject: {
    imageUrl: 'development/images/2025_02_16_15_42_40_711_human.jpg',
    prompt: 'Add realistic depth blur to background while keeping subject sharp',
    seed: 42,
    steps: 28,
    prompt_upsampling: true,
    guidance: 3.5,
    safety_tolerance: 2,
    format: 'jpg'
  }
})
})

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-depth-pro",
"promptObject": {
  "imageUrl": "development/images/2025_02_16_15_42_40_711_human.jpg",
  "prompt": "Add realistic depth blur to background while keeping subject sharp",
  "seed": 42,
  "steps": 28,
  "prompt_upsampling": True,
  "guidance": 3.5,
  "safety_tolerance": 2,
  "format": "jpg"
}
}

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

Interactive Playground

API Playground

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

AI Model *

Image URL *

Path to the source image to be edited

Prompt *

Description of desired depth-aware edits

Seed

Seed for reproducible results (0-4294967295)

Steps

Number of inference steps (1-50)

Prompt Upsampling

Enhance prompt with AI

Guidance

How closely to follow prompt (1.0-20.0)

Safety Tolerance

Content filtering level (1-6)

Format

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-depth-pro",
  "promptObject": {
    "imageUrl": "development/images/2025_02_16_15_42_40_711_human.jpg",
    "prompt": "Add realistic depth blur to background while keeping subject sharp",
    "seed": 42,
    "steps": 28,
    "prompt_upsampling": false,
    "guidance": 3.5,
    "safety_tolerance": 2,
    "format": "jpg"
  }
}'

Response Format

Success Response (200)

{
"aiRecord": {
  "uuid": "ac32acf4-0b2e-400e-9edf-cb3086c30a2c",
  "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": 8164605,
    "createdAt": "2025-10-20T04:13:40.847Z",
    "createdBy": "SYSTEM",
    "updatedAt": "2025-10-27T05:06:17.651Z",
    "updatedBy": "SYSTEM"
  },
  "model": "black-forest-labs/flux-depth-pro",
  "type": "IMAGE_EDITOR",
  "metadata": null,
  "rating": null,
  "feedback": null,
  "conversationId": null,
  "status": "SUCCESS",
  "createdAt": "2025-10-27T08:43:17.647Z",
  "aiRecordDetail": {
    "promptObject": {
      "seed": 42,
      "steps": 28,
      "format": "jpg",
      "prompt": "Add realistic depth blur to background while keeping subject sharp",
      "imageUrl": "development/images/2025_02_16_15_42_40_711_human.jpg",
      "guidance": 3.5,
      "safety_tolerance": 2,
      "prompt_upsampling": false
    },
    "resultObject": [
      "development/images/2025_10_27_15_43_26_155_702365.jpg"
    ],
    "responseObject": {}
  },
  "additionalData": null,
  "temporaryUrl": "https://s3.us-east-1.amazonaws.com/asset.1min.ai/development/images/2025_10_27_15_43_26_155_702365.jpg?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIAVRUVQEFIHSKAXGE7%2F20251027%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20251027T084331Z&X-Amz-Expires=604800&X-Amz-Signature=5a66ff004deed5654ac44a823be7c4d1c8850503cb66a4445ce745c5caec5525&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject"
}
}

Use Cases

Depth of field effects: Create realistic bokeh and background blur
3D scene enhancement: Add depth cues to flat images
Portrait enhancement: Professional depth-based portrait effects
Architectural visualization: Emphasize spatial relationships in buildings
Product photography: Create layered depth for compelling product shots
Cinematic effects: Apply depth-based lighting and atmosphere

Tips for Best Results

Describe depth relationships: "foreground sharp, background blurred", "layers of depth"
Use spatial terminology: "near", "far", "in front of", "behind", "depth of field"
Higher steps for quality: Use 35-50 steps for complex depth effects
Adjust guidance carefully: Lower values (2-4) for subtle effects, higher (5-8) for dramatic changes
Consider lighting: Depth effects work best with proper lighting cues
Test different seeds: Depth processing can vary significantly with different seeds
Use JPEG for efficiency: Good balance of quality and file size for depth-processed images

Endpoint​

Request Headers​

Parameters​

Prompt Object Parameters​

Code Examples​

Interactive Playground​