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
feat(image-gen): add OpenAI-compatible knobs instead of per-provider backend
hugohe3ff86657ce33d
diff --git a/.env.example b/.env.exampleindex 68f4a033..689c12e4 100644--- a/.env.example+++ b/.env.example@@ -45,6 +45,11 @@# OPENAI_API_KEY=sk-xxx# OPENAI_MODEL=gpt-image-2# 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+# OPENAI_QUALITY=auto# Allowed values: png / jpeg / webp# OPENAI_OUTPUT_FORMAT=png# jpeg/webp only, 0-100@@ -136,6 +141,15 @@# OPENROUTER_MODEL=google/gemini-3.1-flash-image-preview# 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=Tongyi-MAI/Z-Image-Turbodiff --git a/skills/ppt-master/.env.example b/skills/ppt-master/.env.exampleindex 6bd4b15b..a463323a 100644--- a/skills/ppt-master/.env.example+++ b/skills/ppt-master/.env.example@@ -40,6 +40,11 @@# OPENAI_API_KEY=sk-xxx# OPENAI_MODEL=gpt-image-2# 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+# OPENAI_QUALITY=auto# Allowed values: png / jpeg / webp# OPENAI_OUTPUT_FORMAT=png# jpeg/webp only, 0-100@@ -131,6 +136,15 @@# OPENROUTER_MODEL=google/gemini-3.1-flash-image-preview# 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=Tongyi-MAI/Z-Image-Turbodiff --git a/skills/ppt-master/references/image-generator.md b/skills/ppt-master/references/image-generator.mdindex b42b3152..29117b5f 100644--- a/skills/ppt-master/references/image-generator.md+++ b/skills/ppt-master/references/image-generator.md@@ -468,9 +468,14 @@ Precedence:| `{PROVIDER}_API_KEY` | Required | Provider-specific API key, e.g. `GEMINI_API_KEY`, `ZHIPU_API_KEY` || `{PROVIDER}_BASE_URL` | Optional | Provider-specific custom endpoint || `{PROVIDER}_MODEL` | Optional | Provider-specific model override |+| `OPENAI_SIZE_PRESET` | Optional | OpenAI-compatible size mapping: `auto`, `legacy`, `gpt-image`, `gpt-image-2`, `dall-e-2` |+| `OPENAI_RESPONSE_FORMAT` | Optional | OpenAI-compatible response field: `auto`, `b64_json`, `url`, `omit` |+| `OPENAI_QUALITY` | Optional | OpenAI-compatible quality field: `auto`, `omit`, `low`, `medium`, `high`, `standard`, `hd` |> Use provider-specific names only (e.g. `GEMINI_API_KEY`, `OPENAI_API_KEY`). See `.env.example` in clone mode or `${SKILL_DIR}/.env.example` in skill-install mode for the full set per backend.+> Note: OpenAI-compatible platforms that reject OpenAI-specific fields stay under `IMAGE_BACKEND=openai`; configure the `OPENAI_*` compatibility knobs instead of adding a provider-specific backend.+> `IMAGE_API_KEY`, `IMAGE_MODEL`, and `IMAGE_BASE_URL` are intentionally unsupported.> If `.env` or the current environment contains multiple provider configs, `IMAGE_BACKEND` explicitly selects the active one.diff --git a/skills/ppt-master/scripts/docs/image.md b/skills/ppt-master/scripts/docs/image.mdindex 7d3e32c3..20acfd66 100644--- a/skills/ppt-master/scripts/docs/image.md+++ b/skills/ppt-master/scripts/docs/image.md@@ -79,6 +79,10 @@ OPENAI_API_KEY=sk-xxxOPENAI_MODEL=gpt-image-2# Optional proxy# OPENAI_BASE_URL=http://127.0.0.1:3000/v1+# OpenAI-compatible provider knobs:+# OPENAI_SIZE_PRESET=auto+# OPENAI_RESPONSE_FORMAT=auto+# OPENAI_QUALITY=auto# Allowed values: png / jpeg / webp# OPENAI_OUTPUT_FORMAT=png# jpeg/webp only, 0-100@@ -107,6 +111,19 @@ OpenAI backend notes:- For `gpt-image-2`, `image_size=512px` means a low-quality draft preset, not a literal 512px edge. The model requires both edges to be multiples of 16px, a long:short ratio no greater than 3:1, and total pixels between 655,360 and 8,294,400.- `OPENAI_BACKGROUND=transparent` is not supported by `gpt-image-2`; use `auto` or `opaque`.- If `OPENAI_OUTPUT_FORMAT=jpeg` or `webp`, generated files use `.jpg` or `.webp` extensions instead of `.png`.+- OpenAI-compatible providers that reject OpenAI-specific fields can use `OPENAI_RESPONSE_FORMAT=omit`, `OPENAI_QUALITY=omit`, and `OPENAI_SIZE_PRESET=<preset>`. Valid response formats are `auto`, `b64_json`, `url`, and `omit`; valid size presets are `auto`, `legacy`, `gpt-image`, `gpt-image-2`, and `dall-e-2`.++Example `.env` for Agnes AI through the OpenAI-compatible backend:++```env+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+```Use provider-specific keys only (e.g. `GEMINI_API_KEY`, `OPENAI_API_KEY`). See `.env.example` in clone mode or `${SKILL_DIR}/.env.example` in skill-install mode for the full list per backend.diff --git a/skills/ppt-master/scripts/image_backends/backend_openai.py b/skills/ppt-master/scripts/image_backends/backend_openai.pyindex 4ee19288..752c3684 100644--- a/skills/ppt-master/scripts/image_backends/backend_openai.py+++ b/skills/ppt-master/scripts/image_backends/backend_openai.py@@ -9,6 +9,9 @@ Configuration keys:OPENAI_API_KEY (required) API keyOPENAI_BASE_URL (optional) Custom API endpoint (e.g. http://127.0.0.1:3000/v1)OPENAI_MODEL (optional) Model name (default: gpt-image-2)+ OPENAI_SIZE_PRESET (optional) auto, legacy, gpt-image, gpt-image-2, or dall-e-2+ OPENAI_RESPONSE_FORMAT (optional) auto, b64_json, url, or omit+ OPENAI_QUALITY (optional) auto, omit, low, medium, high, standard, or hdOPENAI_OUTPUT_FORMAT (optional) png, jpeg, or webp for GPT image modelsOPENAI_OUTPUT_COMPRESSION (optional) 0-100, only for jpeg/webp GPT image outputOPENAI_BACKGROUND (optional) auto or opaque for gpt-image-2@@ -136,6 +139,25 @@ GPT_IMAGE_OUTPUT_EXTENSIONS = {"jpeg": ".jpg","webp": ".webp",}+OPENAI_SIZE_PRESETS = {+ "auto",+ "legacy",+ "gpt-image",+ "gpt-image-legacy",+ "gpt-image-2",+ "dall-e-2",+ "dalle-2",+}+OPENAI_RESPONSE_FORMATS = {"auto", "b64_json", "url", "omit"}+OPENAI_QUALITY_VALUES = {+ "auto",+ "omit",+ "low",+ "medium",+ "high",+ "standard",+ "hd",+}GPT_IMAGE_BACKGROUNDS = {"auto", "opaque", "transparent"}GPT_IMAGE_MODERATION_VALUES = {"auto", "low"}DEFAULT_BASE_URL = "https://api.openai.com/v1"@@ -194,15 +216,23 @@ def _validate_gpt_image_2_size(size: str) -> None:raise ValueError(f"Invalid gpt-image-2 size '{size}': {', '.join(errors)}")-def _select_size(model: str, aspect_ratio: str, image_size: str) -> str:+def _select_size(+ model: str,+ aspect_ratio: str,+ image_size: str,+ size_preset: str | None = None,+) -> str:"""Select a model-compatible size while preserving legacy fallbacks."""- if _is_gpt_image_2(model):+ preset = size_preset or "auto"+ if preset in {"gpt-image-2"} or (preset == "auto" and _is_gpt_image_2(model)):size = GPT_IMAGE_2_SIZES[image_size][aspect_ratio]_validate_gpt_image_2_size(size)return size- if _is_gpt_image_model(model):+ if preset in {"gpt-image", "gpt-image-legacy"} or (+ preset == "auto" and _is_gpt_image_model(model)+ ):return GPT_IMAGE_LEGACY_ASPECT_RATIO_TO_SIZE[aspect_ratio]- if _is_dall_e_2(model):+ if preset in {"dall-e-2", "dalle-2"} or (preset == "auto" and _is_dall_e_2(model)):return DALL_E_2_SIZE_BY_IMAGE_SIZE[image_size]return LEGACY_COMPAT_ASPECT_RATIO_TO_SIZE[aspect_ratio]@@ -267,7 +297,42 @@ def _gpt_image_options(model: str) -> tuple[dict, str]:def _image_generations_url(base_url: str | None) -> str:- return f"{(base_url or DEFAULT_BASE_URL).rstrip('/')}/images/generations"+ base = (base_url or DEFAULT_BASE_URL).rstrip("/")+ if base.endswith("/images/generations"):+ return base+ return f"{base}/images/generations"+++def _read_size_preset() -> str | None:+ """Read the optional size mapping preset for OpenAI-compatible providers."""+ return _read_env_choice("OPENAI_SIZE_PRESET", OPENAI_SIZE_PRESETS)+++def _read_response_format() -> str | None:+ """Read the optional response_format override."""+ return _read_env_choice("OPENAI_RESPONSE_FORMAT", OPENAI_RESPONSE_FORMATS)+++def _read_quality(image_size: str) -> str | None:+ """Resolve the quality field for OpenAI-compatible requests."""+ quality = _read_env_choice("OPENAI_QUALITY", OPENAI_QUALITY_VALUES)+ if quality == "omit":+ return None+ if quality and quality != "auto":+ return quality+ return IMAGE_SIZE_TO_QUALITY.get(image_size, "auto")+++def _apply_response_format(request: dict, model: str) -> None:+ """Apply response_format while preserving the existing default behavior."""+ response_format = _read_response_format()+ if response_format == "omit":+ return+ if response_format in {"b64_json", "url"}:+ request["response_format"] = response_format+ return+ if _supports_response_format(model):+ request["response_format"] = "b64_json"def _post_image_generation(api_key: str, base_url: str | None, request: dict) -> dict:@@ -309,28 +374,38 @@ def _generate_image(api_key: str, prompt: str,RuntimeError: When generation fails"""# Map parameters- size = _select_size(model, aspect_ratio, image_size)- quality = IMAGE_SIZE_TO_QUALITY.get(image_size, "auto")+ size_preset = _read_size_preset()+ size = _select_size(model, aspect_ratio, image_size, size_preset)+ quality = _read_quality(image_size)output_ext = ".png"request = {"prompt": prompt,"model": model,"size": size,- "quality": quality,"n": 1,}+ if quality is not None:+ request["quality"] = qualityif _is_gpt_image_model(model):gpt_options, output_ext = _gpt_image_options(model)request.update(gpt_options)- elif _supports_response_format(model):- request["response_format"] = "b64_json"+ _apply_response_format(request, model)mode_label = f"Proxy: {base_url}" if base_url else "OpenAI API"print(f"[OpenAI - {mode_label}]")print(f" Model: {model}")print(f" Prompt: {prompt[:120]}{'...' if len(prompt) > 120 else ''}")print(f" Size: {size} (from aspect_ratio={aspect_ratio})")- print(f" Quality: {quality} (from image_size={image_size})")+ if size_preset and size_preset != "auto":+ print(f" Size Preset: {size_preset}")+ if quality is not None:+ print(f" Quality: {quality} (from image_size={image_size})")+ else:+ print(" Quality: omitted")+ if request.get("response_format"):+ print(f" Response: {request['response_format']}")+ elif _read_response_format() == "omit":+ print(" Response: omitted")if request.get("output_format"):print(f" Format: {request['output_format']}")if request.get("output_compression") is not None: