Manifest reference
Asset fields
| Field | Type/default | Meaning |
|---|---|---|
prompt | string, required unless mirror | The subject wording wrapped by the selected style's prompt prefix and suffix. |
width / height | integer 16–8192 | Per-asset dimensions for generators that accept rectangular output. Provider limits may be lower. |
size | integer 16–8192 | Per-asset square size where the generator uses one dimension. |
file | string | Output path below the style's outDir; defaults to <category>/<assetId>.png. |
category | string | Optional output subdirectory and logical grouping. |
source | string | Manifest-relative committed art used instead of generation. For a set of PNG outputs (a frames animation, a tiles set) a path that is not a file is the stem of a hand edit laid beside the generated members (<stem>-<role>.png each); the set still generates. Mutually exclusive with revision. |
sourceByStyle | object | Per-style source, keyed by style id; wins over source for that style. Written by pixelkiln edit for a hand edit of an asset that is in several styles. |
remoteId | string | The provider's own id for art that already exists on the account, so adopt maps it without matching bytes: an object id, a character id, or <character id>#<animation group id>. Not part of the spec's identity. |
revision | object | Controlled image-to-image or inpaint dependency. See controlled revisions. |
state | object | character styles: a pose or outfit of another character asset. See Characters. |
animation | object | character styles: a loop of another character asset in one direction. See Characters. |
mirror | string | Another asset of the same style flipped left to right, made locally at no cost. See Mirrors. |
proportions | preset or object | character styles: this base's proportions, over the style's. |
reference | string or object | character styles, bases: the character's own south-facing sprite (or { "south": ..., "east": ... }), which PixelLab rotates instead of drawing from the prompt. See Characters. |
concept | string | character styles, pro bases: a manifest-relative concept image (up to 1024px) the design is seeded from. |
styleCharacter | string | character styles, pro bases: this base's style anchor, over the style's. |
providerInputs | JSON scalar/sequence map, {} | Named per-asset inputs consumed by the active provider. ComfyUI accepts scalars and, for frames, one ordered 2–64 value sequence. Image bindings upload PNG/JPEG inputs. |
styles | string array, [] | Restrict the asset to named styles; empty means every style. |
promptByStyle | string map, {} | Replace only the asset prompt for a named style. |
cell | [column,row] | The grid cell this asset owns in a mounted sheet; see stable-cell mounting. |
outputRole | string | Select one structural output when a generator returns a set. |
tags | string array, [] | Asset tags added to provider objects where supported. |
providerInputs is provider-owned and participates in generation identity.
Changing a value makes only that asset stale. A provider may replace a local
runtime path with a content hash before hashing the spec; unsupported providers
reject non-empty inputs rather than ignoring them.
Only a provider that declares a sequence contract may accept an array. ComfyUI
uses the array named by providerOptions.comfyui.frames.vary; other inputs stay
constant across the set.