Release standalone PPT template workflow 0.5.0

2026-10-10 21:02:47 +08:00
commit 4e3271ff62
303 changed files with 190946 additions and 0 deletions
@@ -0,0 +1,182 @@
+#!/usr/bin/env python3
+"""
+Replicate image generation backend.
+
+Configuration keys:
+  REPLICATE_API_KEY / REPLICATE_API_TOKEN   (required)
+  REPLICATE_BASE_URL                        (optional)
+  REPLICATE_MODEL                           (optional)
+"""
+
+import sys
+from pathlib import Path
+
+_SCRIPTS_DIR = Path(__file__).resolve().parents[1]
+if str(_SCRIPTS_DIR) not in sys.path:
+    sys.path.insert(0, str(_SCRIPTS_DIR))
+
+from console_encoding import configure_utf8_stdio  # noqa: E402
+
+configure_utf8_stdio()
+
+if __name__ == "__main__":
+    print(__doc__)
+    print("Use via: python3 skills/ppt-master/scripts/image_gen.py \"prompt\" --backend replicate")
+    raise SystemExit(0 if any(arg in {"-h", "--help", "help"} for arg in sys.argv[1:]) else 1)
+
+import os
+import time
+
+import requests
+
+from image_backends.backend_common import (
+    MAX_RETRIES,
+    download_image,
+    http_error,
+    is_rate_limit_error,
+    poll_json,
+    require_api_key,
+    resolve_output_path,
+    retry_delay,
+)
+
+
+VALID_ASPECT_RATIOS = ["1:1", "16:9", "9:16", "3:4", "4:3", "3:2", "2:3", "4:5", "5:4", "21:9"]
+DEFAULT_BASE_URL = "https://api.replicate.com/v1"
+DEFAULT_MODEL = "black-forest-labs/flux-1.1-pro"
+
+
+def _split_model(model: str) -> tuple[str, str]:
+    """Split a Replicate model reference into owner and name."""
+    parts = [part for part in model.strip().split("/") if part]
+    if len(parts) != 2:
+        raise ValueError(
+            f"Replicate model must be in 'owner/name' format, got '{model}'."
+        )
+    return parts[0], parts[1]
+
+
+def _extract_output_url(payload: dict) -> str | None:
+    """Extract an output URL from a Replicate prediction payload."""
+    output = payload.get("output")
+    if isinstance(output, str):
+        return output
+    if isinstance(output, list) and output:
+        first = output[0]
+        if isinstance(first, str):
+            return first
+        if isinstance(first, dict):
+            return first.get("url")
+    if isinstance(output, dict):
+        return output.get("url")
+    return None
+
+
+def _generate_image(api_key: str, prompt: str,
+                    aspect_ratio: str = "1:1", image_size: str = "1K",
+                    output_dir: str = None, filename: str = None,
+                    model: str = DEFAULT_MODEL, base_url: str = DEFAULT_BASE_URL) -> str:
+    """Generate one image with the Replicate backend."""
+    del image_size
+
+    if aspect_ratio not in VALID_ASPECT_RATIOS:
+        raise ValueError(
+            f"Unsupported aspect ratio '{aspect_ratio}' for Replicate backend. "
+            f"Supported: {VALID_ASPECT_RATIOS}"
+        )
+
+    owner, name = _split_model(model)
+    url = f"{base_url.rstrip('/')}/models/{owner}/{name}/predictions"
+    headers = {
+        "Authorization": f"Bearer {api_key}",
+        "Content-Type": "application/json",
+        "Prefer": "wait=60",
+    }
+
+    payload = {
+        "input": {
+            "prompt": prompt,
+            "aspect_ratio": aspect_ratio,
+            "output_format": "png",
+        }
+    }
+
+    print("[Replicate]")
+    print(f"  Model:        {model}")
+    print(f"  Prompt:       {prompt[:120]}{'...' if len(prompt) > 120 else ''}")
+    print(f"  Aspect Ratio: {aspect_ratio}")
+    print()
+    print("  [..] Generating...", end="", flush=True)
+    start = time.time()
+    response = requests.post(url, headers=headers, json=payload, timeout=180)
+    elapsed = time.time() - start
+    print(f"\n  [DONE] Initial response received ({elapsed:.1f}s)")
+
+    if response.status_code not in (200, 201):
+        raise http_error(response, "Replicate generation request")
+
+    data = response.json()
+    status = str(data.get("status", "")).lower()
+    if status != "succeeded":
+        poll_url = ((data.get("urls") or {}).get("get"))
+        if not poll_url:
+            prediction_id = data.get("id")
+            if prediction_id:
+                poll_url = f"{base_url.rstrip('/')}/predictions/{prediction_id}"
+        if not poll_url:
+            raise RuntimeError(f"Replicate response missing poll URL: {data}")
+
+        print("  [..] Polling result...")
+        data = poll_json(
+            poll_url,
+            {"Authorization": f"Bearer {api_key}"},
+            status_label="status",
+            ready_values=["succeeded"],
+            failed_values=["failed", "canceled"],
+        )
+
+    image_url = _extract_output_url(data)
+    if not image_url:
+        raise RuntimeError(f"Replicate response missing output URL: {data}")
+
+    path = resolve_output_path(prompt, output_dir, filename, ".png")
+    return download_image(image_url, path)
+
+
+def generate(prompt: str,
+             aspect_ratio: str = "1:1", image_size: str = "1K",
+             output_dir: str = None, filename: str = None,
+             model: str = None, max_retries: int = MAX_RETRIES) -> str:
+    """Generate an image with retries using the Replicate backend."""
+    api_key = require_api_key(
+        "REPLICATE_API_KEY",
+        "REPLICATE_API_TOKEN",
+        message="No API key found. Set REPLICATE_API_KEY or REPLICATE_API_TOKEN in the current environment or a .env file.",
+    )
+    base_url = os.environ.get("REPLICATE_BASE_URL") or DEFAULT_BASE_URL
+    resolved_model = model or os.environ.get("REPLICATE_MODEL") or DEFAULT_MODEL
+
+    last_error = None
+    for attempt in range(max_retries + 1):
+        try:
+            return _generate_image(
+                api_key=api_key,
+                prompt=prompt,
+                aspect_ratio=aspect_ratio,
+                image_size=image_size,
+                output_dir=output_dir,
+                filename=filename,
+                model=resolved_model,
+                base_url=base_url,
+            )
+        except Exception as exc:
+            last_error = exc
+            if attempt >= max_retries:
+                break
+            limited = is_rate_limit_error(exc)
+            delay = retry_delay(attempt, rate_limited=limited)
+            label = "Rate limit hit" if limited else f"Error: {exc}"
+            print(f"\n  [WARN] {label}. Retrying in {delay}s...")
+            time.sleep(delay)
+
+    raise RuntimeError(f"Failed after {max_retries + 1} attempts. Last error: {last_error}")