Leonardo Diffusion XL - Image Generator
Advanced diffusion-based AI image generation model by Leonardo AI. Delivers exceptional artistic quality with sophisticated diffusion algorithms, superior detail reproduction, creative versatility, and comprehensive controls including Alchemy enhancement, Prompt Magic, and professional-grade features for artistic applications.
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_GENERATOR |
model | string | Yes | AI model identifier. Must be 1e60896f-3c26-4296-8ecc-53e2afecc132 |
promptObject | object | Yes | Configuration object containing all generation parameters |
Prompt Object Parameters
Basic Parameters
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
prompt | string | Yes | Text description of the image to generate | - |
size | string | Yes | Generated image dimensions | 1024x1024 |
n | number | Yes | Number of images to generate (1-4) | 1 |
negativePrompt | string | No | Describe what you don't want in the image | - |
Leonardo Common Parameters
| Parameter | Type | Required | Description | Default | Range |
|---|---|---|---|---|---|
leonardo_guidance_scale | integer | No | How strongly generation reflects the prompt | 7 | 1-20 |
leonardo_num_inference_steps | integer | No | Number of inference steps for generation | 15 | 10-60 |
leonardo_seed | integer | No | Fixed seed for consistency across generations | - | 0-9999999998 |
leonardo_tilling | boolean | No | Whether images should tile on all axes | false | - |
leonardo_transparency | string | No | Type of transparency to use | - | disabled, foreground_only |
leonardo_preset_style | string | No | Style preset for generation | - | Dynamic based on Alchemy settings |
Image Guidance Parameters
| Parameter | Type | Required | Description | Default | Range |
|---|---|---|---|---|---|
leonardo_image_prompts | array | No | Upload images to use as image prompts | - | Max 4 images |
leonardo_init_image_id | string | No | Init image ID to influence generation features | - | Required for Fantasy Avatar |
leonardo_init_strength | float | No | How strongly generated images reflect init image | - | 0.1-0.9 |
leonardo_fantasy_avatar | boolean | No | Enable Fantasy Avatar feature (requires Init Image ID when enabled) | false | - |
Alchemy Parameters
| Parameter | Type | Required | Description | Default | Range |
|---|---|---|---|---|---|
leonardo_alchemy | boolean | No | Enable Alchemy enhancement | true | - |
leonardo_contrast_ratio | float | No | Contrast ratio for Alchemy | - | 0-1 |
leonardo_expanded_domain | boolean | No | Enable Expanded Domain feature | false | - |
leonardo_photo_real | boolean | No | Enable PhotoReal feature | false | - |
leonardo_photo_real_version | string | No | PhotoReal version (automatically set to v2 when PhotoReal is enabled) | v2 | v2 |
leonardo_photo_real_strength | float | No | PhotoReal depth of field (v1 only) | 0.55 | 0.45, 0.5, 0.55 |
Prompt Magic Parameters
| Parameter | Type | Required | Description | Default | Range |
|---|---|---|---|---|---|
leonardo_prompt_magic | boolean | No | Enable Prompt Magic | false | - |
leonardo_prompt_magic_version | string | No | Prompt Magic version | v3 | v2, v3 |
leonardo_prompt_magic_strength | float | No | Strength of Prompt Magic | - | 0.1-1.0 |
leonardo_hight_constrast | boolean | No | Enable High Contrast (controls RAW mode) | false | - |
leonardo_hight_resolution | boolean | No | Enable High Resolution | false | - |
Enhance Prompt Parameters
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
leonardo_enhance_prompt | boolean | No | Enable prompt enhancement | false |
leonardo_enhance_prompt_instruction | string | No | Instructions for prompt enhancement | - |
Supported Image Sizes
| Size | Resolution | Use Case |
|---|---|---|
| 512x512 | Standard square | Quick iterations, concepts |
| 1024x768 | Landscape | Wide compositions, scenes |
| 768x1024 | Portrait | Vertical compositions, characters |
| 1024x1024 | High-res square | High-quality artistic work |
Diffusion XL Features
| Feature | Description |
|---|---|
| Advanced Diffusion Algorithms | Sophisticated mathematical models for superior image generation |
| Exceptional Detail Reproduction | Fine detail preservation and enhancement capabilities |
| Artistic Versatility | Wide range of artistic styles and creative applications |
| Alchemy Enhancement | Advanced AI processing for professional-grade output |
| Prompt Magic | AI-powered prompt expansion and optimization |
| PhotoReal Technology | Photorealistic image generation capabilities |
| High Resolution | Enhanced detail and clarity for professional work |
| Creative Control | Comprehensive parameters for artistic direction |
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": "1e60896f-3c26-4296-8ecc-53e2afecc132",
"promptObject": {
"prompt": "digital art masterpiece, fantasy landscape with floating islands, ethereal lighting, detailed environment",
"negativePrompt": "low quality, blurry, amateur, simple, plain",
"size": "1024x1024",
"n": 1,
"leonardo_alchemy": true,
"leonardo_guidance_scale": 9,
"leonardo_num_inference_steps": 30,
"leonardo_prompt_magic": true,
"leonardo_prompt_magic_version": "v3",
"leonardo_hight_resolution": true
}
}'
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: '1e60896f-3c26-4296-8ecc-53e2afecc132',
promptObject: {
prompt: 'digital art masterpiece, fantasy landscape with floating islands, ethereal lighting, detailed environment',
negativePrompt: 'low quality, blurry, amateur, simple, plain',
size: '1024x1024',
n: 1,
leonardo_alchemy: true,
leonardo_guidance_scale: 9,
leonardo_num_inference_steps: 30,
leonardo_prompt_magic: true,
leonardo_prompt_magic_version: 'v3',
leonardo_hight_resolution: true
}
})
})
import requests
url = "https://api.1min.ai/api/features"
headers = {
"Content-Type": "application/json",
"API-KEY": "YOUR_API_KEY"
}
data = {
"type": "IMAGE_GENERATOR",
"model": "1e60896f-3c26-4296-8ecc-53e2afecc132",
"promptObject": {
"prompt": "digital art masterpiece, fantasy landscape with floating islands, ethereal lighting, detailed environment",
"negativePrompt": "low quality, blurry, amateur, simple, plain",
"size": "1024x1024",
"n": 1,
"leonardo_alchemy": True,
"leonardo_guidance_scale": 9,
"leonardo_num_inference_steps": 30,
"leonardo_prompt_magic": True,
"leonardo_prompt_magic_version": "v3",
"leonardo_hight_resolution": True
}
}
response = requests.post(url, headers=headers, json=data)
Interactive Playground
API Playground
https://api.1min.ai/api/featuresGenerated 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": "1e60896f-3c26-4296-8ecc-53e2afecc132",
"promptObject": {
"prompt": "digital art masterpiece, fantasy landscape with floating islands, ethereal lighting, detailed environment",
"negativePrompt": "low quality, blurry, amateur, simple, plain",
"size": "1024x1024",
"n": 1,
"leonardo_alchemy": true,
"leonardo_guidance_scale": 9,
"leonardo_num_inference_steps": 30
}
}'
Response Format
{
"aiRecord": {
"uuid": "e4f5g6h7-i8j9-0123-4567-890123defghi",
"userId": "user-12345",
"teamId": "team-67890",
"model": "1e60896f-3c26-4296-8ecc-53e2afecc132",
"type": "IMAGE_GENERATOR",
"status": "SUCCESS",
"createdAt": "2025-01-15T10:50:00.000Z",
"aiRecordDetail": {
"promptObject": {
"prompt": "digital art masterpiece, fantasy landscape with floating islands, ethereal lighting, detailed environment",
"negativePrompt": "low quality, blurry, amateur, simple, plain",
"size": "1024x1024",
"n": 1,
"leonardo_alchemy": true,
"leonardo_guidance_scale": 9,
"leonardo_num_inference_steps": 30,
"leonardo_prompt_magic": true,
"leonardo_prompt_magic_version": "v3",
"leonardo_hight_resolution": true
},
"resultObject": [
"development/images/2025_01_15_10_50_45_001_diffusion_art.webp"
]
},
"temporaryUrl": "https://s3.us-east-1.amazonaws.com/asset.1min.ai/development/images/2025_01_15_10_50_45_001_diffusion_art.webp?X-Amz-Algorithm=AWS4-HMAC-SHA256&..."
}
}
Use Cases
Professional Art & Design
- Digital Art: High-quality illustrations, concept art, and digital paintings
- Commercial Design: Marketing materials, brand imagery, and promotional content
- Fine Art: Artistic expressions, abstract compositions, and creative explorations
- Print Media: High-resolution artwork for publications, posters, and displays
- Web Design: Website graphics, headers, backgrounds, and visual elements
Creative & Entertainment
- Concept Art: Game development, movie pre-production, and creative projects
- Fantasy Art: Magical landscapes, creatures, characters, and mythical scenes
- Science Fiction: Futuristic environments, technology concepts, and space scenes
- Artistic Studies: Style exploration, technique development, and creative learning
- Portfolio Work: Professional artwork for artistic portfolios and exhibitions
Technical & Professional
- Architectural Visualization: Building concepts, interior design, and spatial planning
- Product Visualization: Design concepts, prototypes, and marketing imagery
- Educational Materials: Instructional graphics, diagrams, and learning aids
- Research Visualization: Scientific concepts, data representation, and technical illustrations
- Documentation: Technical manuals, guides, and reference materials
Advanced Diffusion Techniques
Prompt Engineering for Diffusion
-
Technical Terms:
- "digital art", "oil painting", "watercolor", "photorealistic", "hyperrealistic"
- "detailed", "intricate", "masterpiece", "high resolution", "professional quality"
- "soft lighting", "dramatic lighting", "volumetric lighting", "studio lighting"
-
Artistic Styles:
- "impressionist", "surreal", "abstract", "minimalist", "baroque", "art nouveau"
- "cyberpunk", "steampunk", "fantasy art", "concept art", "matte painting"
- "renaissance style", "modern art", "contemporary", "classical"
-
Composition Elements:
- "rule of thirds", "golden ratio", "leading lines", "symmetrical", "asymmetrical"
- "foreground", "middle ground", "background", "depth of field", "perspective"
- "wide angle", "close-up", "panoramic", "bird's eye view", "low angle"
Quality Enhancement Strategies
-
Parameter Optimization:
- Guidance Scale: 8-12 for detailed artistic work, 6-8 for creative freedom
- Inference Steps: 25-40 for high quality, 15-25 for faster generation
- Alchemy: Always enable for professional work
- High Resolution: Use for final artwork and print materials
-
Creative Control:
- Seed Consistency: Maintain style across series with fixed seeds
- Iterative Refinement: Use successful generations as base for improvements
- Style Transfer: Combine reference images with text prompts
- Batch Variations: Generate multiple versions for selection
Advanced Workflows
-
Professional Pipeline:
- Concept → Rough Generation → Refinement → Final Enhancement
- Use lower settings for concepts, high settings for finals
- Implement feedback loops and iterative improvements
-
Artistic Exploration:
- Style Studies: Explore different artistic movements and techniques
- Technique Mixing: Combine multiple artistic approaches
- Creative Experimentation: Push boundaries with unusual combinations
-
Commercial Production:
- Brief Analysis → Style Reference → Multiple Variations → Client Selection
- Maintain brand consistency across campaign materials
- Optimize for different media and applications
Diffusion-Specific Best Practices
Mathematical Precision
-
Diffusion Algorithm Understanding:
- Higher inference steps = more refinement iterations
- Guidance scale controls prompt adherence vs creative freedom
- Noise scheduling affects detail development
-
Quality vs Speed Balance:
- Production work: 30-50 steps, guidance 8-12
- Concept work: 15-25 steps, guidance 6-9
- Experimental: Variable settings for exploration
Artistic Direction
-
Style Consistency:
- Develop signature prompt templates
- Use consistent terminology across projects
- Maintain lighting and mood consistency
-
Detail Enhancement:
- Layer descriptions from general to specific
- Include texture and material descriptions
- Specify lighting conditions and atmosphere
Professional Standards
-
Output Quality:
- Always use Alchemy for client work
- Enable High Resolution for print materials
- Consider transparency options for design work
-
Workflow Efficiency:
- Create prompt libraries for common styles
- Establish quality checkpoints in production
- Implement version control for iterations
Credit Usage
Leonardo Diffusion XL generation costs by image size and quantity:
| Size | 1 Image | 2 Images | 3 Images | 4 Images |
|---|---|---|---|---|
| 512x512 | 234 credits | 234 credits | 260 credits | 286 credits |
| 1024x768 | 260 credits | 312 credits | 364 credits | 416 credits |
| 768x1024 | 260 credits | 312 credits | 364 credits | 416 credits |
| 1024x1024 | 286 credits | 338 credits | 416 credits | 468 credits |
Diffusion XL works best with higher inference steps and quality settings. Consider the cost-benefit ratio of enhanced settings for professional applications.
Notes
Leonardo Diffusion XL uses advanced mathematical diffusion processes that excel at creating detailed, professional-quality artwork with sophisticated artistic elements.
This model is specifically designed for professional artistic applications where quality, detail, and creative control are paramount considerations.
Diffusion algorithms can be computationally intensive. Higher inference steps and quality settings will increase generation time but produce superior results.
Authentication
This endpoint requires an API key to be provided in the API-KEY header.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
prompt | string | Yes | Text description of the image to generate | - |
negativePrompt | string | Yes | Elements to exclude from the generated image | - |
size | string | Yes | Generated image dimensions | 1024x1024 |
n | number | Yes | Number of images to generate (1-4) | 1 |
Supported Image Sizes
| Size | Resolution | Use Case |
|---|---|---|
| 1024x1024 | 1 megapixel | High-quality artistic images |
Diffusion XL Features
| Feature | Description |
|---|---|
| Advanced Diffusion | Sophisticated noise-to-image generation process |
| Artistic Excellence | Superior creative and artistic output quality |
| Detail Precision | Exceptional fine detail reproduction |
| Style Versatility | Wide range of artistic and photographic styles |
| Professional Quality | Commercial-grade artistic imagery |
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": "1e60896f-3c26-4296-8ecc-53e2afecc132",
"promptObject": {
"prompt": "Artistic landscape painting with dramatic lighting and rich textures",
"negativePrompt": "blurry, low quality, distorted, oversaturated",
"size": "1024x1024",
"n": 1
}
}'
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: '1e60896f-3c26-4296-8ecc-53e2afecc132',
promptObject: {
prompt: 'Artistic landscape painting with dramatic lighting and rich textures',
negativePrompt: 'blurry, low quality, distorted, oversaturated',
size: '1024x1024',
n: 1
}
})
})
import requests
url = "https://api.1min.ai/api/features"
headers = {
"Content-Type": "application/json",
"API-KEY": "YOUR_API_KEY"
}
data = {
"type": "IMAGE_GENERATOR",
"model": "1e60896f-3c26-4296-8ecc-53e2afecc132",
"promptObject": {
"prompt": "Artistic landscape painting with dramatic lighting and rich textures",
"negativePrompt": "blurry, low quality, distorted, oversaturated",
"size": "1024x1024",
"n": 1
}
}
response = requests.post(url, headers=headers, json=data)
Interactive Playground
API Playground
https://api.1min.ai/api/featuresGenerated 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": "1e60896f-3c26-4296-8ecc-53e2afecc132",
"promptObject": {
"prompt": "Artistic landscape painting with dramatic lighting and rich textures",
"negativePrompt": "blurry, low quality, distorted, oversaturated",
"size": "1024x1024",
"n": 1
}
}'
Response Format
{
"aiRecord": {
"uuid": "e4f5g6h7-i8j9-0123-4567-890123defghi",
"userId": "user-12345",
"teamId": "team-67890",
"model": "1e60896f-3c26-4296-8ecc-53e2afecc132",
"type": "IMAGE_GENERATOR",
"status": "SUCCESS",
"createdAt": "2025-01-15T10:50:00.000Z",
"aiRecordDetail": {
"promptObject": {
"prompt": "Artistic landscape painting with dramatic lighting and rich textures",
"negativePrompt": "blurry, low quality, distorted, oversaturated",
"size": "1024x1024",
"n": 1
},
"resultObject": [
"development/images/2025_01_15_10_50_45_001_artistic_landscape.webp"
]
},
"temporaryUrl": "https://s3.us-east-1.amazonaws.com/asset.1min.ai/development/images/2025_01_15_10_50_45_001_artistic_landscape.webp?X-Amz-Algorithm=AWS4-HMAC-SHA256&..."
}
}
Use Cases
- Fine Art Creation: High-quality artistic imagery and paintings
- Digital Art: Professional digital artwork and illustrations
- Creative Design: Artistic concepts and visual development
- Gallery Exhibitions: Museum-quality digital art pieces
- Commercial Art: Professional artistic content for brands
Tips for Best Results
-
Artistic Prompting:
- Include art movement references: "impressionist style", "abstract expressionism"
- Specify techniques: "oil painting", "watercolor", "digital art"
- Mention famous artists for style reference
-
Quality Enhancement:
- Use negative prompts to exclude unwanted artifacts
- Specify lighting and composition details
- Include texture and material descriptions
-
Creative Exploration:
- Experiment with artistic styles and movements
- Combine multiple artistic techniques
- Use detailed descriptive language for complex scenes
Notes
Leonardo Diffusion XL uses advanced diffusion algorithms to create highly detailed, artistic images with exceptional quality and creative versatility.
Authentication
This endpoint requires an API key to be provided in the API-KEY header.