pygpt-net 2.7.3__py3-none-any.whl → 2.7.4__py3-none-any.whl

pygpt_net/preload.py

@@ -0,0 +1,243 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+# ================================================== #
+# This file is a part of PYGPT package               #
+# Website: https://pygpt.net                         #
+# GitHub:  https://github.com/szczyglis-dev/py-gpt   #
+# MIT License                                        #
+# Created By  : Marcin Szczygliński                  #
+# Updated Date: 2025.12.31 17:00:00                  #
+# ================================================== #
+
+# -------------------------------------------------- #
+# Lightweight splash window (separate process)
+# -------------------------------------------------- #
+def _splash_main(conn, title="PyGPT", message="Loading…"):
+    """
+    Minimal splash process using PySide6. Runs its own event loop and
+    listens for commands on a Pipe: {"type": "msg", "text": "..."} or {"type": "quit"}.
+    """
+    try:
+        # Import locally to keep the main process import path untouched
+        from PySide6 import QtCore, QtWidgets
+    except Exception:
+        return
+
+    try:
+        # Enable HiDPI (safe defaults)
+        try:
+            QtWidgets.QApplication.setAttribute(QtCore.Qt.AA_EnableHighDpiScaling, True)
+            QtWidgets.QApplication.setAttribute(QtCore.Qt.AA_UseHighDpiPixmaps, True)
+        except Exception:
+            pass
+
+        app = QtWidgets.QApplication(["pygpt_splash"])
+
+        # Root window styled as splash
+        root = QtWidgets.QWidget(
+            None,
+            QtCore.Qt.SplashScreen
+            | QtCore.Qt.FramelessWindowHint
+            | QtCore.Qt.WindowStaysOnTopHint
+        )
+        root.setAttribute(QtCore.Qt.WA_TranslucentBackground, True)
+        root.setObjectName("SplashRoot")
+
+        panel = QtWidgets.QFrame(root)
+        panel.setObjectName("SplashPanel")
+        panel.setStyleSheet("""
+        #SplashPanel {
+            background-color: rgba(30, 30, 30, 230);
+            border-radius: 12px;
+        }
+        QLabel { color: #ffffff; }
+        """)
+        layout = QtWidgets.QVBoxLayout(panel)
+        layout.setContentsMargins(16, 16, 16, 16)
+        layout.setSpacing(8)
+
+        lbl_title = QtWidgets.QLabel(title, panel)
+        lbl_title.setAlignment(QtCore.Qt.AlignCenter)
+        lbl_title.setStyleSheet("font-size: 16px; font-weight: 600;")
+
+        lbl_wait = QtWidgets.QLabel("Initializing...")
+        lbl_wait.setAlignment(QtCore.Qt.AlignCenter)
+        lbl_wait.setStyleSheet("font-size: 12px;")
+
+        lbl_msg = QtWidgets.QLabel(message, panel)
+        lbl_msg.setAlignment(QtCore.Qt.AlignCenter)
+        lbl_msg.setStyleSheet("font-size: 12px;")
+
+        bar = QtWidgets.QProgressBar(panel)
+        bar.setRange(0, 0)
+        bar.setTextVisible(False)
+        bar.setFixedHeight(8)
+        bar.setStyleSheet("QProgressBar { border: 0px; border-radius: 4px; } "
+                          "QProgressBar::chunk { background-color: #3f3f3f; }")
+
+        layout.addWidget(lbl_title)
+        layout.addWidget(lbl_msg)
+        layout.addWidget(bar)
+        layout.addWidget(lbl_wait)
+
+        panel.setFixedSize(360, 120)
+        panel.move(0, 0)
+        root.resize(panel.size())
+
+        # Center on primary screen
+        screen = app.primaryScreen()
+        if screen:
+            geo = screen.availableGeometry()
+            root.move(geo.center() - root.rect().center())
+
+        # Ensure initial transparency for fade-in
+        try:
+            root.setWindowOpacity(0.0)
+        except Exception:
+            pass
+
+        root.show()
+
+        # Fade-in on start (non-blocking, resilient to platform limitations)
+        try:
+            def _start_fade_in():
+                try:
+                    anim = QtCore.QPropertyAnimation(root, b"windowOpacity")
+                    anim.setDuration(300)
+                    anim.setStartValue(0.0)
+                    anim.setEndValue(1.0)
+                    root._fade_in_anim = anim  # keep reference to avoid GC
+                    anim.start()
+                except Exception:
+                    try:
+                        root.setWindowOpacity(1.0)
+                    except Exception:
+                        pass
+
+            QtCore.QTimer.singleShot(0, _start_fade_in)
+        except Exception:
+            try:
+                root.setWindowOpacity(1.0)
+            except Exception:
+                pass
+
+        # Poll the pipe for messages and close requests
+        timer = QtCore.QTimer()
+        timer.setInterval(80)
+
+        def poll():
+            try:
+                if conn.poll():
+                    msg = conn.recv()
+                    if isinstance(msg, dict):
+                        t = msg.get("type")
+                        if t == "quit":
+                            # Stop fade-in if it is running to avoid conflicting animations
+                            try:
+                                if hasattr(root, "_fade_in_anim") and root._fade_in_anim is not None:
+                                    root._fade_in_anim.stop()
+                            except Exception:
+                                pass
+                            # Fade-out and quit
+                            try:
+                                anim = QtCore.QPropertyAnimation(root, b"windowOpacity")
+                                anim.setDuration(180)
+                                anim.setStartValue(root.windowOpacity())
+                                anim.setEndValue(0.0)
+                                anim.finished.connect(app.quit)
+                                # Keep reference to avoid GC
+                                root._fade_anim = anim
+                                anim.start()
+                            except Exception:
+                                app.quit()
+                        elif t == "msg":
+                            text = msg.get("text", "")
+                            if text:
+                                lbl_msg.setText(text)
+                    elif isinstance(msg, str):
+                        if msg.lower() == "quit":
+                            app.quit()
+            except (EOFError, OSError):
+                # Parent died or pipe closed: exit
+                app.quit()
+
+        timer.timeout.connect(poll)
+        timer.start()
+
+        # Failsafe timeout (can be overridden via env)
+        import os as _os
+        timeout_ms = int(_os.environ.get("PYGPT_SPLASH_TIMEOUT", "120000"))
+        killer = QtCore.QTimer()
+        killer.setSingleShot(True)
+        killer.timeout.connect(app.quit)
+        killer.start(timeout_ms)
+
+        app.exec()
+    except Exception:
+        # No crash propagation to main app
+        pass
+
+
+class _Preloader:
+    """
+    Controller for the splash subprocess.
+    """
+
+    def __init__(self, proc, conn):
+        self._proc = proc
+        self._conn = conn
+
+    def set_message(self, text):
+        try:
+            if self._conn:
+                self._conn.send({"type": "msg", "text": str(text)})
+        except Exception:
+            pass
+
+    def close(self, wait=True, timeout=2.0):
+        try:
+            if self._conn:
+                try:
+                    self._conn.send({"type": "quit"})
+                except Exception:
+                    pass
+        finally:
+            if wait and self._proc is not None:
+                self._proc.join(timeout=timeout)
+            if self._proc is not None and self._proc.is_alive():
+                try:
+                    self._proc.terminate()
+                except Exception:
+                    pass
+            self._conn = None
+            self._proc = None
+
+
+def _start_preloader(title="PyGPT", message="Loading…"):
+    """
+    Start splash as a separate process using 'spawn' on every OS.
+    Returns a _Preloader controller or None if failed.
+    """
+    try:
+        import multiprocessing as mp
+        try:
+            ctx = mp.get_context("spawn")
+        except ValueError:
+            ctx = mp
+
+        parent_conn, child_conn = ctx.Pipe(duplex=True)
+        proc = ctx.Process(
+            target=_splash_main,
+            args=(child_conn, title, message),
+            daemon=True
+        )
+        proc.start()
+
+        try:
+            child_conn.close()
+        except Exception:
+            pass
+
+        return _Preloader(proc, parent_conn)
+    except Exception:
+        return None

pygpt_net/provider/api/google/image.py

@@ -6,7 +6,7 @@
 # GitHub:  https://github.com/szczyglis-dev/py-gpt   #
 # MIT License                                        #
 # Created By  : Marcin Szczygliński                  #
-# Updated Date: 2025.12.30 22:00:00                  #
+# Updated Date: 2025.12.31 16:00:00                  #
 # ================================================== #
 
 import mimetypes
@@ -55,6 +55,7 @@ class Image:
         prompt = context.prompt
         num = int(extra.get("num", 1))
         inline = bool(extra.get("inline", False))
+        extra_prompt = extra.get("extra_prompt", "")
 
         # decide sub-mode based on attachments
         sub_mode = self.MODE_GENERATE
@@ -79,6 +80,7 @@ class Image:
         worker.raw = self.window.core.config.get('img_raw')
         worker.num = num
         worker.inline = inline
+        worker.extra_prompt = extra_prompt
 
         # remix: previous image reference (ID/URI/path) from extra
         worker.image_id = extra.get("image_id")
@@ -129,6 +131,7 @@ class ImageWorker(QRunnable):
         self.input_prompt = ""
         self.system_prompt = ""
         self.inline = False
+        self.extra_prompt: Optional[str] = None
         self.raw = False
         self.num = 1
         self.resolution = "1024x1024"  # used to derive aspect ratio or image_size
@@ -178,6 +181,18 @@ class ImageWorker(QRunnable):
                     self.signals.error.emit(e)
                     self.signals.status.emit(trans('img.status.prompt.error') + ": " + str(e))
 
+            # Decide how to apply negative prompt: native param on Vertex Imagen 3.0 (-001) or inline fallback.
+            use_param = (
+                bool(self.extra_prompt and str(self.extra_prompt).strip())
+                and self._using_vertex()
+                and self._imagen_supports_negative_prompt(self.model)
+            )
+            if (self.extra_prompt and str(self.extra_prompt).strip()) and not use_param:
+                try:
+                    self.input_prompt = self._merge_negative_prompt(self.input_prompt or "", self.extra_prompt)
+                except Exception:
+                    pass
+
             paths: List[str] = []
 
             # Remix path: if image_id provided, prefer image-to-image remix using the given identifier.
@@ -198,11 +213,21 @@ class ImageWorker(QRunnable):
                             mask_dilation=0.0,
                         ),
                     )
-                    cfg = gtypes.EditImageConfig(
+                    # Prepare edit config with optional negative prompt when supported
+                    cfg_kwargs = dict(
                         edit_mode="EDIT_MODE_DEFAULT",
                         number_of_images=min(self.num, self.imagen_max_num),
                         include_rai_reason=True,
                     )
+                    if self.extra_prompt and self._imagen_supports_negative_prompt(self.model):
+                        cfg_kwargs["negative_prompt"] = self.extra_prompt
+                    try:
+                        cfg = gtypes.EditImageConfig(**cfg_kwargs)
+                    except Exception:
+                        # Fallback without negative_prompt if SDK doesn't recognize it
+                        cfg_kwargs.pop("negative_prompt", None)
+                        cfg = gtypes.EditImageConfig(**cfg_kwargs)
+
                     resp = self.client.models.edit_image(
                         model="imagen-3.0-capability-001",
                         prompt=self.input_prompt or "",
@@ -355,12 +380,34 @@ class ImageWorker(QRunnable):
         mid = str(model_id).lower()
         return "imagen" in mid and "generate" in mid
 
+    def _imagen_supports_negative_prompt(self, model_id: str) -> bool:
+        """
+        Return True if the Imagen model supports native negative_prompt.
+        Supported: imagen-3.0-generate-001, imagen-3.0-fast-generate-001, imagen-3.0-capability-001.
+        """
+        mid = str(model_id or "").lower()
+        return any(x in mid for x in (
+            "imagen-3.0-generate-001",
+            "imagen-3.0-fast-generate-001",
+            "imagen-3.0-capability-001",
+        ))
+
     def _imagen_generate(self, prompt: str, num: int, resolution: str):
         """Imagen text-to-image."""
         aspect = self._aspect_from_resolution(resolution)
-        cfg = gtypes.GenerateImagesConfig(number_of_images=num)
+        # Build config with optional negative_prompt when supported by model and provided.
+        cfg_kwargs: Dict[str, Any] = {"number_of_images": num}
         if aspect:
-            cfg.aspect_ratio = aspect
+            cfg_kwargs["aspect_ratio"] = aspect
+        if self.extra_prompt and self._imagen_supports_negative_prompt(self.model):
+            cfg_kwargs["negative_prompt"] = self.extra_prompt
+        try:
+            cfg = gtypes.GenerateImagesConfig(**cfg_kwargs)
+        except Exception:
+            # Fallback without negative_prompt if SDK doesn't recognize it
+            cfg_kwargs.pop("negative_prompt", None)
+            cfg = gtypes.GenerateImagesConfig(**cfg_kwargs)
+
         return self.client.models.generate_images(
             model=self.model,
             prompt=prompt,
@@ -401,11 +448,19 @@ class ImageWorker(QRunnable):
             )
             edit_mode = "EDIT_MODE_BGSWAP"
 
-        cfg = gtypes.EditImageConfig(
+        # Build edit config with optional negative_prompt
+        cfg_kwargs = dict(
             edit_mode=edit_mode,
             number_of_images=min(num, self.imagen_max_num),
             include_rai_reason=True,
         )
+        if self.extra_prompt and self._imagen_supports_negative_prompt(self.model):
+            cfg_kwargs["negative_prompt"] = self.extra_prompt
+        try:
+            cfg = gtypes.EditImageConfig(**cfg_kwargs)
+        except Exception:
+            cfg_kwargs.pop("negative_prompt", None)
+            cfg = gtypes.EditImageConfig(**cfg_kwargs)
 
         # Ensure capability model for edit
         model_id = "imagen-3.0-capability-001"
@@ -806,4 +861,17 @@ class ImageWorker(QRunnable):
             try:
                 sig.deleteLater()
             except RuntimeError:
-                pass
+                pass
+
+    # ---------- prompt utilities ----------
+
+    @staticmethod
+    def _merge_negative_prompt(prompt: str, negative: Optional[str]) -> str:
+        """
+        Append a negative prompt to the main text prompt when the provider has no native negative_prompt field.
+        """
+        base = (prompt or "").strip()
+        neg = (negative or "").strip()
+        if not neg:
+            return base
+        return (base + ("\n" if base else "") + f"Negative prompt: {neg}").strip()

pygpt_net/provider/api/google/video.py

@@ -6,7 +6,7 @@
 # GitHub:  https://github.com/szczyglis-dev/py-gpt   #
 # MIT License                                        #
 # Created By  : Marcin Szczygliński                  #
-# Updated Date: 2025.12.30 22:00:00                  #
+# Updated Date: 2025.12.31 16:00:00                  #
 # ================================================== #
 
 import base64, datetime, os, requests
@@ -55,6 +55,7 @@ class Video:
         num = int(extra.get("num", 1))
         inline = bool(extra.get("inline", False))
         video_id = extra.get("video_id")
+        extra_prompt = extra.get("extra_prompt", "")
 
         # decide sub-mode based on attachments (image-to-video when image is attached)
         sub_mode = self.MODE_GENERATE
@@ -81,6 +82,7 @@ class Video:
         worker.raw = self.window.core.config.get('img_raw')
         worker.num = num
         worker.inline = inline
+        worker.extra_prompt = extra_prompt
         worker.video_id = video_id
 
         # optional params
@@ -143,6 +145,7 @@ class VideoWorker(QRunnable):
         self.input_prompt = ""
         self.system_prompt = ""
         self.inline = False
+        self.extra_prompt: Optional[str] = None
         self.video_id = None
         self.raw = False
         self.num = 1
@@ -152,7 +155,6 @@ class VideoWorker(QRunnable):
         self.duration_seconds = 8
         self.fps = 24
         self.seed: Optional[int] = None
-        self.negative_prompt: Optional[str] = None
         self.generate_audio: bool = False  # generation includes audio by default on Veo 3.x
         self.resolution: str = "720p"      # Veo supports 720p/1080p depending on variant
 
@@ -205,8 +207,8 @@ class VideoWorker(QRunnable):
             # set optional controls
             if self.seed is not None:
                 cfg_kwargs["seed"] = int(self.seed)
-            if self.negative_prompt:
-                cfg_kwargs["negative_prompt"] = self.negative_prompt
+            if self.extra_prompt:
+                cfg_kwargs["negative_prompt"] = self.extra_prompt
 
             # set durationSeconds when supported; fall back gracefully if rejected by model
             cfg_try = dict(cfg_kwargs)
@@ -228,6 +230,9 @@ class VideoWorker(QRunnable):
 
                 # Minimal config for extension to avoid server-side rejections
                 ext_config = gtypes.GenerateVideosConfig(number_of_videos=1)
+                # Pass negative prompt to extension when provided
+                if self.extra_prompt:
+                    ext_config.negative_prompt = self.extra_prompt  # supported in python-genai
 
                 label = trans('vid.status.generating') + " (remix)"
                 self.signals.status.emit(label + f": {self.input_prompt or ''}...")

pygpt_net/provider/api/openai/image.py

@@ -6,7 +6,7 @@
 # GitHub:  https://github.com/szczyglis-dev/py-gpt   #
 # MIT License                                        #
 # Created By  : Marcin Szczygliński                  #
-# Updated Date: 2025.12.30 22:00:00                  #
+# Updated Date: 2025.12.31 16:00:00                  #
 # ================================================== #
 
 import base64
@@ -59,6 +59,7 @@ class Image:
         inline = extra.get("inline", False)
         sub_mode = self.MODE_GENERATE
         image_id = extra.get("image_id")  # previous image reference for remix
+        extra_prompt = extra.get("extra_prompt", "")
 
         # if attachments then switch mode to EDIT
         attachments = context.attachments
@@ -74,28 +75,29 @@ class Image:
             prompt_model = self.window.core.models.get(tmp_model)
 
         # worker
-        self.worker = ImageWorker()
-        self.worker.window = self.window
-        self.worker.client = self.window.core.api.openai.get_client()
-        self.worker.ctx = ctx
-        self.worker.mode = sub_mode  # mode can be "generate" or "edit"
-        self.worker.attachments = attachments  # attachments for edit mode
-        self.worker.raw = self.window.core.config.get('img_raw')
-        self.worker.model = model.id  # model ID for generate image, e.g. "dall-e-3"
-        self.worker.model_prompt = prompt_model  # model for generate prompt, not image!
-        self.worker.input_prompt = prompt
-        self.worker.system_prompt = self.window.core.prompt.get('img')
-        self.worker.num = num
-        self.worker.inline = inline
-        self.worker.image_id = image_id  # remix: previous image path/identifier
+        worker = ImageWorker()
+        worker.window = self.window
+        worker.client = self.window.core.api.openai.get_client()
+        worker.ctx = ctx
+        worker.mode = sub_mode  # mode can be "generate" or "edit"
+        worker.attachments = attachments  # attachments for edit mode
+        worker.raw = self.window.core.config.get('img_raw')
+        worker.model = model.id  # model ID for generate image, e.g. "dall-e-3"
+        worker.model_prompt = prompt_model  # model for generate prompt, not image!
+        worker.input_prompt = prompt
+        worker.system_prompt = self.window.core.prompt.get('img')
+        worker.num = num
+        worker.inline = inline
+        worker.extra_prompt = extra_prompt
+        worker.image_id = image_id  # remix: previous image path/identifier
 
         # config
         if self.window.core.config.has('img_quality'):
-            self.worker.quality = self.window.core.config.get('img_quality')
+            worker.quality = self.window.core.config.get('img_quality')
         if self.window.core.config.has('img_resolution'):
-            self.worker.resolution = self.window.core.config.get('img_resolution')
+            worker.resolution = self.window.core.config.get('img_resolution')
 
-        # signals
+        self.worker = worker
         self.worker.signals.finished.connect(self.window.core.image.handle_finished)
         self.worker.signals.finished_inline.connect(self.window.core.image.handle_finished_inline)
         self.worker.signals.status.connect(self.window.core.image.handle_status)
@@ -145,6 +147,7 @@ class ImageWorker(QRunnable):
         self.input_prompt: Optional[str] = None
         self.system_prompt = None
         self.inline = False
+        self.extra_prompt: Optional[str] = None
         self.num = 1
         self.image_id: Optional[str] = None  # previous image reference for remix
 
@@ -245,6 +248,13 @@ class ImageWorker(QRunnable):
                 self.signals.error.emit(e)
                 self.signals.status.emit(trans('img.status.prompt.error') + ": " + str(e))
 
+        # Fallback negative prompt injection (OpenAI Images API has no native negative_prompt field)
+        if self.extra_prompt and str(self.extra_prompt).strip():
+            try:
+                self.input_prompt = self._merge_negative_prompt(self.input_prompt or "", self.extra_prompt)
+            except Exception:
+                pass
+
         self.signals.status.emit(trans('img.status.generating') + ": {}...".format(self.input_prompt))
 
         paths: List[str] = []  # downloaded images paths
@@ -407,4 +417,17 @@ class ImageWorker(QRunnable):
             try:
                 sig.deleteLater()
             except RuntimeError:
-                pass
+                pass
+
+    # ---------- prompt utilities ----------
+
+    @staticmethod
+    def _merge_negative_prompt(prompt: str, negative: Optional[str]) -> str:
+        """
+        Append a negative prompt to the main text prompt for providers without a native negative_prompt field.
+        """
+        base = (prompt or "").strip()
+        neg = (negative or "").strip()
+        if not neg:
+            return base
+        return (base + ("\n" if base else "") + f"Negative prompt: {neg}").strip()

pygpt_net/provider/api/openai/video.py

@@ -6,7 +6,7 @@
 # GitHub:  https://github.com/szczyglis-dev/py-gpt   #
 # MIT License                                        #
 # Created By  : Marcin Szczygliński                  #
-# Updated Date: 2025.12.30 22:00:00                  #
+# Updated Date: 2025.12.31 16:00:00                  #
 # ================================================== #
 
 import datetime
@@ -60,6 +60,7 @@ class Video:
         num = int(extra.get("num", 1))
         inline = bool(extra.get("inline", False))
         video_id = extra.get("video_id")
+        extra_prompt = extra.get("extra_prompt", "")
 
         # decide sub-mode based on attachments (image-to-video when image is attached)
         sub_mode = self.MODE_GENERATE
@@ -86,6 +87,7 @@ class Video:
         worker.raw = self.window.core.config.get('img_raw')
         worker.num = num
         worker.inline = inline
+        worker.extra_prompt = extra_prompt
         worker.video_id = video_id
 
         # optional params (app-level options)
@@ -157,6 +159,7 @@ class VideoWorker(QRunnable):
         self.input_prompt = ""
         self.system_prompt = ""
         self.inline = False
+        self.extra_prompt: Optional[str] = None
         self.video_id = None
         self.raw = False
         self.num = 1
@@ -193,6 +196,14 @@ class VideoWorker(QRunnable):
                     self.signals.error.emit(e)
                     self.signals.status.emit(trans('vid.status.prompt.error') + ": " + str(e))
 
+            # Negative prompt fallback: inject constraints into the text prompt (Sora has no native negative_prompt field)
+            if self.extra_prompt and str(self.extra_prompt).strip():
+                try:
+                    self.input_prompt = self._merge_negative_prompt(self.input_prompt, self.extra_prompt)
+                except Exception:
+                    # do not fail generation if merge fails
+                    pass
+
             # Sora API accepts a single video per create call; honor app's num but cap to 1 per job
             _ = max(1, min(self.num, self.max_per_job))
 
@@ -609,4 +620,18 @@ class VideoWorker(QRunnable):
             except Exception:
                 pass
 
-        return " ".join(parts).strip()
+        return " ".join(parts).strip()
+
+    # ---------- prompt utilities ----------
+
+    @staticmethod
+    def _merge_negative_prompt(prompt: str, negative: Optional[str]) -> str:
+        """
+        Append a negative prompt to the main text prompt for providers without a native negative_prompt field.
+        """
+        base = (prompt or "").strip()
+        neg = (negative or "").strip()
+        if not neg:
+            return base
+        # Keep the user's original prompt intact and add clear constraint instructions.
+        return (base + ("\n" if base else "") + f"Negative prompt: {neg}").strip()

pygpt_net/provider/api/x_ai/image.py

@@ -6,7 +6,7 @@
 # GitHub:  https://github.com/szczyglis-dev/py-gpt   #
 # MIT License                                        #
 # Created By  : Marcin Szczygliński                  #
-# Updated Date: 2025.09.05 01:00:00                  #
+# Updated Date: 2025.12.31 16:00:00                  #
 # ================================================== #
 
 import base64
@@ -49,6 +49,7 @@ class Image:
         prompt = context.prompt
         num = int(extra.get("num", 1))
         inline = bool(extra.get("inline", False))
+        extra_prompt = extra.get("extra_prompt", "")
 
         # Optional prompt enhancement model (same as in your Google path)
         prompt_model = self.window.core.models.from_defaults()
@@ -66,6 +67,7 @@ class Image:
         worker.raw = self.window.core.config.get('img_raw')
         worker.num = num
         worker.inline = inline
+        worker.extra_prompt = extra_prompt
 
         self.worker = worker
         self.worker.signals.finished.connect(self.window.core.image.handle_finished)
@@ -102,6 +104,7 @@ class ImageWorker(QRunnable):
         self.input_prompt = ""
         self.system_prompt = ""
         self.inline = False
+        self.extra_prompt: Optional[str] = None
         self.raw = False
         self.num = 1
 
@@ -131,6 +134,13 @@ class ImageWorker(QRunnable):
                     self.signals.error.emit(e)
                     self.signals.status.emit(trans('img.status.prompt.error') + ": " + str(e))
 
+            # Negative prompt fallback: append as textual instruction (xAI has no native field for it)
+            if self.extra_prompt and str(self.extra_prompt).strip():
+                try:
+                    self.input_prompt = self._merge_negative_prompt(self.input_prompt or "", self.extra_prompt)
+                except Exception:
+                    pass
+
             self.signals.status.emit(trans('img.status.generating') + f": {self.input_prompt}...")
 
             cfg = self.window.core.config
@@ -205,4 +215,17 @@ class ImageWorker(QRunnable):
             try:
                 sig.deleteLater()
             except RuntimeError:
-                pass
+                pass
+
+    # ---------- prompt utilities ----------
+
+    @staticmethod
+    def _merge_negative_prompt(prompt: str, negative: Optional[str]) -> str:
+        """
+        Append a negative prompt to the main text prompt for providers without a native negative_prompt field.
+        """
+        base = (prompt or "").strip()
+        neg = (negative or "").strip()
+        if not neg:
+            return base
+        return (base + ("\n" if base else "") + f"Negative prompt: {neg}").strip()