layer 1.0.74__tar.gz → 1.0.77__tar.gz

{layer-1.0.74 → layer-1.0.77}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: layer
-Version: 1.0.74
+Version: 1.0.77
 Summary: Command-line interface for Layer — AI asset generation for game studios.
 Keywords: layer,ai,generative,game-development,cli
 Author: Layer

{layer-1.0.74 → layer-1.0.77}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "layer"
-version = "1.0.74"
+version = "1.0.77"
 description = "Command-line interface for Layer — AI asset generation for game studios."
 readme = "README.md"
 license = "Apache-2.0"

{layer-1.0.74 → layer-1.0.77}/pyproject.toml.orig

@@ -1,6 +1,6 @@
 [project]
 name = "layer"
-version = "1.0.74"
+version = "1.0.77"
 description = "Command-line interface for Layer — AI asset generation for game studios."
 readme = "README.md"
 authors = [{ name = "Layer", email = "info@layer.ai" }]

{layer-1.0.74 → layer-1.0.77}/src/layer/_api/models.py

@@ -489,6 +489,24 @@ class SegmentPartNames(RootModel[list[str]]):
     )
 
 
+class SegmentParts(RootModel[int]):
+    root: int = Field(
+        ...,
+        description="How many parts a CHARACTER split makes. Support varies by model.",
+        ge=1,
+        title="Segment Parts",
+    )
+
+
+class SegmentStrength(RootModel[int]):
+    root: int = Field(
+        ...,
+        description="How aggressively a mesh split cuts: higher makes more parts. Support varies by model.",
+        ge=1,
+        title="Segment Strength",
+    )
+
+
 class FaceLimit(RootModel[int]):
     root: int = Field(..., description="Face/polygon limit for 3D mesh.", gt=0, title="Face Limit")
 
@@ -820,7 +838,7 @@ class ForgeReferenceSetContribution(BaseModel):
     )
     palette_applied: bool | None = Field(
         False,
-        description="True when the set's color palette was appended to the prompt.",
+        description="True when the set's palette went into the run's color palette (up to the model's color limit), or a palette passed with the request stood in for it.",
         title="Palette Applied",
     )
     prompt_fallback_applied: bool | None = Field(
@@ -1033,6 +1051,7 @@ class InferenceUseCase(Enum):
     rig = "rig"
     segment = "segment"
     image_segment = "image_segment"
+    image_mask = "image_mask"
     text_to_speech = "text_to_speech"
     sound_effects = "sound_effects"
     music = "music"
@@ -1641,6 +1660,28 @@ class SegmentBy(Enum):
     PARTS = "PARTS"
 
 
+class SegmentLevel(Enum):
+    """
+    Split granularity for a general-target segmentation (more parts as it
+    rises). Only meaningful when the target is ``GENERAL``.
+    """
+
+    LOW = "LOW"
+    MEDIUM = "MEDIUM"
+    HIGH = "HIGH"
+
+
+class SegmentTarget(Enum):
+    """
+    What a mesh-segmentation model treats the input as, selecting its split
+    strategy. ``CHARACTER`` splits a humanoid mesh with a body-part template;
+    ``GENERAL`` splits any mesh by granularity level (e.g. Hi3D Parts).
+    """
+
+    CHARACTER = "CHARACTER"
+    GENERAL = "GENERAL"
+
+
 class Kind(Enum):
     """
     Whether the object is a single file or a composite asset.
@@ -3136,8 +3177,8 @@ class NineSliceMetadataView(BaseModel):
     """
     The insets a 9-slice draws a UI element by, in the image's own pixels in from each edge.
 
-    The corners are drawn at their own size, the edges stretch along their length, and the centre
-    stretches both ways.
+    The corners are drawn at their own size, the edges repeat along their length, and the centre
+    repeats both ways.
     """
 
     left: int = Field(..., description="Pixels in from the left edge.", title="Left")
@@ -4000,6 +4041,24 @@ class EstimateInferencePriceRequest(BaseModel):
         description="Parts to split along when segment_by is PARTS, at most 10.",
         title="Segment Part Names",
     )
+    segment_target: SegmentTarget | None = Field(
+        None,
+        description="What a mesh split treats the mesh as: CHARACTER, split by a body-part template, or GENERAL, split by segment_level. Support varies by model.",
+    )
+    segment_parts: SegmentParts | None = Field(
+        None,
+        description="How many parts a CHARACTER split makes. Support varies by model.",
+        title="Segment Parts",
+    )
+    segment_level: SegmentLevel | None = Field(
+        None,
+        description="How finely a GENERAL split cuts the mesh: LOW, MEDIUM or HIGH. Support varies by model.",
+    )
+    segment_strength: SegmentStrength | None = Field(
+        None,
+        description="How aggressively a mesh split cuts: higher makes more parts. Support varies by model.",
+        title="Segment Strength",
+    )
     quad_mesh: bool | None = Field(None, description="Generate quad mesh.", title="Quad Mesh")
     pbr_materials: bool | None = Field(None, description="Generate PBR materials.", title="Pbr Materials")
     low_poly: bool | None = Field(None, description="Generate low-poly mesh.", title="Low Poly")
@@ -4212,6 +4271,24 @@ class EstimateInferencePriceV2Request(BaseModel):
         description="Parts to split along when segment_by is PARTS, at most 10.",
         title="Segment Part Names",
     )
+    segment_target: SegmentTarget | None = Field(
+        None,
+        description="What a mesh split treats the mesh as: CHARACTER, split by a body-part template, or GENERAL, split by segment_level. Support varies by model.",
+    )
+    segment_parts: SegmentParts | None = Field(
+        None,
+        description="How many parts a CHARACTER split makes. Support varies by model.",
+        title="Segment Parts",
+    )
+    segment_level: SegmentLevel | None = Field(
+        None,
+        description="How finely a GENERAL split cuts the mesh: LOW, MEDIUM or HIGH. Support varies by model.",
+    )
+    segment_strength: SegmentStrength | None = Field(
+        None,
+        description="How aggressively a mesh split cuts: higher makes more parts. Support varies by model.",
+        title="Segment Strength",
+    )
     quad_mesh: bool | None = Field(None, description="Generate quad mesh.", title="Quad Mesh")
     pbr_materials: bool | None = Field(None, description="Generate PBR materials.", title="Pbr Materials")
     low_poly: bool | None = Field(None, description="Generate low-poly mesh.", title="Low Poly")
@@ -4404,7 +4481,7 @@ class EstimateInferencePriceV2Request(BaseModel):
     )
     nine_slice: bool | None = Field(
         None,
-        description="Deliver the image as a 9-slice UI element (a button, frame or panel that stretches): after everything else the run does, the plain band through its middle is found on each axis, the stretched regions are cleaned so nothing smears, and the insets are recorded as the file's `nineSlice` metadata. An image with no such band is delivered as drawn, without insets. Image outputs only.",
+        description="Deliver the image as a 9-slice UI element (a button, frame or panel that resizes): after everything else the run does, the plain band through its middle is found on each axis, the edges and centre are made to tile (painted texture kept, light evened out), and the insets are recorded as the file's `nineSlice` metadata. An image with no such band is delivered as drawn, without insets. Image outputs only.",
         title="Nine Slice",
     )
     parallax: ParallaxSplit | None = Field(
@@ -4413,7 +4490,7 @@ class EstimateInferencePriceV2Request(BaseModel):
     )
     color_palette: InferenceColorPalette | None = Field(
         None,
-        description="Colors the output should use: `colors`, each a `name` and a `#RRGGBB` `hex` (and an optional `role`), and optionally the `reference_set_id` they were picked from. The provider steers toward the hex values. Honored by the models whose capabilities report `max_palette_colors`, which is also the most colors a run takes; others ignore it.",
+        description="Colors the output should use: `colors`, each a `name` and a `#RRGGBB` `hex` (and an optional `role`), and optionally the `reference_set_id` they were picked from. The provider steers toward the hex values on the models whose capabilities report `max_palette_colors`, which is also the most colors a run takes there. Other models whose prompt describes how the output looks get the colors added to a non-empty prompt; models whose prompt is spoken, set into the output as text, a query, or a description of sound or motion, and text and audio models, ignore it.",
     )
     expression: str | None = Field(
         None,
@@ -4592,6 +4669,24 @@ class ExecuteInferenceRequest(BaseModel):
         description="Parts to split along when segment_by is PARTS, at most 10.",
         title="Segment Part Names",
     )
+    segment_target: SegmentTarget | None = Field(
+        None,
+        description="What a mesh split treats the mesh as: CHARACTER, split by a body-part template, or GENERAL, split by segment_level. Support varies by model.",
+    )
+    segment_parts: SegmentParts | None = Field(
+        None,
+        description="How many parts a CHARACTER split makes. Support varies by model.",
+        title="Segment Parts",
+    )
+    segment_level: SegmentLevel | None = Field(
+        None,
+        description="How finely a GENERAL split cuts the mesh: LOW, MEDIUM or HIGH. Support varies by model.",
+    )
+    segment_strength: SegmentStrength | None = Field(
+        None,
+        description="How aggressively a mesh split cuts: higher makes more parts. Support varies by model.",
+        title="Segment Strength",
+    )
     quad_mesh: bool | None = Field(None, description="Generate quad mesh.", title="Quad Mesh")
     pbr_materials: bool | None = Field(None, description="Generate PBR materials.", title="Pbr Materials")
     low_poly: bool | None = Field(None, description="Generate low-poly mesh.", title="Low Poly")
@@ -4803,6 +4898,24 @@ class ExecuteInferenceV2Request(BaseModel):
         description="Parts to split along when segment_by is PARTS, at most 10.",
         title="Segment Part Names",
     )
+    segment_target: SegmentTarget | None = Field(
+        None,
+        description="What a mesh split treats the mesh as: CHARACTER, split by a body-part template, or GENERAL, split by segment_level. Support varies by model.",
+    )
+    segment_parts: SegmentParts | None = Field(
+        None,
+        description="How many parts a CHARACTER split makes. Support varies by model.",
+        title="Segment Parts",
+    )
+    segment_level: SegmentLevel | None = Field(
+        None,
+        description="How finely a GENERAL split cuts the mesh: LOW, MEDIUM or HIGH. Support varies by model.",
+    )
+    segment_strength: SegmentStrength | None = Field(
+        None,
+        description="How aggressively a mesh split cuts: higher makes more parts. Support varies by model.",
+        title="Segment Strength",
+    )
     quad_mesh: bool | None = Field(None, description="Generate quad mesh.", title="Quad Mesh")
     pbr_materials: bool | None = Field(None, description="Generate PBR materials.", title="Pbr Materials")
     low_poly: bool | None = Field(None, description="Generate low-poly mesh.", title="Low Poly")
@@ -4995,7 +5108,7 @@ class ExecuteInferenceV2Request(BaseModel):
     )
     nine_slice: bool | None = Field(
         None,
-        description="Deliver the image as a 9-slice UI element (a button, frame or panel that stretches): after everything else the run does, the plain band through its middle is found on each axis, the stretched regions are cleaned so nothing smears, and the insets are recorded as the file's `nineSlice` metadata. An image with no such band is delivered as drawn, without insets. Image outputs only.",
+        description="Deliver the image as a 9-slice UI element (a button, frame or panel that resizes): after everything else the run does, the plain band through its middle is found on each axis, the edges and centre are made to tile (painted texture kept, light evened out), and the insets are recorded as the file's `nineSlice` metadata. An image with no such band is delivered as drawn, without insets. Image outputs only.",
         title="Nine Slice",
     )
     parallax: ParallaxSplit | None = Field(
@@ -5004,7 +5117,7 @@ class ExecuteInferenceV2Request(BaseModel):
     )
     color_palette: InferenceColorPalette | None = Field(
         None,
-        description="Colors the output should use: `colors`, each a `name` and a `#RRGGBB` `hex` (and an optional `role`), and optionally the `reference_set_id` they were picked from. The provider steers toward the hex values. Honored by the models whose capabilities report `max_palette_colors`, which is also the most colors a run takes; others ignore it.",
+        description="Colors the output should use: `colors`, each a `name` and a `#RRGGBB` `hex` (and an optional `role`), and optionally the `reference_set_id` they were picked from. The provider steers toward the hex values on the models whose capabilities report `max_palette_colors`, which is also the most colors a run takes there. Other models whose prompt describes how the output looks get the colors added to a non-empty prompt; models whose prompt is spoken, set into the output as text, a query, or a description of sound or motion, and text and audio models, ignore it.",
     )
     expression: str | None = Field(
         None,