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

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

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

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

Prompt *

Describe the cinematic image you want to generate

Negative Prompt

Describe what you don't want in the image

Image Size *

Generated image dimensions

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

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)

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

Endpoint​

Request Headers​

Parameters​

Prompt Object Parameters​

Basic Parameters​

Leonardo Common Parameters​

Image Guidance Parameters​

Alchemy Parameters​

Prompt Magic Parameters​

Enhance Prompt Parameters​

Supported Image Sizes​

Kino XL Features​

Code Examples​

Interactive Playground​