Flux Canny Pro - Image Text Editor
Professional-grade edge-aware AI image editing model designed for precise structural control. Flux Canny Pro specializes in understanding and manipulating image edges and contours, enabling sophisticated edits that preserve important structural details while allowing creative transformations.
Endpoint
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-canny-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-canny-pro",
"promptObject": {
"imageUrl": "development/images/2025_02_16_15_42_40_711_human.jpg",
"prompt": "Transform into a pencil sketch while preserving edge details",
"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-canny-pro',
promptObject: {
imageUrl: 'development/images/2025_02_16_15_42_40_711_human.jpg',
prompt: 'Transform into a pencil sketch while preserving edge details',
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-canny-pro",
"promptObject": {
"imageUrl": "development/images/2025_02_16_15_42_40_711_human.jpg",
"prompt": "Transform into a pencil sketch while preserving edge details",
"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/featuresPath to the source image to be edited
Description of desired edge-aware edits
Seed for reproducible results (0-4294967295)
Number of inference steps (1-50)
Enhance prompt with AI
How closely to follow prompt (1.0-20.0)
Content filtering level (1-6)
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-canny-pro",
"promptObject": {
"imageUrl": "development/images/2025_02_16_15_42_40_711_human.jpg",
"prompt": "Transform into a pencil sketch while preserving edge details",
"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-canny-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": "Transform into a pencil sketch while preserving edge details",
"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
- Edge-preserving style transfer: Apply artistic styles while maintaining structural integrity
- Architectural visualization: Enhance building outlines and structural details
- Technical illustrations: Create precise line drawings from photographs
- Logo and graphic design: Convert images to clean vector-like representations
- Product sketching: Transform product photos into technical sketches
- Portrait line art: Create detailed line drawings from portrait photos
Tips for Best Results
- Emphasize edge preservation: Use terms like "preserve edges", "maintain structure", "sharp outlines"
- Specify line qualities: "thin lines", "bold contours", "detailed edges", "clean boundaries"
- Higher steps for precision: Use 35-50 steps for detailed edge-aware transformations
- Moderate guidance values: 3-5 works well for balanced edge preservation and creativity
- Consider contrast: High-contrast source images produce better edge detection
- Test different seeds: Edge processing can vary significantly with random variations
- JPEG for line art: Good balance for edge-heavy content with smaller file sizes