Echoneo: Prompt Schema Documentation (v1)
1 min read
This document details the official JSON schema (echoneo-prompt/v1) used for defining and generating the unique visual artworks within the Echoneo project. Understanding this structure is key to understanding how we translate conceptual ideas and stylistic parameters into prompts for AI collaboration.
Purpose
The Echoneo prompt schema was designed with several key goals in mind:
- Standardization: To provide a consistent structure for defining artistic intent across the entire 28x28 matrix of artworks.
- AI Interpretability: To structure information in a way that AI models can more reliably interpret distinct conceptual, stylistic, and compositional requirements.
- Semantic Clarity: To clearly separate the conceptual origin (the "what") from the stylistic execution (the "how") for each artwork.
- Creative Control: To offer detailed parameters for guiding the AI while still allowing room for emergent results.
- Modularity: To allow
conceptDefinitionandstyleDefinitionblocks to potentially be mixed and matched programmatically.
Schema Overview
The complete JSON schema defines the expected structure for each artwork prompt:
{"$schema": "[http://json-schema.org/draft-07/schema#](http://json-schema.org/draft-07/schema#)","$id": "[https://goker.art/schemas/echoneo-prompt.schema.json](https://goker.art/schemas/echoneo-prompt.schema.json)","$type": "echoneo-prompt/v1","title": "Echoneo Artwork Prompt Schema v1","description": "JSON schema for defining the prompt instructions for a single AI-generated artwork, clearly separating its core concept from its visual style and technique.","type": "object","properties": {"$schema": {"type": "string","format": "uri","description": "Link to this schema definition."},"$type": {"type": "string","const": "echoneo-artwork-prompt/v1","description": "The type and version of this prompt schema."},"artworkTitle": {"type": "string","description": "The intended title for this specific artwork."},"conceptDefinition": {"type": "object","description": "PART 1: Defines WHAT the artwork is about - its core ideas, subjects, narrative, and feeling.","properties": {"origin": {"type": "string","description": "Name or description of where the core concept idea comes from (e.g., 'Prehistoric Art', 'Myth of Icarus', 'Personal Dream')."},"coreThemes": {"type": "array","items": {"type": "string"},"minItems": 1,"description": "List the main conceptual ideas or themes (e.g., 'Loneliness', 'Nature's Power', 'Technological Anxiety', 'Celebration')."},"keySubjects": {"type": "array","items": {"type": "string"},"minItems": 1,"description": "List the main elements or figures to be depicted (e.g., 'Solitary figure', 'Stormy sea', 'Glowing circuits', 'Dancing couple')."},"narrativeFocus": {"type": "string","description": "Describe the scene, action, or story the artwork should convey."},"desiredEmotion": {"type": "string","description": "The primary emotional tone the artwork should evoke (e.g., 'Melancholy', 'Awe', 'Excitement', 'Peace')."},"symbolismHints": {"type": "array","items": {"type": "string"},"description": "(Optional) Suggest symbols or visual metaphors to include related to the concept."},"references": {"type": "array","items": {"type": "string"},"description": "Any other reference note (e.g., 'Study for Series X', 'Based on poem Y')."}},"required": ["origin","coreThemes","keySubjects","narrativeFocus","desiredEmotion"]},"styleDefinition": {"type": "object","description": "PART 2: Defines HOW the artwork should look - its visual style, techniques, medium, colors, and composition approach.","properties": {"origin": {"type": "string",// NOTE: Description corrected here vs input schema example"description": "Name or description of where the visual style inspiration comes from (e.g., 'Impressionism', 'Art Nouveau', 'Cyberpunk Game Art')."},"visualCharacteristics": {"type": "array","items": {"type": "string"},"minItems": 1,"description": "List key visual descriptors of the desired style (e.g., 'Painterly brushstrokes', 'Clean vector lines', 'Gritty realism', 'Abstract geometric shapes', 'Lush ornamentation')."},"techniques": {"type": "array","items": {"type": "string"},"minItems": 1,"description": "List specific artistic techniques to emulate (e.g., 'Impasto', 'Cross-hatching', 'Flat color blocking', 'Photobashing elements', 'Glazing')."},"mediumSimulation": {"type": "string","description": "Specify the art medium the AI should simulate (e.g., 'Oil painting', 'Watercolor sketch', 'Charcoal drawing', 'Digital illustration', 'Clay sculpture')."},"colorPalette": {"type": "object","properties": {"description": {"type": "string","description": "Describe the overall color approach (e.g., 'Warm earth tones', 'Monochromatic blue scale', 'High-contrast neon', 'Pastel and muted')."},"keyColors": {"type": "array","items": {"type": "string"},"description": "(Optional) Suggest specific dominant or accent colors."}},"required": ["description"]},"textureEmphasis": {"type": "string","description": "Describe the desired surface texture feel (e.g., 'Rough canvas texture', 'Smooth metallic sheen', 'Soft fabric feel', 'Aged paper')."},"compositionStyle": {"type": "string","description": "Describe the overall compositional approach (e.g., 'Rule of thirds', 'Symmetrical balance', 'Dynamic diagonal lines', 'Central focus', 'Minimalist')."},"references": {"type": "array","items": {"type": "string"},"description": "Any other reference note (e.g., 'Study for Series X', 'Based on poem Y')."}},"required": ["visualCharacteristics","techniques","mediumSimulation","colorPalette","textureEmphasis","compositionStyle"]},"sceneContext": {"type": "object","description": "Defines specific scene parameters like lighting and viewpoint, usually guided by the style.","properties": {"lightingStyle": {"type": "string","description": "Describe the lighting (e.g., 'Dramatic Rembrandt lighting', 'Soft, overcast day', 'Mystical backlight', 'Harsh noon sun')."},"cameraView": {"type": "string","description": "Specify the viewpoint (e.g., 'Wide angle landscape', 'Intimate close-up', 'Top-down perspective', 'Worm's-eye view')."},"settingSuggestion": {"type": "string","description": "(Optional) Briefly suggest the environment or background."}},"required": ["lightingStyle","cameraView"]},"aiDirectives": {"type": "object","description": "(Recommended) Specific fine-tuning instructions for the AI generator.","properties": {"width": {"type": "number","description": "The width of the image to generate."},"height": {"type": "number","description": "The height of the image to generate."},"aspectRatio": {"type": "string","description": "The aspect ratio of the image to generate ex: 4:3, 1:1."},"emphasize": {"type": "array","items": {"type": "string"},"description": "List elements the AI should prioritize or enhance."},"avoid": {"type": "array","items": {"type": "string"},"description": "List elements the AI should exclude or minimize."},"styleStrength": {"type": "number","minimum": 0,"maximum": 1,"description": "(Optional Hint) Suggests how strongly to adhere to the style definition (e.g., 0.8 for strong style adherence)."},"negativePromptHints": {"type": "array","items": {"type": "string"},"description": "Keywords often useful in a negative prompt (e.g., 'ugly', 'deformed', 'text', 'watermark', 'low quality')."}}}},"required": ["$schema","$type","artworkTitle","conceptDefinition","styleDefinition","sceneContext"]}###Example UsageHere's a conceptual example combining an Ancient Egyptian Concept with a Prehistoric Art Style (note: this includes the styleDefinition for illustrative purposes, even though it might be managed separately in your workflow):```json{"$schema": "[http://json-schema.org/draft-07/schema#](http://json-schema.org/draft-07/schema#)","$id": "[https://goker.art/schemas/echoneo-prompt.schema.json/instances/ancient-egyptian-prehistoric-example](https://goker.art/schemas/echoneo-prompt.schema.json/instances/ancient-egyptian-prehistoric-example)","$type": "echoneo-artwork-prompt/v1","artworkTitle": "Ancient Egyptian Art depicted in Prehistoric Art Style","conceptDefinition": {"origin": "Ancient Egyptian Art & Religion","coreThemes": ["Afterlife Ritual", "Judgment", "Balance"],"keySubjects": ["Jackal-headed figure (Anubis)", "Simple scales", "Heart shape", "Feather shape"],"narrativeFocus": "Depict a schematic jackal-headed figure near simple scales, balancing a heart shape and feather shape, rendered with bold outlines on a rock surface.","desiredEmotion": "Primal Ritual, Awe, Mystery"},"styleDefinition": {"origin": "Prehistoric Art (Upper Paleolithic cave art)","visualCharacteristics": ["Strong contour lines", "Schematic rendering of figures", "Natural rock texture background", "Overlapping figures", "Lack of ground line/perspective"],"techniques": ["Cave wall painting simulation", "Using natural earth pigments"],"mediumSimulation": "Cave wall painting simulation","colorPalette": {"description": "Limited palette: ochres and charcoal black.","keyColors": ["Red Ochre", "Yellow Ochre", "Carbon Black"]},"textureEmphasis": "Rough, natural cave wall texture.","compositionStyle": "Figures scattered or superimposed opportunistically."},"sceneContext": {"lightingStyle": "Flat, indeterminate lighting.","cameraView": "Direct, profile view.","settingSuggestion": "Rough cave wall surface."},"aiDirectives": {"aspectRatio": "1:1","emphasize": ["Strong outlines", "Primal rendering", "Cave wall texture", "Scales"],"avoid": ["Egyptian registers", "Realistic anatomy", "Smooth surfaces", "Gold color"],"styleStrength": 0.85,"negativePromptHints": ["photograph", "3D", "detailed", "fresco", "hieroglyphs"]}}
This schema provides a robust framework for the Echoneo project, enabling systematic exploration of art history through AI collaboration while maintaining conceptual and stylistic clarity for each generated piece.