novelai-python 0.7.0__tar.gz → 0.7.2__tar.gz

{novelai_python-0.7.0 → novelai_python-0.7.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: novelai-python
-Version: 0.7.0
+Version: 0.7.2
 Summary: NovelAI Python Binding With Pydantic
 Author-Email: sudoskys <coldlando@hotmail.com>
 License: Apache License 2.0

{novelai_python-0.7.0 → novelai_python-0.7.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "novelai-python"
-version = "0.7.0"
+version = "0.7.2"
 description = "NovelAI Python Binding With Pydantic"
 authors = [
     { name = "sudoskys", email = "coldlando@hotmail.com" },

{novelai_python-0.7.0 → novelai_python-0.7.2}/src/novelai_python/sdk/ai/_enum.py

@@ -361,6 +361,7 @@ def get_default_noise_schedule(sample_type: Sampler) -> NoiseSchedule:
 
 
 def get_model_group(model: ModelTypeAlias) -> ModelGroups:
+    # 一般情况禁止转换
     if isinstance(model, Enum):
         model = model.value
     else:
@@ -387,49 +388,89 @@ def get_model_group(model: ModelTypeAlias) -> ModelGroups:
     return mapping.get(model, ModelGroups.STABLE_DIFFUSION)
 
 
-def get_default_uc_preset(model: ModelTypeAlias, uc_preset: int) -> str:
-    if isinstance(model, Enum):
-        model = model.value
-    if isinstance(uc_preset, Enum):
-        uc_preset = uc_preset.value
+@dataclass
+class UcPrompt:
+    category: str
+    name: str
+    text: str
 
-    @dataclass
-    class UcPrompt:
-        label: str
-        text: str
 
-    mapper = {
-        ModelGroups.STABLE_DIFFUSION: [
-            UcPrompt("lowQualityPlusBadAnatomy",
+def get_uc_preset(model: ModelTypeAlias) -> List[UcPrompt]:
+    prompts: List[UcPrompt] = []
+    if model in [
+        Model.SAFE_DIFFUSION,
+        Model.NAI_DIFFUSION,
+        Model.NAI_DIFFUSION_INPAINTING,
+        Model.SAFE_DIFFUSION_INPAINTING,
+    ]:
+        prompts = [
+            UcPrompt(category="heavy", name="lowQualityPlusBadAnatomy",
                      text="lowres, bad anatomy, bad hands, text, error, missing fingers, extra digit, fewer digits, cropped, worst quality, low quality, normal quality, jpeg artifacts, signature, watermark, username, blurry"),
-            UcPrompt("lowQuality",
+            UcPrompt(category="light", name="lowQuality",
                      text="lowres, text, cropped, worst quality, low quality, normal quality, jpeg artifacts, signature, watermark, username, blurry"),
-            UcPrompt("none", text="lowres")
-        ],
-        ModelGroups.STABLE_DIFFUSION_GROUP_2: [
-            UcPrompt("heavy",
+            UcPrompt(category="none", name="none", text="lowres"),
+        ]
+    elif model in [
+        Model.NAI_DIFFUSION_FURRY,
+        Model.FURRY_DIFFUSION_INPAINTING,
+    ]:
+        prompts = [
+            UcPrompt(category="light", name="lowQuality",
+                     text="worst quality, low quality, what has science done, what, nightmare fuel, eldritch horror, where is your god now, why"),
+            UcPrompt(category="heavy", name="badAnatomy",
+                     text="{worst quality}, low quality, distracting watermark, [nightmare fuel], {{unfinished}}, deformed, outline, pattern, simple background"),
+            UcPrompt(category="none", name="none", text="low res"),
+        ]
+    elif model in [
+        Model.NAI_DIFFUSION_2,
+    ]:
+        prompts = [
+            UcPrompt(category="heavy", name="heavy",
                      text="lowres, bad, text, error, missing, extra, fewer, cropped, jpeg artifacts, worst quality, bad quality, watermark, displeasing, unfinished, chromatic aberration, scan, scan artifacts"),
-            UcPrompt("light", text="lowres, jpeg artifacts, worst quality, watermark, blurry, very displeasing"),
-            UcPrompt("none", text="lowres")
-        ],
-        ModelGroups.STABLE_DIFFUSION_XL: [
-            UcPrompt("heavy",
+            UcPrompt(category="light", name="light",
+                     text="lowres, jpeg artifacts, worst quality, watermark, blurry, very displeasing"),
+            UcPrompt(category="none", name="none", text="lowres"),
+        ]
+    elif model in [
+        Model.NAI_DIFFUSION_3,
+        Model.NAI_DIFFUSION_3_INPAINTING,
+    ]:
+        prompts = [
+            UcPrompt(category="heavy", name="heavy",
                      text="lowres, {bad}, error, fewer, extra, missing, worst quality, jpeg artifacts, bad quality, watermark, unfinished, displeasing, chromatic aberration, signature, extra digits, artistic error, username, scan, [abstract]"),
-            UcPrompt("light", text="lowres, jpeg artifacts, worst quality, watermark, blurry, very displeasing"),
-            UcPrompt("humanFocus",
+            UcPrompt(category="light", name="light",
+                     text="lowres, jpeg artifacts, worst quality, watermark, blurry, very displeasing"),
+            UcPrompt(category="human", name="humanFocus",
                      text="lowres, {bad}, error, fewer, extra, missing, worst quality, jpeg artifacts, bad quality, watermark, unfinished, displeasing, chromatic aberration, signature, extra digits, artistic error, username, scan, [abstract], bad anatomy, bad hands, @_@, mismatched pupils, heart-shaped pupils, glowing eyes"),
-            UcPrompt("none", text="lowres")
-        ],
-        ModelGroups.STABLE_DIFFUSION_XL_FURRY: [
-            UcPrompt("heavy",
+            UcPrompt(category="none", name="none", text="lowres"),
+        ]
+    elif model in [
+        Model.NAI_DIFFUSION_FURRY_3,
+        Model.NAI_DIFFUSION_FURRY_3_INPAINTING,
+    ]:
+        prompts = [
+            UcPrompt(category="heavy", name="heavy",
                      text="{{worst quality}}, [displeasing], {unusual pupils}, guide lines, {{unfinished}}, {bad}, url, artist name, {{tall image}}, mosaic, {sketch page}, comic panel, impact (font), [dated], {logo}, ych, {what}, {where is your god now}, {distorted text}, repeated text, {floating head}, {1994}, {widescreen}, absolutely everyone, sequence, {compression artifacts}, hard translated, {cropped}, {commissioner name}, unknown text, high contrast"),
-            UcPrompt("light",
+            UcPrompt(category="light", name="light",
                      text="{worst quality}, guide lines, unfinished, bad, url, tall image, widescreen, compression artifacts, unknown text"),
-            UcPrompt("none", text="lowres")
-        ],
-    }
-    model_group = get_model_group(model)
-    prompts: List[UcPrompt] = mapper.get(model_group, [UcPrompt("none", "lowres")])
+            UcPrompt(category="none", name="none", text="lowres"),
+        ]
+    elif model in [
+        Model.CUSTOM,
+        Model.NAI_DIFFUSION_4_CURATED_PREVIEW,
+    ]:
+        prompts = [
+            UcPrompt(category="heavy", name="heavy",
+                     text="blurry, lowres, error, film grain, scan artifacts, worst quality, bad quality, jpeg artifacts, very displeasing, chromatic aberration, logo, dated, signature, multiple views, gigantic breasts"),
+            UcPrompt(category="light", name="light",
+                     text="blurry, lowres, error, worst quality, bad quality, jpeg artifacts, very displeasing, logo, dated, signature"),
+            UcPrompt(category="none", name="none", text=""),
+        ]
+    return prompts
+
+
+def get_default_uc_preset(model: ModelTypeAlias, uc_preset: int) -> str:
+    prompts = get_uc_preset(model)
     if 0 <= uc_preset < len(prompts):
         return prompts[uc_preset].text
     else:

{novelai_python-0.7.0 → novelai_python-0.7.2}/src/novelai_python/sdk/ai/generate_image/__init__.py

@@ -6,7 +6,9 @@ import base64
 import json
 import math
 import random
+import re
 from copy import deepcopy
+from enum import Enum
 from io import BytesIO
 from typing import Optional, Union, Tuple, List
 from urllib.parse import urlparse
@@ -28,7 +30,7 @@ from novelai_python.sdk.ai._enum import Model, Sampler, NoiseSchedule, ControlNe
     INPAINTING_MODEL_LIST, get_default_uc_preset, \
     ModelTypeAlias, UCPresetTypeAlias, get_default_noise_schedule, get_supported_noise_schedule, \
     get_model_group, ModelGroups, get_supported_params, get_modifiers, ImageBytesTypeAlias
-from .schema import Character, V4Prompt, V4NegativePrompt
+from .schema import Character, V4Prompt, V4NegativePrompt, PositionMap
 from ...schema import ApiBaseModel
 from ...._exceptions import APIError, AuthError, ConcurrentGenerationError, SessionHttpError
 from ...._response.ai.generate_image import ImageGenerateResp, RequestParams
@@ -110,7 +112,7 @@ class Params(BaseModel):
     Overlay Original Image.Prevents the existing image from changing,
     but can introduce seams along the edge of the mask.
     """
-    use_coords: bool = Field(True, description="Use Coordinates")
+    use_coords: bool = Field(False, description="Use Coordinates")
     """Use Coordinates"""
     characterPrompts: List[Character] = Field(default_factory=list)
     """Character Prompts"""
@@ -342,6 +344,35 @@ class Params(BaseModel):
 
 class GenerateImageInfer(ApiBaseModel):
     _endpoint: str = PrivateAttr("https://image.novelai.net")
+    _mutual_exclusion: bool = PrivateAttr(False)
+    """Positive words and negative words are mutually exclusive, and conflicting negative words are deleted first."""
+    _quality_modifier: bool = PrivateAttr(True)
+    """Add Quality Modifier To Input"""
+
+    def set_mutual_exclusion(self, value: bool):
+        """
+        **Enable This will modify the negative prompt.**
+        Default is False.
+
+        Positive words and negative words are mutually exclusive, and conflicting negative words are deleted first.
+        :param value: bool
+        :return: self
+        """
+        self._mutual_exclusion = bool(value)
+        return self
+
+    def set_quality_modifier(self, value: bool):
+        """
+        **Enable This will modify the input prompt.**
+        Default is True.
+
+        Add Quality Modifier To Input.
+        Whether to add the quality vocabulary used by the web application.
+        :param value:
+        :return:
+        """
+        self._quality_modifier = bool(value)
+        return self
 
     @property
     def endpoint(self):
@@ -371,15 +402,75 @@ class GenerateImageInfer(ApiBaseModel):
 
         # Add negative prompt based on ucPreset
         if self.parameters.ucPreset is not None:
-            default_negative_prompt = get_default_uc_preset(self.model, self.parameters.ucPreset)
+            uc_preset = self.parameters.ucPreset
+            # If ucPreset is Enum, get the value
+            if isinstance(self.parameters.ucPreset, Enum):
+                uc_preset = self.parameters.ucPreset.value
+            default_negative_prompt = get_default_uc_preset(self.model, uc_preset)
             self.parameters.negative_prompt = ", ".join(
                 filter(None, [default_negative_prompt, self.parameters.negative_prompt])
             )
 
-        # Add quality prompt
+        # Add quality prompt based on qualityToggle
         modifier = get_modifiers(self.model)
-        if self.parameters.qualityToggle:
-            self.input += modifier.qualityTags
+        quality_tags, suffix = modifier.qualityTags, modifier.suffix
+
+        def enhance_text_part(_part, _quality_tags, _suffix):
+            text_parts = _part.split(" Text:")
+            enhanced_text_parts = [
+                _quality_tags + text_part + _suffix + ('.' if _suffix and len(text_parts) > 1 else '')
+                if index == 0
+                else text_part
+                for index, text_part in enumerate(text_parts)
+            ]
+            return " Text:".join(enhanced_text_parts)
+
+        def enhance_simple_part(_part, _quality_tags, _suffix):
+            match = re.search(r"(:[\d.]+$)", _part)
+            matched_value = match.group(0) if match else None
+            core_part = _part[:-len(matched_value)] if matched_value else _part
+            return _quality_tags + core_part + _suffix + (matched_value or "")
+
+        def enhance_message(_prompt):
+            try:
+                if get_supported_params(self.model).characterPrompts:
+                    parts = _prompt.split("|")
+                    enhanced_parts = [
+                        quality_tags + part + suffix
+                        if index == 0 and not get_supported_params(self.model).text
+                        else enhance_text_part(part, quality_tags, suffix)
+                        if index == 0
+                        else part
+                        for index, part in enumerate(parts)
+                    ]
+                    return "|".join(enhanced_parts)
+                else:
+                    parts = _prompt.split("|")
+                    enhanced_parts = [
+                        enhance_simple_part(part, quality_tags, suffix)
+                        for part in parts
+                    ]
+                    return "|".join(enhanced_parts)
+            except Exception as e:
+                logger.error(
+                    f"Failed to enhance `{_prompt}` because {e},"
+                    f"Report this issue to https://github.com/LLMKIRA/novelai-python/issues"
+                )
+                return _prompt
+
+        if self._quality_modifier:
+            logger.trace("Enhancing input with quality modifier, will modify input prompt.")
+            self.input = enhance_message(self.input)
+
+        if self._mutual_exclusion:
+            logger.trace("Mutual exclusion is enabled, will modify negative prompt.")
+            input_prompt = {x.strip(): x for x in self.input.split(",")}
+            uc_prompt = {x.strip(): x for x in self.parameters.negative_prompt.split(",")}
+            # Remove conflicting negative words
+            for key in input_prompt:
+                if key in uc_prompt:
+                    uc_prompt.pop(key)
+            self.parameters.negative_prompt = ",".join(uc_prompt.values())
 
     @model_validator(mode="after")
     def _build_nai4_prompt(self):
@@ -417,7 +508,9 @@ class GenerateImageInfer(ApiBaseModel):
     @model_validator(mode="after")
     def _backend_logic(self):
         """
-        Backend logic for GenerateImageInfer.
+        Calibration results.
+
+        **NOTE: It is forbidden to write logic that does not belong to novelai.net here**
         :return: self
         """
         if self.action == Action.GENERATE:
@@ -464,7 +557,30 @@ class GenerateImageInfer(ApiBaseModel):
             self.parameters.sm_dyn = True
 
         if self.parameters.sm_dyn and (not self.parameters.sm):
-            self.parameters.sm_dyn = False
+            self.parameters.sm = True
+
+        # AUTO SMEA SETTING
+        """
+        def sm_size_cast(model: Model):
+            if model in [
+                Model.NAI_DIFFUSION_V3,
+                Model.NAI_DIFFUSION_V3_INPAINTING,
+                Model.NAI_DIFFUSION_FURRY_V3,
+                Model.NAI_DIFFUSION_FURRY_V3_INPAINTING,
+                Model.CUSTOM
+            ]:
+                return 2166785
+            return 1064961
+        if self.parameters.autoSmea and (self.parameters.width * self.parameters.height < sm_size_cast(self.model)):
+            self.parameters.autoSmea = False
+        """
+
+        if self.parameters.characterPrompts:
+            self.parameters.use_coords = any([c.center != PositionMap.AUTO for c in self.parameters.characterPrompts])
+
+        # Mix Prompt Warning
+        if self.input.count('|') > 6:
+            logger.warning("Maximum prompt mixes exceeded. Extra will be ignored.")
 
         if self.parameters.sampler in [
             Sampler.DDIM,
@@ -572,7 +688,6 @@ class GenerateImageInfer(ApiBaseModel):
             prompt: str,
             *,
             model: Union[Model, str],
-            qualitySuffix: bool = True,
             negative_prompt: str = "",
             ucPreset: UCPresetTypeAlias = UCPreset.TYPE0,
             sm: bool = False,
@@ -602,7 +717,6 @@ class GenerateImageInfer(ApiBaseModel):
         :param prompt: Given prompt.
         :param model: Model for generation.
         :param negative_prompt: The things you don't want to see in the image.
-        :param qualitySuffix: Add quality suffix to prompt
         :param ucPreset: The negative prompt preset.
         :param steps: The steps for generation.
         :param seed: The seed for generation.
@@ -619,9 +733,6 @@ class GenerateImageInfer(ApiBaseModel):
         """
         if character_prompts is None:
             character_prompts = []
-        if qualitySuffix:
-            modifier = get_modifiers(model)
-            prompt += modifier.suffix
         if seed is None:
             seed = random.randint(0, 4294967295 - 7)
         if reference_strength_multiple is None:
@@ -668,7 +779,6 @@ class GenerateImageInfer(ApiBaseModel):
             seed: int = None,
             extra_noise_seed: int = None,
             model: Union[Model, str] = Model.NAI_DIFFUSION_3,
-            qualitySuffix: bool = True,
             negative_prompt: str = "",
             ucPreset: UCPresetTypeAlias = UCPreset.TYPE0,
             steps: int = 23,
@@ -699,7 +809,6 @@ class GenerateImageInfer(ApiBaseModel):
         :param prompt: Given prompt.
         :param model: Model for generation.
         :param negative_prompt: The things you don't want to see in the image.
-        :param qualitySuffix: Add quality suffix to prompt
         :param ucPreset: The negative prompt preset.
         :param steps: The steps for generation.
         :param seed: The seed for generation.
@@ -716,9 +825,6 @@ class GenerateImageInfer(ApiBaseModel):
         """
         if character_prompts is None:
             character_prompts = []
-        if qualitySuffix:
-            modifier = get_modifiers(model)
-            prompt += modifier.suffix
         if seed is None:
             seed = random.randint(0, 4294967295 - 7)
         if extra_noise_seed is None:
@@ -768,7 +874,6 @@ class GenerateImageInfer(ApiBaseModel):
             mask: Union[bytes, str],
             strength: float = 0.7,
             model: Union[Model, str] = Model.NAI_DIFFUSION_3,
-            qualitySuffix: bool = True,
             negative_prompt: str = "",
             ucPreset: UCPresetTypeAlias = UCPreset.TYPE0,
             steps: int = 23,
@@ -799,7 +904,6 @@ class GenerateImageInfer(ApiBaseModel):
         :param prompt: Given prompt.
         :param model: Model for generation.
         :param negative_prompt: The things you don't want to see in the image.
-        :param qualitySuffix: Add quality suffix to prompt
         :param ucPreset: The negative prompt preset.
         :param steps: The steps for generation.
         :param seed: The seed for generation.
@@ -816,9 +920,6 @@ class GenerateImageInfer(ApiBaseModel):
         """
         if character_prompts is None:
             character_prompts = []
-        if qualitySuffix:
-            modifier = get_modifiers(model)
-            prompt += modifier.suffix
         if seed is None:
             seed = random.randint(0, 4294967295 - 7)
         if reference_strength_multiple is None:
@@ -891,7 +992,9 @@ class GenerateImageInfer(ApiBaseModel):
                       override_headers: Optional[dict] = None,
                       ) -> ImageGenerateResp:
         """
-        Generate images using NovelAI's diffusion models. According to our Terms of Service, all generation requests must be initiated by a human action. Automating text or image generation to create excessive load on our systems is not allowed.
+        **Generate images using NovelAI's diffusion models.**
+
+        According to our Terms of Service, all generation requests must be initiated by a human action. Automating text or image generation to create excessive load on our systems is not allowed.
 
         :param override_headers: the headers to override
         :param session:  session

{novelai_python-0.7.0 → novelai_python-0.7.2}/tests/test_random_prompt.py

@@ -58,4 +58,4 @@ def test_get_holiday_themed_tags():
     result_m = generator.get_holiday_themed_tags()
     result_f = generator.get_holiday_themed_tags()
     result_o = generator.get_holiday_themed_tags()
-    assert result_m != result_f != result_o
+    assert len({result_m, result_f, result_o}) != 1