Webtoon Generator - AI-Powered Korean Webtoon Creation

A Minimax API-based automated webtoon generation system that transforms web novels into professional webtoon content.

🎬 Project Overview

Webtoon Title: The Superstition of the Funeral Home (장례식장의 미신)
Episode: 1
Genre: Horror, Thriller, Emotional, Humanism
Total Panels: 145 cuts
AI Model: Minimax image-01

📁 Project Structure

webtoon-generator/
├── _workspace/              # All generated content
│   ├── 01_research/         # Concept and research phase
│   │   └── concept.json     # Webtoon concept document
│   ├── 02_story/            # Script and storyboard
│   │   ├── beatsheet.json   # 145-panel story breakdown
│   │   └── script.md        # Full dialogue and narration script
│   ├── 03_visual/           # Visual production
│   │   └── panels/          # 145 AI-generated panel images
│   └── 04_output/           # Final output
│       └── index.html       # Complete webtoon HTML
├── skills/                  # Methodology documents (6 files)
│   ├── ORCHESTRATOR.md      # Workflow orchestration
│   ├── RESEARCH.md          # Trend research methodology
│   ├── SCENARIO.md          # Script writing methodology
│   ├── PANEL_BREAKDOWN.md   # Panel breakdown methodology
│   ├── VISUAL_RENDER.md      # Image generation methodology
│   └── ASSEMBLY.md          # Final assembly methodology
├── src/                     # Source code
│   ├── minimax_api.py       # Minimax API client
│   ├── orchestrator.py      # Main orchestrator
│   ├── agents/              # AI agents
│   │   ├── research_agent.py
│   │   ├── scenario_agent.py
│   │   ├── visual_agent.py
│   │   └── assembly_agent.py
│   └── utils/
│       ├── image_generator.py
│       └── html_assembler.py
├── config/
│   └── default_config.yaml
├── generate_real_images.py   # Image generation script
├── generate_fast.py         # Optimized generation script
├── main.py                   # CLI entry point
├── requirements.txt           # Python dependencies
└── README.md               # This file

🔄 Workflow

The project follows a 6-stage automated pipeline:

Stage 1: Research (01_research)

• Trend analysis in Korean webtoon market
• Concept establishment
• Target audience analysis
• World-building and setting development

Stage 2: Scenario (02_story)

• Episode outline creation
• Beatsheet writing (145 panels)
• Dialogue and narration writing
• Scene breakdown and pacing

Stage 3: Visual Production (03_visual)

• Reference sheet generation
• Panel image generation with AI
• Quality validation
• Regeneration loop for failed panels

Stage 4: Assembly (04_output)

• HTML assembly
• Vertical scroll layout
• Atmosphere effects (fog, rain, dark overlays)
• Final quality check

🛠️ Installation & Setup

# Navigate to project directory
cd webtoon-generator

# Install dependencies
pip3 install requests pillow pyyaml

# Set API key (optional - already configured in config/)
export MINIMAX_API_KEY="your_api_key_here"
export MINIMAX_GROUP_ID="your_group_id_here"

🚀 Usage

Generate All Panel Images

python3 generate_real_images.py

Generate with Resume (Skip Existing)

This optimized script automatically skips panels that have already been generated:

python3 generate_fast.py

View the Webtoon

Recommended: Open the Portfolio Viewer

Simply open webtoon_viewer.html in your browser:

# macOS
open webtoon_viewer.html

# Or use the absolute path:
open /Users/kimminje/project/webtoon-generator/webtoon_viewer.html

Full Webtoon (145 panels)

For the complete 145-panel episode:

# Option 1: Direct open
open _workspace/04_output/index.html

# Option 2: Local server (recommended for best performance)
cd _workspace/04_output
python3 -m http.server 8080
# Then visit: http://localhost:8080

Note: The portfolio viewer (webtoon_viewer.html) provides the best viewing experience with project metadata, scene breakdown, and atmospheric effects. The full webtoon is available in _workspace/04_output/index.html.

📖 Webtoon Content

Episode 1: The Superstition of the Funeral Home

Synopsis

A 10-year veteran office worker in Pangyo receives news that his close friend's father has passed away. Despite knowing his pregnant wife would disapprove, he decides to attend the funeral. On the way home, he follows traditional Korean superstitions - scattering salt, visiting a public restroom, and walking around a supermarket. That night, strange events begin to occur...

Key Scenes

Cut	Scene	Description
1-17	Opening	Introduction to superstition and ghosts
18-30	Background	10-year work life, friendships
31-41	Conflict	Should he go to the funeral?
42-53	Journey	Driving to funeral in the rain
54-69	Horror	2:17 AM, door handle moving
70-80	Twist	CCTV footage reveals a faceless woman
81-145	Resolution	The meaning of superstition, Mahura plate story

Narrative Themes

• Superstition vs. Rationality
• Fear of the Unknown
• Family Protection Instinct
• Korean Funeral Traditions
• Ghost and Grudge Mythology

📚 Methodology

This project follows a multi-agent workflow inspired by the webtoon-harness methodology:

Multi-Agent Architecture

• Research Agent: Analyzes trends and establishes concepts
• Scenario Agent: Creates beatsheets and scripts
• Visual Agent: Generates panel images using AI
• Assembly Agent: Assembles final HTML output

Key Design Principles

1. Reference Sheet First: Generate character/location reference images before panel production
2. In-Image Text: All text (dialogue, narration) is rendered within images
3. Validation Loop: Check each panel for quality, regenerate if needed
4. Consistent Style: Maintain visual consistency across all 145 panels

Horror Webtoon Guidelines

• Dark color palette (black, dark blue, gray)
• Atmosphere effects (fog, rain, shadows)
• Sound effect overlays (철컥, 빵빵)
• Tension-building through pacing

🎨 Visual Style Guide

Color Palette

Purpose	Color	Hex
Background	Black	#0a0a0f
Horror Accent	Dark Red	#8b0000
Funeral Gray	Gray	#4a4a4a
Night Blue	Deep Blue	#1a1f3a
Text	Warm Beige	#d4c4a8

Aspect Ratio

• Panel: 9:16 (540x960 pixels)
• Optimized for mobile vertical scroll

Art Style

• Korean webtoon aesthetic
• Realistic shading with comic style
• Horror atmosphere through lighting
• Cultural authenticity in settings

🔧 API Configuration

Minimax API

API_URL = "https://api.minimax.io/v1/image_generation"
MODEL = "image-01"
RESPONSE_FORMAT = "base64"
ASPECT_RATIO = "9:16"

Config File (config/default_config.yaml)

# Minimax API
minimax_api_key: ""  # Your API key
minimax_base_url: "https://api.minimax.chat/v1"
minimax_group_id: ""  # Your Group ID

# Image Settings
image:
  default_width: 1280
  default_height: 1706
  default_style: "webtoon"
  max_concurrent: 3
  aspect_ratio: "9:16"

# Output Settings
output:
  format: "html"
  generate_thumbnails: true
  output_dir: "_workspace/04_output"

📊 Project Statistics

Metric	Value
Total Panels	145
Total Cuts	145
File Size (Images)	~32 MB
HTML Size	~250 KB
Estimated Reading Time	5-7 minutes
Generation Time	~60 minutes

📝 Methodological Documents

Detailed methodology documents are available in the skills/ directory:

• ORCHESTRATOR.md - Workflow orchestration methodology
• RESEARCH.md - Trend research methodology
• SCENARIO.md - Script writing methodology
• PANEL_BREAKDOWN.md - Panel breakdown methodology
• VISUAL_RENDER.md - Image generation methodology
• ASSEMBLY.md - Final assembly methodology

📦 Generated Output Structure

_workspace/
├── 01_research/
│   └── concept.json           # Webtoon concept and metadata
├── 02_story/
│   ├── beatsheet.json         # 145-panel story breakdown
│   └── script.md              # Full dialogue script
├── 03_visual/
│   └── panels/
│       ├── panel_001.jpg      # First panel
│       ├── panel_002.jpg      # Second panel
│       └── ...
│       └── panel_145.jpg      # Last panel
└── 04_output/
    └── index.html             # Final webtoon HTML

🎯 Features

Automated Pipeline

• End-to-end webtoon generation from concept to final HTML
• Multi-agent architecture for specialized tasks
• Quality validation at each stage

AI-Powered Visual Generation

• Minimax image-01 model for high-quality panel generation
• Consistent character and scene appearance
• Horror atmosphere effects (fog, rain, dark overlays)

Responsive Webtoon Viewer

• Mobile-optimized vertical scroll layout
• Lazy loading for images
• Atmospheric effects overlay
• Sound effect bubbles

Production-Ready

• Batch processing for efficient image generation
• Resume capability (skip already generated panels)
• Error handling and validation

🐛 Troubleshooting

Common Issues

API Key Error

Error: Invalid API key

Solution: Set your Minimax API key in config/default_config.yaml or as environment variable

Image Generation Fails

Error: Failed to generate image

Solution: Check your API quota and internet connection, then retry

Panels Not Loading

Image not found: panel_001.jpg

Solution: Run python3 generate_real_images.py to generate all panel images

Performance Tips

1. Use Resume Mode: Run python3 generate_fast.py to skip already generated panels
2. Batch Size: Adjust max_concurrent in config for your API rate limit
3. Quality Check: Review generated panels before final assembly

📋 Requirements

• Python 3.7+
• requests library
• pillow library
• pyyaml library
• Minimax API key

📄 License

This project is for educational and portfolio purposes.

🙏 Acknowledgments

• Inspired by webtoon-harness methodology
• Powered by Minimax AI image generation API
• Korean webtoon industry for creative inspiration

🔗 Related Documentation

• Minimax API Documentation
• Korean Webtoon Style Guide
• HTML Webtoon Best Practices

🌐 Portfolio Viewer

For the best viewing experience with full project information, atmospheric effects, and easy navigation:

📂 Open: webtoon_viewer.html

Open directly in your browser:

open webtoon_viewer.html

Or use the full path:

open /Users/kimminje/project/webtoon-generator/webtoon_viewer.html

This portfolio viewer includes:

• Project overview and synopsis
• Episode metadata (genre, panel count, reading time)
• Key scene breakdown
• Sample panels with atmospheric overlays
• Navigation links to the full webtoon

File Locations:

webtoon-generator/
├── webtoon_viewer.html     # ← Portfolio viewer (recommended)
└── _workspace/
    └── 04_output/
        └── index.html      # ← Full 145-panel webtoon

---

Results:

Generated with AI-powered webtoon production pipeline