changedInput schema / properties / idempotencyKey / description
Previous value: -"Caller-chosen key. Replaying it with IDENTICAL input returns the EXISTING job instead of queueing a second one — a restarted driver adopts its own in-flight work rather than duplicating or orphaning it. Vary the key to force a new job. Full semantics: the same key with DIFFERENT input is rejected with IDEMPOTENCY_CONFLICT (never silently replayed, so a stale result cannot be mistaken for a fresh one). A key is recorded only once a job is actually created, so a request rejected beforehand (validation, APPROVAL_REQUIRED, quota) leaves the key unused and free to reuse. A key bound to a job keeps resolving to that job even after it fails or is cancelled — use a NEW key to genuinely retry cancelled work. Keys live 48 hours and are scoped per principal+deployment+operation, which means they SPAN SESSIONS: a plain descriptive key like \"hero-final-1024-v1\" will collide with your own run from yesterday and be rejected. Include a project id or a timestamp. This scope used to be stated only in the conflict error, i.e. after the round trip it cost — a field build lost two that way, ~34 hours after unrelated work had taken the same names."New value: +"Stable caller-chosen key for this request. Reuse the same key and arguments for safe retries; change the key when changing inputs."
addedInput schema / properties / materialName / description
Added value: +"Name for the prepared material/package, 1-64 characters; default Image Material."
addedInput schema / properties / options / description
Added value: +"Optional processing and material settings. Supplied maps take precedence over fallback generation; a reused texture job preserves its appearance settings unless overridden."
addedInput schema / properties / options / properties / alphaCutoff / description
Added value: +"Mask-mode alpha threshold, 0-1; default 0.5. Ignored by opaque/blend modes."
addedInput schema / properties / options / properties / alphaMode / description
Added value: +"Material opacity behavior. Default opaque, or blend for decal profile; delivered PNG alpha is preserved regardless."
addedInput schema / properties / options / properties / displacementMode / description
Added value: +"How the material uses height: none (default), shader bump, or displacement. A height map must be available; renderer/export support varies."
addedInput schema / properties / options / properties / emissionStrength / description
Added value: +"Material emission multiplier, 0-10000; default 1 when emission is requested, otherwise 0. Requires an emission output to light the material."
addedInput schema / properties / options / properties / heightMidlevel / description
Added value: +"Height value representing zero displacement, 0-1; default 0.5."
addedInput schema / properties / options / properties / heightScale / description
Added value: +"Relief height in meters, 0-1; default 0.001. Used for height-derived normals and material bump/displacement."
addedInput schema / properties / options / properties / heightSource / description
Added value: +"If no height map is supplied, explicitly allow height estimation from base_color luminance or alpha. Default none; estimated relief is labeled heuristic."
addedInput schema / properties / options / properties / maxSize / description
Added value: +"Maximum output side in pixels, 8-4096; default 2048. Sources are aligned at their common aspect ratio without upscaling."
addedInput schema / properties / options / properties / metallic / description
Added value: +"Constant metallic fallback, 0-1; default 0. Supplied metallic maps take precedence; brightness does not establish metalness."
addedInput schema / properties / options / properties / normalConvention / description
Added value: +"Convention of supplied normal maps: OpenGL +Y (default) or DirectX -Y. A change to output convention flips the green channel."
addedInput schema / properties / options / properties / normalStrength / description
Added value: +"Normal intensity multiplier, 0-16; default 1. Applied when converting supplied vectors or deriving normals from height."
addedInput schema / properties / options / properties / outputNormalConvention / description
Added value: +"Convention for delivered normal maps, OpenGL +Y by default or DirectX -Y; the Blender material compensates for the output convention."
addedInput schema / properties / options / properties / packing / description
Added value: +"Optional extra packed PNG: ORM uses red=ambient occlusion, green=roughness, blue=metallic; default none. Missing AO uses a documented white fallback."
addedInput schema / properties / options / properties / physicalCoverageMeters / description
Added value: +"Real dimensions of one UV tile for height-to-normal scaling. If omitted, derived relief normals assume a one-meter UV square."
addedInput schema / properties / options / properties / physicalCoverageMeters / properties / height / description
Added value: +"Physical height in meters represented by one complete texture tile; positive, at most 100000."
addedInput schema / properties / options / properties / physicalCoverageMeters / properties / width / description
Added value: +"Physical width in meters represented by one complete texture tile; positive, at most 100000."
addedInput schema / properties / options / properties / roughness / description
Added value: +"Constant roughness fallback, 0-1; default 0.65. A supplied roughness map or converted gloss map takes precedence."
addedInput schema / properties / options / properties / roughnessMode / description
Added value: +"Fallback roughness generation: constant (default) or an explicitly requested base_color brightness estimate. Image-derived roughness is heuristic, not measured."
addedInput schema / properties / options / properties / roughnessRange / description
Added value: +"[minimum, maximum] roughness for image estimates, increasing within 0-1; default [0.35, 0.85]."
addedInput schema / properties / options / properties / seamMode / description
Added value: +"Analyze edges only (default) or blend edge pixels along tile axes. Blending changes imagery and may cause ghosting; inspect the repeat preview."
addedInput schema / properties / options / properties / specular / description
Added value: +"Constant specular fallback, 0-1; default 0.5. Supplied specular maps take precedence."
addedInput schema / properties / options / properties / tile / description
Added value: +"Texture axes to treat as periodic for relief and seam handling; default none. Does not guarantee perceptually seamless repetition."
addedInput schema / properties / profile / description
Added value: +"Processing intent: surface or supplied defaults a single sourceAssetId to base_color/roughness with opaque alpha; decal to base_color/opacity with blend alpha. Role-labeled map sets default to their supplied roles. Explicit roles/options override these defaults."
addedInput schema / properties / projectId / description
Added value: +"Existing project in the bound deployment; owns the processing job and its artifacts."
addedInput schema / properties / roles / description
Added value: +"Unique output roles to deliver. With sourceAssetId, defaults include profile convenience maps; with supplied maps or a completed texture job, defaults to its supplied roles. Unsupported missing maps fail rather than being invented."
addedInput schema / properties / roles / items / description
Added value: +"Semantic map role; use one source per role. Color maps and scalar/vector data maps are interpreted differently."
addedInput schema / properties / sourceAssetId / description
Added value: +"Validated PNG/JPEG asset supplying base_color. Do not also supply a base_color entry in sourceMaps or combine with textureJobId."
addedInput schema / properties / sourceMaps / description
Added value: +"Role-labeled validated images or texture artifacts, one per role and at most 12 unique images. Sources must share an aspect ratio. Do not combine with textureJobId."
addedInput schema / properties / sourceMaps / items / properties / channel / description
Added value: +"Channel to extract for a scalar map, for example g for roughness from ORM. Omit for RGB color or normal maps; normal maps reject channel selection."
addedInput schema / properties / sourceMaps / items / properties / colorSpace / description
Added value: +"Input interpretation: auto uses the map role, srgb is encoded color, linear is linear color, and data bypasses color conversion for numeric maps."
addedInput schema / properties / sourceMaps / items / properties / invert / description
Added value: +"Invert scalar values or RGB channels (1 - value), preserving alpha. Omit or false to keep them; use normalConvention for normal-map green-channel conversion."
addedInput schema / properties / sourceMaps / items / properties / role / description
Added value: +"Semantic map role; use one source per role. Color maps and scalar/vector data maps are interpreted differently."
addedInput schema / properties / sourceMaps / items / properties / sourceId / description
Added value: +"Validated PNG/JPEG asset ID (ast_…) or completed texture_map PNG artifact ID (art_…); not a file path or URL."