Skip to content

AI turns documents or topics into real, native PowerPoint decks—with native shapes, transitions and animations, data-backed charts and tables on demand, audio narration from speaker notes, and support for your own .pptx templates. · by Hugo He

16.3 KB
Raw Blame
# ─────────────────────────────────────────────────────────────
# Image Generation Configuration / 图片生成配置
# ─────────────────────────────────────────────────────────────

# This file is an optional fallback config source for image_gen.py.
# Current process environment variables take precedence over this file.
# 当前文件是 image_gen.py 的可选 fallback 配置来源。
# 当前进程环境变量优先于这个文件。
#
# Resolution order (only the FIRST existing file is read; keys are NOT merged across files):
#   1. ./.env in your current working directory
#   2. <skill-dir>/.env (skill install, e.g. ~/.agents/skills/ppt-master/.env)
#   3. <repo-root>/.env (when running from a clone)
#   4. ~/.ppt-master/.env (user-level config)
# 查找顺序(只读第一个存在的文件,多个 .env 之间不合并):
#   1. 当前工作目录下的 ./.env
#   2. skill 安装目录下的 .env(如 ~/.agents/skills/ppt-master/.env)
#   3. 仓库根目录下的 .env(仅在 clone 模式下)
#   4. ~/.ppt-master/.env(用户级配置)

# Active backend (required) / 当前启用后端(必需)
# Recommended core backends: openai / gemini / qwen / zhipu / volcengine
# 推荐核心后端:openai / gemini / qwen / zhipu / volcengine
# IMAGE_BACKEND=openai

# Max concurrent requests in --manifest batch mode (default 3).
# Auto-halves on rate-limit; 1 is the serial fallback.
# --manifest 批量模式下的最大并发数(默认 3)。命中限流自动减半,最低 1(=串行)。
# IMAGE_CONCURRENCY=3

# You may also provide the same variables directly via the current process environment.
# 也可以不写 .env,而是直接通过当前运行进程的环境变量提供同样的配置。

# IMPORTANT:
# - IMAGE_API_KEY / IMAGE_MODEL / IMAGE_BASE_URL are no longer supported.
# - Use provider-specific keys only.
# 重要:
# - 不再支持 IMAGE_API_KEY / IMAGE_MODEL / IMAGE_BASE_URL。
# - 请只使用各提供商自己的变量。

# ─────────────────────────────────────────────────────────────
# Example: OpenAI / OpenAI 示例  (recommended / 推荐)
# ─────────────────────────────────────────────────────────────
# IMAGE_BACKEND=openai
# OPENAI_API_KEY=sk-xxx
# OPENAI_MODEL=gpt-image-2
# Legacy ChatGPT image API model / 旧版 ChatGPT 生图 API 模型
# OPENAI_MODEL=chatgpt-image-latest  # Deprecated by OpenAI / OpenAI 已弃用
# OPENAI_BASE_URL=http://127.0.0.1:3000/v1
# OpenAI-compatible providers may need these compatibility knobs.
# OpenAI-compatible 第三方平台可按需开启以下兼容参数。
# OPENAI_SIZE_PRESET=auto
# OPENAI_RESPONSE_FORMAT=auto
# GPT Image: auto / omit / low / medium / high; xhigh / max only for
# gpt-image-2.5-sunburst / gpt-image-2.5-flare and their snapshots.
# GPT Image:auto / omit / low / medium / high;xhigh / max 仅限上述 2.5 型号及快照。
# OPENAI_QUALITY=auto
# Allowed values: png / jpeg / webp
# OPENAI_OUTPUT_FORMAT=png
# jpeg/webp only, 0-100
# OPENAI_OUTPUT_COMPRESSION=80
# GPT Image: auto / opaque / transparent (png/webp only; gpt-image-2 support is in preview)
# GPT Image:auto / opaque / transparent(透明背景仅限 png/webp;gpt-image-2 为预览支持)
# OPENAI_BACKGROUND=auto
# auto / low
# OPENAI_MODERATION=auto
# Reference edits: gpt-image-1 / gpt-image-1.5 high / low; gpt-image-1-mini low only.
# Leave unset for gpt-image-2 and the two 2.5 models (including snapshots).
# 参考图编辑:gpt-image-1 / gpt-image-1.5 支持 high / low;gpt-image-1-mini 仅支持 low。
# gpt-image-2 与上述两种 2.5 型号(含快照)不设置此项。
# OPENAI_INPUT_FIDELITY=high

# ─────────────────────────────────────────────────────────────
# Example: Gemini / Gemini 示例
# ─────────────────────────────────────────────────────────────
# IMAGE_BACKEND=gemini
# GEMINI_API_KEY=your-gemini-api-key
# GEMINI_MODEL=gemini-nano-banana-2.1
# GEMINI_BASE_URL=https://your-proxy-url.com

# ─────────────────────────────────────────────────────────────
# Example: MiniMax / MiniMax 示例
# ─────────────────────────────────────────────────────────────
# IMAGE_BACKEND=minimax
# MINIMAX_API_KEY=your-minimax-key
# MINIMAX_MODEL=image-01
# Default China endpoint / 默认国内地址
# MINIMAX_BASE_URL=https://api.minimaxi.com/v1/image_generation
# Optional overseas endpoint / 可选海外地址
# MINIMAX_BASE_URL=https://api.minimax.io/v1/image_generation

# ─────────────────────────────────────────────────────────────
# Example: Qwen / 通义生图示例
# ─────────────────────────────────────────────────────────────
# IMAGE_BACKEND=qwen
# QWEN_API_KEY=your-dashscope-key
# QWEN_MODEL=qwen-image-2.0-pro
# QWEN_BASE_URL=https://dashscope-intl.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation

# ─────────────────────────────────────────────────────────────
# Example: Zhipu / 智谱生图示例
# ─────────────────────────────────────────────────────────────
# IMAGE_BACKEND=zhipu
# ZHIPU_API_KEY=your-zhipu-key
# ZHIPU_MODEL=glm-image
# ZHIPU_BASE_URL=https://open.bigmodel.cn/api/paas/v4/images/generations

# ─────────────────────────────────────────────────────────────
# Example: Volcengine / 火山引擎示例
# ─────────────────────────────────────────────────────────────
# IMAGE_BACKEND=volcengine
# LAS_API_KEY=your-las-key
# VOLCENGINE_MODEL=doubao-seedream-4-5-251128
# VOLCENGINE_BASE_URL=https://operator.las.cn-beijing.volces.com/api/v1
# Optional Ark base URL / 可选 Ark 基址
# VOLCENGINE_BASE_URL=https://ark.cn-beijing.volces.com/api/v3

# ─────────────────────────────────────────────────────────────
# Example: Tencent Cloud TokenHub / 腾讯云 TokenHub 生图示例
# ─────────────────────────────────────────────────────────────
# IMAGE_BACKEND=tencent
# TENCENT_API_KEY=your-tokenhub-key
# Alternative key / 备选密钥:TOKENHUB_API_KEY
# TENCENT_MODEL=hy-image-v3
# TENCENT_BASE_URL=https://tokenhub.tencentmaas.com
# International base / 国际基址:https://tokenhub-intl.tencentmaas.com
# Hy: hy-image-v3 uses /v1/wand/hunyuan-image/v3-generation / 混元模型使用此端点
# Seedream: seedream-image-v5.0-pro / seedream-image-v5.0-lite use /v1/wand/si-image/generation / 即梦模型使用此端点
# TENCENT_REVISE=true       # Hy only / 仅混元
# TENCENT_WATERMARK=false   # Seedream only / 仅即梦
# TENCENT_OUTPUT_FORMAT=png # Seedream: png / jpeg / 即梦输出格式

# ─────────────────────────────────────────────────────────────
# Sponsor relay shortcuts / 赞助商中转快捷配置
# ─────────────────────────────────────────────────────────────
# Project sponsors that resell OpenAI-compatible image models. Optional —
# every backend above works the same way. Uncomment the four lines of one
# block and fill in the key. A variable already set in the process environment,
# or earlier in this file, keeps its value.
# 以下是本项目赞助商提供的 OpenAI 兼容中转,可选;上面的任一后端同样可用。
# 取消其中一段四行的注释并填入 Key。进程环境变量或本文件更靠前的同名变量优先。
#
# PackyCode — register / 注册: https://www.packyapi.ai/register?aff=ppt-master
#   Promo code ppt-master gives 10% off recharge. gpt-image-2 needs a token in the "image" group.
#   充值时填优惠码 ppt-master 享 9 折;gpt-image-2 需要令牌分组为 image。
#   Docs / 文档: https://docs.packyapi.com/docs/paint/GPTImage.html
# IMAGE_BACKEND=openai
# OPENAI_API_KEY=your-packycode-key
# OPENAI_MODEL=gpt-image-2
# OPENAI_BASE_URL=https://cf.api.fan/v1
#
# APIKEY.FAN — register / 注册: https://apikey.fan/register?aff=PPT-MASTER
#   Up to 5% off top-ups, permanently. / 充值最高永久 95 折。
#   Confirm gpt-image-2 is in your console's model list before use.
#   使用前请在控制台模型列表确认 gpt-image-2 已上架。
# IMAGE_BACKEND=openai
# OPENAI_API_KEY=your-apikey-fan-key
# OPENAI_MODEL=gpt-image-2
# OPENAI_BASE_URL=https://api.apikey.fan/v1
#
# RunAPI — register / 注册: https://runapi.host/register?aff=WMLJ
#   Contact an administrator after registering to claim ¥7 in free credit.
#   注册后联系管理员领取 ¥7 体验额度。
#   Backup base URL / 备用基址: https://runapi.host/v1
# IMAGE_BACKEND=openai
# OPENAI_API_KEY=your-runapi-key
# OPENAI_MODEL=gpt-image-2
# OPENAI_BASE_URL=https://runapi.co/v1
#
# If a relay rejects quality or response_format, set OPENAI_QUALITY=omit or
# OPENAI_RESPONSE_FORMAT=omit; only these two accept omit. Leave other OPENAI_* unset.
# 中转拒绝 quality 或 response_format 时,设 OPENAI_QUALITY=omit 或
# OPENAI_RESPONSE_FORMAT=omit;仅这两项接受 omit,其余 OPENAI_* 不设即可。

# ─────────────────────────────────────────────────────────────
# Extended / Experimental backends
# 扩展 / 实验后端
# ─────────────────────────────────────────────────────────────
# STABILITY_API_KEY=your-stability-key
# STABILITY_MODEL=stable-image-core
# STABILITY_BASE_URL=https://api.stability.ai
#
# BFL_API_KEY=your-bfl-key
# BFL_MODEL=flux-pro-1.1-ultra
# BFL_BASE_URL=https://api.bfl.ai
#
# IDEOGRAM_API_KEY=your-ideogram-key
# IDEOGRAM_MODEL=ideogram-v3
# IDEOGRAM_BASE_URL=https://api.ideogram.ai
#
# MINIMAX_API_KEY=your-minimax-key
# MINIMAX_MODEL=image-01
# Default China endpoint / 默认国内地址
# MINIMAX_BASE_URL=https://api.minimaxi.com/v1/image_generation
# Optional overseas endpoint / 可选海外地址
# MINIMAX_BASE_URL=https://api.minimax.io/v1/image_generation
#
# SILICONFLOW_API_KEY=your-siliconflow-key
# SILICONFLOW_MODEL=Qwen/Qwen-Image
# SILICONFLOW_BASE_URL=https://api.siliconflow.cn/v1/images/generations
#
# FAL_KEY=your-fal-key
# FAL_MODEL=google/nano-banana-2.1
# FAL_BASE_URL=https://fal.run
#
# REPLICATE_API_TOKEN=r8_xxx
# REPLICATE_MODEL=black-forest-labs/flux-1.1-pro
# REPLICATE_BASE_URL=https://api.replicate.com/v1
#
# OPENROUTER_API_KEY=sk-or-v1-xxx
# OPENROUTER_MODEL=google/gemini-nano-banana-2.1
# OPENROUTER_BASE_URL=https://openrouter.ai/api/v1
#
# OpenAI-compatible example: Agnes AI / OpenAI-compatible 示例:Agnes AI
# IMAGE_BACKEND=openai
# OPENAI_API_KEY=your-agnes-key
# OPENAI_MODEL=agnes-image-2.1-flash
# OPENAI_BASE_URL=https://apihub.agnes-ai.com/v1
# OPENAI_SIZE_PRESET=gpt-image-2
# OPENAI_RESPONSE_FORMAT=omit
# OPENAI_QUALITY=omit
#
# IMAGE_BACKEND=modelscope
# MODELSCOPE_API_KEY=your-modelscope-key
# MODELSCOPE_MODEL=your-api-inference-text-to-image-model-id
# MODELSCOPE_BASE_URL=https://api-inference.modelscope.cn/v1

# ─────────────────────────────────────────────────────────────
# Multi-provider example / 多提供商共存示例
# ─────────────────────────────────────────────────────────────
# IMAGE_BACKEND=openai
# OPENAI_API_KEY=sk-xxx
# OPENAI_MODEL=gpt-image-2
# OPENAI_OUTPUT_FORMAT=png
# GEMINI_API_KEY=your-gemini-api-key
# GEMINI_MODEL=gemini-nano-banana-2.1
#
# Switch providers by changing IMAGE_BACKEND only.
# 切换提供商时,只改 IMAGE_BACKEND 即可。

# ─────────────────────────────────────────────────────────────
# Audio narration TTS (notes_to_audio.py) / 旁白音频 TTS
# ─────────────────────────────────────────────────────────────
# edge-tts is the default narration backend and needs no API key.
# Use cloud providers only when you want high-quality or cloned voices —
# all four (ElevenLabs / MiniMax / Qwen / CosyVoice) accept a cloned voice_id.
# Clone the voice in the provider's console first, then pass --voice-id to
# notes_to_audio.py. See workflows/stages/generate-audio.md (installed skill)
# or docs/audio-narration.md "Use a cloned voice" (repository clone).
# edge-tts 是默认旁白后端,无需 API Key。
# 需要高质量云端旁白或复刻音色时再配置云端提供商——
# ElevenLabs / MiniMax / Qwen / CosyVoice 四家都支持传入复刻 voice_id。
# 先在 provider 控制台复刻得到 voice_id,再用 --voice-id 传给 notes_to_audio.py。
# 详见 workflows/stages/generate-audio.md(安装的 skill)或 docs/zh/audio-narration.md "使用复刻音色"(仓库克隆)。
#
# ELEVENLABS_API_KEY=your-elevenlabs-api-key
# MINIMAX_API_KEY=your-minimax-key
# QWEN_API_KEY=your-dashscope-key
# COSYVOICE_API_KEY=your-dashscope-key
# DASHSCOPE_API_KEY=your-dashscope-key
#
# Optional provider-specific TTS endpoint overrides.
# 可选:按提供商覆盖 TTS 接入点。
# Default China endpoint / 默认国内地址
# MINIMAX_TTS_BASE_URL=https://api.minimaxi.com/v1/t2a_v2
# Optional overseas endpoint / 可选海外地址
# MINIMAX_TTS_BASE_URL=https://api.minimax.io/v1/t2a_v2
# QWEN_TTS_BASE_URL=https://dashscope-intl.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation
# COSYVOICE_TTS_BASE_URL=https://dashscope.aliyuncs.com/api/v1/services/audio/tts/SpeechSynthesizer

# ─────────────────────────────────────────────────────────────
# Web image search (image_search.py) / 网络图片搜索
# ─────────────────────────────────────────────────────────────
# Used by scripts/image_search.py — separate from IMAGE_BACKEND above.
# image_search.py 用,与上面的 IMAGE_BACKEND 互不影响。
#
# Openverse and Wikimedia work with no key, but image quality can be uneven.
# For polished stock-style PPT images, configure Pexels and/or Pixabay.
# Openverse 和 Wikimedia 无需 Key,但图片质量不稳定。
# 如需更稳定的商业图库风格 PPT 配图,建议配置 Pexels 和/或 Pixabay。
#
# Sign up: https://www.pexels.com/api/
# PEXELS_API_KEY=your-pexels-key
# Sign up: https://pixabay.com/api/docs/
# PIXABAY_API_KEY=your-pixabay-key