Style Profiles Schema | JSON Structure for AI Art Styles

Schema Overview

Style profiles use a structured JSON format that defines how AI image generation models should interpret and apply various visual parameters. This schema ensures consistency across different platforms and makes it easy to share and reproduce specific visual styles.

The schema is designed to be platform-agnostic while providing detailed control over every aspect of image generation, from color palettes to camera angles.

Programmatic Access: The JSON Schema is also available for validation and tooling at:

https://styleprofiles.com/schema/v1.json

Required Fields

Core Sections

All major configuration sections that define the visual style.

color, lighting, camera

composition, texture

atmosphere, mood, rendering

Complete Schema Structure

{
  "meta": {
    "name": "string",           // Required: Profile name
    "description": "string"     // Optional: Profile description
  },
  "color": {
    "palette": ["#hex", ...],   // Array of hex color codes
    "hue": "string",           // Primary hue description
    "saturation": "string",    // Saturation level
    "contrast": "string",      // Contrast description
    "brightness": "string"     // Brightness level
  },
  "lighting": {
    "direction": "string",     // Light direction
    "intensity": "string",     // Light intensity
    "temperature": number,     // Color temperature in Kelvin
    "volumetric": boolean,     // Volumetric lighting
    "shadowStyle": "string",   // Shadow characteristics
    "highlightStyle": "string" // Highlight characteristics
  },
  "camera": {
    "perspective": "string",   // Camera perspective
    "angle": "string",        // Camera angle
    "zoom": "string",         // Zoom level
    "depthOfField": "string"  // DOF description
  },
  "composition": {
    "framing": "string",      // Framing style
    "focus": "string",        // Focus description
    "perspective": "string",   // Composition perspective
    "depth": number,          // Depth value (0-10)
    "negativeSpaceRatio": number, // Ratio (0-1)
    "motionFlow": "string"    // Motion description
  },
  "texture": {
    "surfaceStyle": "string", // Surface descriptions
    "detailLevel": "string",  // Detail level
    "brushStyle": "string",   // Brush/stroke style
    "grain": "string",        // Grain description
    "lineQuality": "string"   // Line quality
  },
  "atmosphere": {
    "fog": "string",          // Fog/haze description
    "grain": "string",        // Atmospheric grain
    "vignette": "string",     // Vignette style
    "ambientMotion": "string" // Ambient motion
  },
  "mood": {
    "emotionalTone": "string", // Emotional description
    "realismLevel": "string"   // Realism level
  },
  "rendering": {
    "medium": "string",       // Rendering medium
    "outputSize": "string",   // Output dimensions
    "format": "string",       // File format
    "animated": boolean       // Animation flag
  }
}

Field Descriptions

Color

palette: Array of hex color codes that define the primary colors

hue: Primary color family (e.g., "warm golden yellows")

saturation: Color intensity (e.g., "rich and vibrant")

contrast: Contrast level (e.g., "high contrast with deep shadows")

Lighting

direction: Light source direction (e.g., "soft side lighting")

intensity: Light strength (e.g., "gentle and diffused")

temperature: Color temperature in Kelvin (2000-10000)

volumetric: Whether light has visible volume/rays

Camera

perspective: Camera viewpoint (e.g., "intimate and close")

angle: Camera angle (e.g., "eye level", "low angle")

zoom: Zoom level (e.g., "medium with breathing room")

depthOfField: Focus characteristics (e.g., "shallow with bokeh")

Composition

framing: How subjects are framed (e.g., "rule of thirds")

focus: What draws attention (e.g., "emotional connection")

depth: Aperture-like value (1.4-22)

negativeSpaceRatio: Empty space ratio (0-1)

Example Values

Good Examples

hue: "warm golden yellows and amber"

lighting.direction: "soft side and back lighting"

texture.surfaceStyle: "obsidian, carbon fiber, soft ash"

mood.emotionalTone: "sacred, mysterious, and weighty"

Tips

• Be descriptive but concise in your strings
• Use specific material names for textures
• Include emotional descriptors in mood
• Test temperature values between 2000-8000K
• Keep depth values realistic (1.4-11)

Validation Rules

Before Submitting

✅ Ensure meta.name is present and descriptive
✅ All required sections are included (even if minimal)
✅ Numeric values are within reasonable ranges
✅ Boolean values are true/false (not strings)
✅ Color palette uses valid hex codes
✅ JSON syntax is valid (use a validator)