Skip to main content

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

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

Parameters

ParameterTypeRequiredDescription
typestringYesFeature type identifier. Must be IMAGE_GENERATOR
modelstringYesAI model identifier. Must be 1e60896f-3c26-4296-8ecc-53e2afecc132
promptObjectobjectYesConfiguration object containing all generation parameters

Prompt Object Parameters

Basic Parameters

ParameterTypeRequiredDescriptionDefault
promptstringYesText description of the image to generate-
sizestringYesGenerated image dimensions1024x1024
nnumberYesNumber of images to generate (1-4)1
negativePromptstringNoDescribe what you don't want in the image-

Leonardo Common Parameters

ParameterTypeRequiredDescriptionDefaultRange
leonardo_guidance_scaleintegerNoHow strongly generation reflects the prompt71-20
leonardo_num_inference_stepsintegerNoNumber of inference steps for generation1510-60
leonardo_seedintegerNoFixed seed for consistency across generations-0-9999999998
leonardo_tillingbooleanNoWhether images should tile on all axesfalse-
leonardo_transparencystringNoType of transparency to use-disabled, foreground_only
leonardo_preset_stylestringNoStyle preset for generation-Dynamic based on Alchemy settings

Image Guidance Parameters

ParameterTypeRequiredDescriptionDefaultRange
leonardo_image_promptsarrayNoUpload images to use as image prompts-Max 4 images
leonardo_init_image_idstringNoInit image ID to influence generation features-Required for Fantasy Avatar
leonardo_init_strengthfloatNoHow strongly generated images reflect init image-0.1-0.9
leonardo_fantasy_avatarbooleanNoEnable Fantasy Avatar feature (requires Init Image ID when enabled)false-

Alchemy Parameters

ParameterTypeRequiredDescriptionDefaultRange
leonardo_alchemybooleanNoEnable Alchemy enhancementtrue-
leonardo_contrast_ratiofloatNoContrast ratio for Alchemy-0-1
leonardo_expanded_domainbooleanNoEnable Expanded Domain featurefalse-
leonardo_photo_realbooleanNoEnable PhotoReal featurefalse-
leonardo_photo_real_versionstringNoPhotoReal version (automatically set to v2 when PhotoReal is enabled)v2v2
leonardo_photo_real_strengthfloatNoPhotoReal depth of field (v1 only)0.550.45, 0.5, 0.55

Prompt Magic Parameters

ParameterTypeRequiredDescriptionDefaultRange
leonardo_prompt_magicbooleanNoEnable Prompt Magicfalse-
leonardo_prompt_magic_versionstringNoPrompt Magic versionv3v2, v3
leonardo_prompt_magic_strengthfloatNoStrength of Prompt Magic-0.1-1.0
leonardo_hight_constrastbooleanNoEnable High Contrast (controls RAW mode)false-
leonardo_hight_resolutionbooleanNoEnable High Resolutionfalse-

Enhance Prompt Parameters

ParameterTypeRequiredDescriptionDefault
leonardo_enhance_promptbooleanNoEnable prompt enhancementfalse
leonardo_enhance_prompt_instructionstringNoInstructions for prompt enhancement-

Supported Image Sizes

SizeResolutionUse Case
512x512Standard squareQuick iterations, concepts
1024x768LandscapeWide compositions, scenes
768x1024PortraitVertical compositions, characters
1024x1024High-res squareHigh-quality artistic work

Diffusion XL Features

FeatureDescription
Advanced Diffusion AlgorithmsSophisticated mathematical models for superior image generation
Exceptional Detail ReproductionFine detail preservation and enhancement capabilities
Artistic VersatilityWide range of artistic styles and creative applications
Alchemy EnhancementAdvanced AI processing for professional-grade output
Prompt MagicAI-powered prompt expansion and optimization
PhotoReal TechnologyPhotorealistic image generation capabilities
High ResolutionEnhanced detail and clarity for professional work
Creative ControlComprehensive parameters for artistic direction

Code Examples

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
}
}'

Interactive Playground

API Playground

https://api.1min.ai/api/features
Describe the image you want to generate
Describe what you don't want in the image
Generated image dimensions
Number of images to generate (1-4)
How strongly generation reflects the prompt (1-20)
Number of inference steps (10-60)
Fixed seed for consistency (0-9999999998)
Enable tiling on all axes
Type of transparency to use
Enable Alchemy enhancement
Alchemy contrast ratio (0-1)
Enable Expanded Domain feature
Enable PhotoReal feature
How strongly generated images reflect init image (0.1-0.9)
Enable Fantasy Avatar feature (requires Init Image ID when enabled)
Enable Prompt Magic
Prompt Magic version (v2 or v3)
Strength of Prompt Magic (0.1-1.0)
Enable High Contrast (controls RAW mode)
Enable High Resolution
Enable prompt enhancement
Instructions for prompt enhancement

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": "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

  1. Technical Terms:

    • "digital art", "oil painting", "watercolor", "photorealistic", "hyperrealistic"
    • "detailed", "intricate", "masterpiece", "high resolution", "professional quality"
    • "soft lighting", "dramatic lighting", "volumetric lighting", "studio lighting"
  2. Artistic Styles:

    • "impressionist", "surreal", "abstract", "minimalist", "baroque", "art nouveau"
    • "cyberpunk", "steampunk", "fantasy art", "concept art", "matte painting"
    • "renaissance style", "modern art", "contemporary", "classical"
  3. 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

  1. 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
  2. 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

  1. Professional Pipeline:

    • Concept → Rough Generation → Refinement → Final Enhancement
    • Use lower settings for concepts, high settings for finals
    • Implement feedback loops and iterative improvements
  2. Artistic Exploration:

    • Style Studies: Explore different artistic movements and techniques
    • Technique Mixing: Combine multiple artistic approaches
    • Creative Experimentation: Push boundaries with unusual combinations
  3. 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

  1. Diffusion Algorithm Understanding:

    • Higher inference steps = more refinement iterations
    • Guidance scale controls prompt adherence vs creative freedom
    • Noise scheduling affects detail development
  2. 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

  1. Style Consistency:

    • Develop signature prompt templates
    • Use consistent terminology across projects
    • Maintain lighting and mood consistency
  2. Detail Enhancement:

    • Layer descriptions from general to specific
    • Include texture and material descriptions
    • Specify lighting conditions and atmosphere

Professional Standards

  1. Output Quality:

    • Always use Alchemy for client work
    • Enable High Resolution for print materials
    • Consider transparency options for design work
  2. 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:

Size1 Image2 Images3 Images4 Images
512x512234 credits234 credits260 credits286 credits
1024x768260 credits312 credits364 credits416 credits
768x1024260 credits312 credits364 credits416 credits
1024x1024286 credits338 credits416 credits468 credits
Diffusion Quality Investment

Diffusion XL works best with higher inference steps and quality settings. Consider the cost-benefit ratio of enhanced settings for professional applications.

Notes

Diffusion Algorithm Advantage

Leonardo Diffusion XL uses advanced mathematical diffusion processes that excel at creating detailed, professional-quality artwork with sophisticated artistic elements.

Professional Applications

This model is specifically designed for professional artistic applications where quality, detail, and creative control are paramount considerations.

Computational Intensity

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.

ParameterTypeRequiredDescriptionDefault
promptstringYesText description of the image to generate-
negativePromptstringYesElements to exclude from the generated image-
sizestringYesGenerated image dimensions1024x1024
nnumberYesNumber of images to generate (1-4)1

Supported Image Sizes

SizeResolutionUse Case
1024x10241 megapixelHigh-quality artistic images

Diffusion XL Features

FeatureDescription
Advanced DiffusionSophisticated noise-to-image generation process
Artistic ExcellenceSuperior creative and artistic output quality
Detail PrecisionExceptional fine detail reproduction
Style VersatilityWide range of artistic and photographic styles
Professional QualityCommercial-grade artistic imagery

Code Examples

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
}
}'

Interactive Playground

API Playground

https://api.1min.ai/api/features
Describe the image you want to generate
Elements to exclude from the generated image
Generated image dimensions
Number of images to generate (1-4)

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": "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

  1. Artistic Prompting:

    • Include art movement references: "impressionist style", "abstract expressionism"
    • Specify techniques: "oil painting", "watercolor", "digital art"
    • Mention famous artists for style reference
  2. Quality Enhancement:

    • Use negative prompts to exclude unwanted artifacts
    • Specify lighting and composition details
    • Include texture and material descriptions
  3. Creative Exploration:

    • Experiment with artistic styles and movements
    • Combine multiple artistic techniques
    • Use detailed descriptive language for complex scenes

Notes

Diffusion Excellence

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.