gzt-storyboard-generator

KO | EN

gitlite — search

#python #hacktoberfest #react #llm #deep-learning #linux #macos #windows #awesome #kubernetes #security #pytorch #mcp #openai

gzt-storyboard-generator

(★ 1)

GZT-style gray silhouette storyboard image & video generator — KIE API (nano-banana-2 + kling-3.0)

gzt-storyboard-generator Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# GZT Storyboard Generator

A production-ready storyboard generator for creating **GZT-style gray silhouette animations** — the 3D matte broadcast aesthetic used in news and current affairs video production.

Generates vertical (9:16) and horizontal (16:9) storyboard images and videos from scene descriptions using the KIE API.

---

## What is GZT Style?

GZT style is a **stylized 3D broadcast silhouette aesthetic** used in news storytelling:

- Matte gray mannequin-like figures — featureless faces, clear body language
- Dark navy/gray moody backgrounds with dramatic rim lighting
- Clean, minimal 3D surfaces — no photorealism
- Scenario-appropriate clothing (military, diplomatic, civilian, intelligence)
- Works for political events, military scenarios, intelligence reports, diplomatic scenes

**Example output:**

| Scene Type | Description |
|-----------|-------------|
| Military alert | Command center, red alert lights, officers at radar screens |
| Intelligence leak | Two figures exchanging classified documents in a corridor |
| Missile launch | Rows of launch platforms, hundreds of trails streaking upward |
| Empty depot | Vast warehouse with bare shelves, worried soldiers |

---

## Stack

- **Next.js 15** — web interface
- **KIE Nano Banana 2** — GZT image generation (`nano-banana-2`)
- **KIE Kling 3.0** — image-to-video (`kling-3.0/video`, pro mode = 1080p)
- **Claude (Anthropic)** — prompt generation and scene writing
- **TypeScript + Tailwind CSS**

---

## Quick Start

```bash
# 1. Clone
git clone https://github.com/YOUR_USERNAME/storyboard-generator.git
cd storyboard-generator

# 2. Install
npm install

# 3. Set up environment
cp .env.example .env.local
# Fill in your API keys in .env.local

# 4. Run
npm run dev
```

Open [http://localhost:3000](http://localhost:3000).

---

## Environment Variables

```env
# .env.local
ANTHROPIC_API_KEY=your-anthropic-key
KIE_API_KEY=your-kie-key
```

Get your KIE API key at [kie.ai](https://kie.ai).

---

## GZT Prompt Formula

The core prompt pattern for GZT-style images:

```
Stylized 3D render, [SCENE DESCRIPTION],
matte gray human silhouette figures with realistic body proportions normal head size,
wearing [SCENE-APPROPRIATE CLOTHING],
featureless mannequin-like faces but clear [BODY LANGUAGE],
dramatic overhead lighting casting long shadows,
dark moody navy blue gray tone background,
clean minimal 3D broadcast style, smooth surfaces,
no text no letters no watermarks, 9:16 vertical format
```

**Clothing by scene type:**

| Scene | Clothing |
|-------|----------|
| Military | `wearing military uniform with jacket and pants` |
| Diplomatic | `wearing formal dark business suit with tie` |
| Intelligence | `wearing dark tactical clothing jacket and cargo pants` |
| Civilian | `wearing loose casual clothes long sleeve shirt and pants` |
| Middle Eastern | `wearing modest traditional clothing long garments` |

---

## API Endpoints

### Image Generation
```
POST /api/generate-image
Body: { prompt, orientation }
Response: { success, imageUrl, model }
```

### Video Generation
```
POST /api/generate-video
Body: { imageUrl, prompt, duration }
Response: { taskId }

GET /api/video-status?taskId=X
Response: { status, videoUrl }
```

### Storyboard Prompts
```
POST /api/storyboard/generate-prompts
Body: { sceneDescription, sceneIndex, orientation }
Response: { scene1, scene2 }  // 2 variations
```

---

## Video Workflow (Python CLI)

For batch production outside the web UI, use the `kling_video_generator` package:

```bash
cd kling_video_generator
pip install requests

# Set your key
export KIE_API_KEY=your-key

python -m kling_video_generator --help
```

---

## KIE API Reference

| What | Model | Notes |
|------|-------|-------|
| GZT Image | `nano-banana-2` | Use `aspect_ratio: "9:16"` (not `image_size`) |
| Video | `kling-3.0/video` | `mode: "pro"` = 1080p, `multi_shots: false` required |
| Video status | `GET /api/v1/jobs/recordInfo?taskId=X` | State: `waiting → queuing → generating → success` |
| Results | `resultJson.resultUrls[0]` | CDN URLs expire ~10-15 min — download immediately |

---

## MCP Server

Includes an MCP (Model Context Protocol) server for Claude Code integration:

```bash
cd mcp-server
npm install
node server.mjs
```

See `mcp-server/README.md` for configuration.

---

## License

MIT

gzt-storyboard-generator

gzt-storyboard-generator Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

gzt-storyboard-generator

gzt-storyboard-generator Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README