Leonardo Kino XL - Image Generator

Cinematic AI image generation model by Leonardo AI. Specialized in creating high-quality cinematic imagery with professional film aesthetics, dramatic lighting, movie-quality visual storytelling, and comprehensive creative controls including Alchemy enhancement and Prompt Magic for entertainment and commercial productions.

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 aa77f04e-3eec-4034-9c07-d0f619684628
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 cinematic 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 concepts, storyboards
1024x768	Landscape	Cinematic wide shots, environments
768x1024	Portrait	Character close-ups, vertical compositions
1024x1024	High-res square	High-quality cinematic stills

Kino XL Features

Feature	Description
Cinematic Aesthetics	Professional film-quality visual composition and styling
Dramatic Lighting	Movie-standard lighting techniques and atmospheric effects
Visual Storytelling	Narrative-focused imagery with emotional depth
Professional Film Quality	Commercial-grade cinematic output
Alchemy Enhancement	Advanced AI processing for superior cinematic quality
Prompt Magic	AI-powered prompt expansion for cinematic contexts
PhotoReal Technology	Photorealistic cinematic imagery
High Resolution	Enhanced detail for professional film applications

Code Examples

cURL

curl --location 'https://api.1min.ai/api/features' \
--header 'API-KEY: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
"type": "IMAGE_GENERATOR",
"model": "aa77f04e-3eec-4034-9c07-d0f619684628",
"promptObject": {
  "prompt": "cinematic scene, dramatic lighting, hero standing on cliff overlooking vast landscape, golden hour, film noir style, high contrast",
  "negativePrompt": "amateur, low quality, poor lighting, flat, simple",
  "size": "1024x768",
  "n": 1,
  "leonardo_alchemy": true,
  "leonardo_guidance_scale": 10,
  "leonardo_num_inference_steps": 35,
  "leonardo_prompt_magic": true,
  "leonardo_prompt_magic_version": "v3",
  "leonardo_hight_constrast": true
}
}'

JavaScript

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: 'aa77f04e-3eec-4034-9c07-d0f619684628',
  promptObject: {
    prompt: 'cinematic scene, dramatic lighting, hero standing on cliff overlooking vast landscape, golden hour, film noir style, high contrast',
    negativePrompt: 'amateur, low quality, poor lighting, flat, simple',
    size: '1024x768',
    n: 1,
    leonardo_alchemy: true,
    leonardo_guidance_scale: 10,
    leonardo_num_inference_steps: 35,
    leonardo_prompt_magic: true,
    leonardo_prompt_magic_version: 'v3',
    leonardo_hight_constrast: true
  }
})
})

Python

import requests

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

data = {
"type": "IMAGE_GENERATOR",
"model": "aa77f04e-3eec-4034-9c07-d0f619684628",
"promptObject": {
  "prompt": "cinematic scene, dramatic lighting, hero standing on cliff overlooking vast landscape, golden hour, film noir style, high contrast",
  "negativePrompt": "amateur, low quality, poor lighting, flat, simple",
  "size": "1024x768",
  "n": 1,
  "leonardo_alchemy": True,
  "leonardo_guidance_scale": 10,
  "leonardo_num_inference_steps": 35,
  "leonardo_prompt_magic": True,
  "leonardo_prompt_magic_version": "v3",
  "leonardo_hight_constrast": True
}
}

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

Interactive Playground

API Playground

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

Prompt *

Describe the cinematic image you want to generate

cinematic scene, dramatic lighting, hero standing on cliff overlooking vast landscape, golden hour, film noir style, high contrast

Negative Prompt

Describe what you don't want in the image

amateur, low quality, poor lighting, flat, simple

Image Size *

Generated image dimensions

512x512 - Square Standard1024x768 - Landscape (Cinematic)768x1024 - Portrait1024x1024 - Square HD

Number of Images *

Number of images to generate (1-4)

Guidance Scale

How strongly generation reflects the prompt (1-20)

Inference Steps

Number of inference steps (10-60)

Seed

Fixed seed for consistency (0-9999999998)

Tilling

Enable tiling on all axes

Transparency

Type of transparency to use

DisabledForeground Only

Alchemy

Enable Alchemy enhancement

Contrast Ratio

Alchemy contrast ratio (0-1)

Expanded Domain

Enable Expanded Domain feature

Photo Real

Enable PhotoReal feature

Init Strength

How strongly generated images reflect init image (0.1-0.9)

Fantasy Avatar

Enable Fantasy Avatar feature (requires Init Image ID when enabled)

Prompt Magic

Enable Prompt Magic

Prompt Magic Version

Prompt Magic version (v2 or v3)

v2v3

Prompt Magic Strength

Strength of Prompt Magic (0.1-1.0)

High Contrast

Enable High Contrast (controls RAW mode)

High Resolution

Enable High Resolution

Enhance Prompt

Enable prompt enhancement

Enhance Prompt Instruction

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": "aa77f04e-3eec-4034-9c07-d0f619684628",
  "promptObject": {
    "prompt": "cinematic scene, dramatic lighting, hero standing on cliff overlooking vast landscape, golden hour, film noir style, high contrast",
    "negativePrompt": "amateur, low quality, poor lighting, flat, simple",
    "size": "1024x768",
    "n": 1,
    "leonardo_alchemy": true,
    "leonardo_guidance_scale": 10,
    "leonardo_num_inference_steps": 35
  }
}'

Response Format

{
"aiRecord": {
  "uuid": "e4f5g6h7-i8j9-0123-4567-890123defghi",
  "userId": "user-12345",
  "teamId": "team-67890",
  "model": "aa77f04e-3eec-4034-9c07-d0f619684628",
  "type": "IMAGE_GENERATOR",
  "status": "SUCCESS",
  "createdAt": "2025-01-15T10:50:00.000Z",
  "aiRecordDetail": {
    "promptObject": {
      "prompt": "cinematic scene, dramatic lighting, hero standing on cliff overlooking vast landscape, golden hour, film noir style, high contrast",
      "negativePrompt": "amateur, low quality, poor lighting, flat, simple",
      "size": "1024x768",
      "n": 1,
      "leonardo_alchemy": true,
      "leonardo_guidance_scale": 10,
      "leonardo_num_inference_steps": 35,
      "leonardo_prompt_magic": true,
      "leonardo_prompt_magic_version": "v3",
      "leonardo_hight_constrast": true
    },
    "resultObject": [
      "development/images/2025_01_15_10_50_45_001_cinematic_scene.webp"
    ]
  },
  "temporaryUrl": "https://s3.us-east-1.amazonaws.com/asset.1min.ai/development/images/2025_01_15_10_50_45_001_cinematic_scene.webp?X-Amz-Algorithm=AWS4-HMAC-SHA256&..."
}
}

Use Cases

Film & Entertainment Industry

• Movie Concept Art: Pre-production visuals, storyboards, and scene concepts
• TV Series Development: Episode concepts, character studies, and set designs
• Documentary Visuals: Dramatic recreations and historical visualizations
• Music Videos: Cinematic shots, artistic compositions, and narrative scenes
• Short Films: Independent production visuals and creative concepts

Commercial & Advertising

• Brand Cinematography: High-end commercial visuals with film aesthetics
• Product Launches: Dramatic product reveals and showcase imagery
• Campaign Visuals: Storytelling imagery for marketing campaigns
• Corporate Videos: Professional business cinematography
• Event Promotion: Cinematic event posters and promotional materials

Creative & Artistic Projects

• Digital Cinematography: Film-style digital art and compositions
• Portfolio Work: Professional cinematic photography for portfolios
• Art Direction: Visual concepts for creative projects
• Editorial Photography: Magazine and publication cinematography
• Fine Art: Cinematic fine art photography and digital art

Gaming & Interactive Media

• Game Cinematics: Cutscene concepts and cinematic sequences
• Environmental Design: Atmospheric game environments and scenes
• Character Cinematography: Dramatic character presentations
• Trailer Assets: Game trailer visuals and promotional materials
• Interactive Narratives: Visual novel and story-driven game art

Cinematic Prompt Engineering

Lighting Techniques

1. Natural Lighting:

   • "golden hour", "blue hour", "magic hour", "sunset lighting"
   • "natural sunlight", "window light", "overcast lighting", "soft daylight"

2. Dramatic Lighting:

   • "chiaroscuro", "rim lighting", "backlighting", "silhouette"
   • "hard shadows", "dramatic contrast", "low key lighting", "high key lighting"

3. Cinematic Lighting:

   • "three-point lighting", "key light", "fill light", "hair light"
   • "practical lighting", "motivated lighting", "volumetric lighting", "god rays"

Camera Techniques

1. Shot Types:

   • "wide shot", "medium shot", "close-up", "extreme close-up"
   • "establishing shot", "over-the-shoulder", "bird's eye view", "worm's eye view"

2. Camera Angles:

   • "low angle", "high angle", "dutch angle", "eye level"
   • "dynamic angle", "cinematic composition", "rule of thirds", "leading lines"

3. Depth & Focus:

   • "shallow depth of field", "bokeh", "rack focus", "deep focus"
   • "foreground", "middle ground", "background", "layered composition"

Film Genres & Styles

1. Classic Cinema:

   • "film noir", "classic Hollywood", "golden age cinema", "black and white"
   • "vintage cinematography", "retro film style", "35mm film grain"

2. Modern Styles:

   • "blockbuster style", "indie film", "arthouse cinema", "documentary style"
   • "handheld camera", "steady cam", "drone shot", "IMAX quality"

3. Genre-Specific:

   • "sci-fi cinematography", "horror lighting", "romantic comedy style"
   • "action movie", "thriller atmosphere", "western cinematography"

Cinematic Quality Enhancement

Advanced Settings for Film Work

1. Parameter Optimization:

   • Guidance Scale: 9-15 for precise cinematic control
   • Inference Steps: 30-50 for film-quality detail
   • High Contrast: Enable for dramatic cinematic looks
   • Alchemy: Essential for professional film-quality output

2. Aspect Ratio Considerations:

   • 1024x768: Ideal for cinematic wide shots and landscapes
   • 768x1024: Perfect for character close-ups and portraits
   • 1024x1024: Balanced for versatile cinematic compositions

Professional Workflow

1. Pre-Production Pipeline:

   • Concept → Storyboard → Detailed Scene → Final Render
   • Use consistent lighting and mood across scenes
   • Develop visual language for projects

2. Quality Control:

   • Enable all enhancement features for final deliverables
   • Use seed consistency for sequence work
   • Multiple variations for director selection

Cinematic Storytelling Elements

Visual Narrative

1. Mood & Atmosphere:

   • "tense atmosphere", "peaceful mood", "ominous feeling", "hopeful tone"
   • "melancholic", "triumphant", "mysterious", "romantic"

2. Environmental Storytelling:

   • "abandoned building", "bustling city", "serene countryside", "war-torn landscape"
   • "futuristic setting", "historical period", "post-apocalyptic", "fantasy realm"

3. Character Expression:

   • "determined expression", "fearful eyes", "confident stance", "vulnerable moment"
   • "heroic pose", "villainous smirk", "emotional breakdown", "moment of realization"

Technical Film Terms

1. Color Grading:

   • "desaturated colors", "warm color palette", "cool tones", "orange and teal"
   • "high contrast", "film grain", "vintage color grading", "modern color science"

2. Production Value:

   • "high production value", "professional cinematography", "commercial quality"
   • "film festival quality", "award-winning cinematography", "masterpiece"

Advanced Cinematic Techniques

Professional Film Standards

1. Industry-Standard Quality:

   • Always enable Alchemy for commercial work
   • Use High Resolution for final deliverables
   • High Contrast for dramatic film looks
   • Higher inference steps (35-50) for professional output

2. Cinematic Composition:

   • Apply film composition rules consistently
   • Consider aspect ratios for different film formats
   • Use dramatic lighting for visual impact
   • Implement color theory for mood enhancement

Creative Direction

1. Visual Style Development:

   • Establish consistent visual language
   • Create mood boards with generated concepts
   • Develop signature lighting techniques
   • Maintain style consistency across projects

2. Narrative Integration:

   • Align visuals with story beats
   • Use lighting to support narrative mood
   • Consider character development in visuals
   • Create emotional resonance through imagery

Credit Usage

Leonardo Kino 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

Cinematic Quality Investment

For professional film work, invest in higher resolution (1024x768 or 1024x1024) and advanced features like Alchemy and High Contrast for maximum cinematic impact.

Notes

Cinematic Excellence

Leonardo Kino XL is specifically optimized for cinematic imagery. For best results, use film terminology, lighting descriptions, and camera techniques in your prompts.

Professional Film Applications

This model excels at creating film-quality visuals suitable for professional entertainment industry applications, from concept art to final promotional materials.

Cinematic Complexity

Cinematic imagery benefits from detailed prompts and higher-quality settings. Consider using more inference steps and advanced features for professional film work.

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 cinematic 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 cinematic imagery

Kino XL Features

Feature	Description
Cinematic Quality	Professional film and movie aesthetics
Dramatic Lighting	Advanced lighting and shadow techniques
Visual Storytelling	Narrative-driven image composition
Professional Grade	Industry-standard film production quality
Atmospheric Control	Rich mood and atmosphere generation

Cinematic Styles

Style	Description
Film Noir	Dark, moody with dramatic shadows
Sci-Fi Epic	Futuristic with grand scale visuals
Action Thriller	Dynamic, high-energy compositions
Drama	Emotional depth with intimate lighting
Fantasy Adventure	Magical, epic world-building scenes

Code Examples

cURL

curl --location 'https://api.1min.ai/api/features' \
--header 'API-KEY: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
"type": "IMAGE_GENERATOR",
"model": "aa77f04e-3eec-4034-9c07-d0f619684628",
"promptObject": {
  "prompt": "Cinematic scene of a hero standing on a cliff overlooking a vast city at sunset",
  "negativePrompt": "amateur, low budget, poor lighting, blurry",
  "size": "1024x1024",
  "n": 1
}
}'

JavaScript

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: 'aa77f04e-3eec-4034-9c07-d0f619684628',
  promptObject: {
    prompt: 'Cinematic scene of a hero standing on a cliff overlooking a vast city at sunset',
    negativePrompt: 'amateur, low budget, poor lighting, blurry',
    size: '1024x1024',
    n: 1
  }
})
})

Python

import requests

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

data = {
"type": "IMAGE_GENERATOR",
"model": "aa77f04e-3eec-4034-9c07-d0f619684628",
"promptObject": {
  "prompt": "Cinematic scene of a hero standing on a cliff overlooking a vast city at sunset",
  "negativePrompt": "amateur, low budget, poor lighting, blurry",
  "size": "1024x1024",
  "n": 1
}
}

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

Interactive Playground

API Playground

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

AI Model *Leonardo Kino XL

Prompt *

Describe the cinematic image you want to generate

Cinematic scene of a hero standing on a cliff overlooking a vast city at sunset

Negative Prompt *

Elements to exclude from the generated image

amateur, low budget, poor lighting, blurry

Image Size *

Generated image dimensions

1024x1024 - Square HD

Number of Images *

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": "aa77f04e-3eec-4034-9c07-d0f619684628",
  "promptObject": {
    "prompt": "Cinematic scene of a hero standing on a cliff overlooking a vast city at sunset",
    "negativePrompt": "amateur, low budget, poor lighting, blurry",
    "size": "1024x1024",
    "n": 1
  }
}'

Response Format

{
"aiRecord": {
  "uuid": "e4f5g6h7-i8j9-0123-4567-890123defghi",
  "userId": "user-12345",
  "teamId": "team-67890",
  "model": "aa77f04e-3eec-4034-9c07-d0f619684628",
  "type": "IMAGE_GENERATOR",
  "status": "SUCCESS",
  "createdAt": "2025-01-15T10:50:00.000Z",
  "aiRecordDetail": {
    "promptObject": {
      "prompt": "Cinematic scene of a hero standing on a cliff overlooking a vast city at sunset",
      "negativePrompt": "amateur, low budget, poor lighting, blurry",
      "size": "1024x1024",
      "n": 1
    },
    "resultObject": [
      "development/images/2025_01_15_10_50_45_001_cinematic_scene.webp"
    ]
  },
  "temporaryUrl": "https://s3.us-east-1.amazonaws.com/asset.1min.ai/development/images/2025_01_15_10_50_45_001_cinematic_scene.webp?X-Amz-Algorithm=AWS4-HMAC-SHA256&..."
}
}

Use Cases

• Film Production: Concept art and storyboard visualization
• Game Development: Cinematic cutscene and environment concept art
• Advertising: High-impact commercial and marketing visuals
• Entertainment: Movie poster and promotional imagery
• Digital Storytelling: Visual narrative and dramatic scenes

Cinematic Prompt Engineering

1. Camera Techniques:

   • Specify shots: "wide shot", "close-up", "bird's eye view"
   • Camera angles: "low angle", "dutch angle", "overhead shot"
   • Movements: "tracking shot", "dolly zoom", "crane shot"

2. Lighting Design:

   • Dramatic: "dramatic lighting", "chiaroscuro", "rim lighting"
   • Atmospheric: "golden hour", "blue hour", "neon lighting"
   • Professional: "three-point lighting", "key light", "fill light"

3. Cinematic Mood:

   • Genre-specific: "film noir atmosphere", "sci-fi epic", "thriller tension"
   • Emotional: "melancholic", "triumphant", "mysterious"
   • Visual style: "anamorphic lens", "35mm film grain", "IMAX quality"

Tips for Best Results

1. Professional Terminology:

   • Use film industry language and technical terms
   • Reference famous directors or cinematographers
   • Specify camera equipment and lens types

2. Visual Storytelling:

   • Focus on narrative elements and character emotions
   • Include environmental storytelling details
   • Describe the dramatic tension and mood

3. Technical Excellence:

   • Specify resolution and aspect ratios
   • Include post-production effects terminology
   • Mention color grading and visual treatment

Notes

Cinematic Excellence

Leonardo Kino XL is specifically designed for creating film-quality imagery with professional cinematography aesthetics, making it ideal for entertainment industry applications.

Authentication

This endpoint requires an API key to be provided in the API-KEY header.