Back to Details

deck-generator

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Deck Generator

Deck Generator

Generate complete presentations where every slide is an AI-generated image in a consistent visual style.
生成完整的演示文稿，每张幻灯片都是风格统一的AI生成图像。

Quick Start

快速开始

  1. Read the content spec (user provides slide content or a markdown file)
  2. Read 
    references/styles.md
    to pick or customize a visual style
  3. Run 
    scripts/generate-deck.py
    with content + style
  1. 读取内容规范（用户提供幻灯片内容或Markdown文件）
  2. 读取
    references/styles.md
    选择或自定义视觉风格
  3. 结合内容和风格参数运行
    scripts/generate-deck.py

Workflow

工作流程

Step 1: Content Spec

步骤1：内容规范

Accept slide content in any format. Normalize to this structure per slide:
  • Title: Bold headline
  • Body: Key points, stats, or narrative
  • Visual cues: Icons, diagrams, layouts described in words
If user provides a markdown file with 
---
separators, parse each section as a slide. If user provides a topic only, generate 10-14 slides following standard deck structures.
支持任意格式的幻灯片内容输入，会将每页幻灯片标准化为以下结构：
  • 标题：加粗的大标题
  • 正文：核心要点、数据或叙述内容
  • 视觉提示：用文字描述的图标、图表、布局要求
如果用户提供了用
---
分隔的Markdown文件，会将每个分段解析为一页幻灯片。 如果用户仅提供了主题，会按照标准演示文稿结构生成10-14页幻灯片。

Step 2: Style Selection

步骤2：风格选择

Available style presets:
StyleDescription
whiteboard
Hand-drawn sketch on white. Black ink, orange accents.
corporate
Navy/white/gold. Clean sans-serif. Professional.
minimalist
Pure white, electric blue accent. Maximum negative space.
dark-tech
Near-black background, neon green. Terminal aesthetic.
playful
Bright pastels, rounded shapes. Modern startup vibe.
editorial
Black/white with red spot color. Magazine aesthetic.
Default: 
whiteboard
. User can specify any preset or describe a custom style.
可用的样式预设如下：
样式描述
whiteboard
白色背景上手绘草图风格，黑色线条，橙色点缀
corporate
海军蓝/白/金配色，干净的无衬线字体，专业风格
minimalist
纯白色背景，电光蓝点缀，最大化留白
dark-tech
近黑色背景，霓虹绿配色，终端美学风格
playful
明亮马卡龙色，圆角造型，现代初创企业风格
editorial
黑白配色加红色点缀，杂志美学风格
默认样式：
whiteboard
。用户可以指定任意预设，也可以描述自定义风格。

Step 3: Generate

步骤3：生成

bash
undefined
bash
undefined

Set your API key

设置你的API密钥

export GEMINI_API_KEY="your-gemini-api-key"
export GEMINI_API_KEY="your-gemini-api-key"

Run the generator

运行生成器

python3 scripts/generate-deck.py
--content slides.json
--style whiteboard
--title "Deck Title"
[--output-dir ./output]
[--aspect 16:9]

The script:
1. Generates each slide image via Imagen 4.0 API
2. Saves all images to the output directory
3. Optionally creates a Google Slides presentation (requires Google Slides API credentials)
4. Returns paths to all generated images
python3 scripts/generate-deck.py
--content slides.json
--style whiteboard
--title "Deck Title"
[--output-dir ./output]
[--aspect 16:9]

脚本执行逻辑：
1. 通过Imagen 4.0 API生成每张幻灯片的图像
2. 将所有图像保存到输出目录
3. 可选择创建Google Slides演示文稿（需要Google Slides API凭证）
4. 返回所有生成图像的路径

Step 4: Review & Iterate

步骤4：审核与迭代

To regenerate individual slides:
bash
python3 scripts/generate-deck.py \
  --content slides.json \
  --style whiteboard \
  --slides 3,7 \
  --output-dir ./output
如果需要重新生成指定幻灯片：
bash
python3 scripts/generate-deck.py \
  --content slides.json \
  --style whiteboard \
  --slides 3,7 \
  --output-dir ./output

Key Details

核心细节

  • Cost: ~4 cents per image. A 14-slide deck costs roughly 56 cents in API calls.
  • Speed: ~2 minutes for 14 slides.
  • API: Imagen 4.0 via Google's Generative Language API
  • Auth: Set 
    $GEMINI_API_KEY
    environment variable
  • Aspect ratios: 16:9 (default), 1:1, 4:3, 3:4, 9:16
  • Image models: 
    imagen-4.0-generate-001
    (best quality), 
    imagen-4.0-fast-generate-001
    (faster)
  • 成本：每张图像约4美分，14页的演示文稿API调用成本约为56美分
  • 速度：14页幻灯片生成约需2分钟
  • API：通过Google生成式语言API调用Imagen 4.0
  • 鉴权：设置
    $GEMINI_API_KEY
    环境变量
  • 宽高比：16:9（默认）、1:1、4:3、3:4、9:16
  • 图像模型：
    imagen-4.0-generate-001
    （最佳质量）、
    imagen-4.0-fast-generate-001
    （更快速度）

Content JSON Format

内容JSON格式

json
[
  {"name": "01-title", "prompt": "Title slide: 'Your Deck Title' with company logo placeholder"},
  {"name": "02-problem", "prompt": "Problem slide showing frustrated marketer staring at dashboard with declining metrics"},
  {"name": "03-solution", "prompt": "Solution slide: AI agent workflow diagram with 3 connected boxes"}
]
json
[
  {"name": "01-title", "prompt": "Title slide: 'Your Deck Title' with company logo placeholder"},
  {"name": "02-problem", "prompt": "Problem slide showing frustrated marketer staring at dashboard with declining metrics"},
  {"name": "03-solution", "prompt": "Solution slide: AI agent workflow diagram with 3 connected boxes"}
]

Google Slides Integration (Optional)

Google Slides集成（可选）

To automatically create a Google Slides presentation, set up Google Slides API credentials:
bash
export GOOGLE_APPLICATION_CREDENTIALS="/path/to/service-account.json"
python3 scripts/generate-deck.py \
  --content slides.json \
  --style whiteboard \
  --title "My Deck" \
  --google-slides \
  --google-account your-email@example.com
如果需要自动创建Google Slides演示文稿，请先配置Google Slides API凭证：
bash
export GOOGLE_APPLICATION_CREDENTIALS="/path/to/service-account.json"
python3 scripts/generate-deck.py \
  --content slides.json \
  --style whiteboard \
  --title "My Deck" \
  --google-slides \
  --google-account your-email@example.com