Brand Signals

uvoo extracts 58+ structured signals from each asset. These signals form the brand knowledge graph and are the source of all prompt generation, brand queries, and guideline checking. Below is the complete reference.

Color signals

SignalTypeDescription
palette_cielabarray[5]Top 5 dominant colors in CIELAB L*a*b* format
palette_hexarray[5]Same palette converted to sRGB hex
color_temperaturenumberEstimated color temp in Kelvin (2700K–8000K)
warmth_ratio0–1Proportion of warm vs. cool pixels
saturation_mean0–1Mean HSV saturation across image
saturation_variancenumberSaturation spread — high = colorful, low = muted
lightness_mean0–100Mean CIELAB L* (perceptual lightness)
contrast_rationumberMichelson contrast of the image
color_harmonyenumDominant harmony: analogous / complementary / monochromatic / triadic

Composition signals

SignalTypeDescription
subject_placementenumcenter / rule-of-thirds / edge / distributed
fill_ratio0–1Fraction of frame occupied by primary subject
negative_space_ratio0–1Fraction of frame that is background/space
aspect_ratiostringDetected crop ratio (1:1, 4:3, 16:9, 9:16, etc.)
horizon_line0–1 or nullVertical position of horizon, if present
symmetry_score0–1Bilateral symmetry — 1 = perfectly symmetric
depth_of_fieldenumshallow / medium / deep
foreground_complexity0–1Edge density in foreground region

Lighting signals

SignalTypeDescription
lighting_typeenumnatural / studio / mixed / artificial
lighting_directionenumfront / side / back / top / diffused
lighting_hardness0–10 = soft/diffused, 1 = hard directional
shadow_presencebooleanVisible cast shadows detected
shadow_softness0–1Edge sharpness of detected shadows
highlight_clippingbooleanBlown-out highlight regions present
exposure_valuenumberEstimated EV relative to 18% grey

Semantic / mood signals

SignalTypeDescription
ram_tagsarray[string]All RAM++ semantic tags, sorted by confidence
mood_clusterarray[string]Top 5 mood/atmosphere tags
content_typeenumproduct / lifestyle / campaign / portrait / scene / abstract
human_presencebooleanHuman figure detected
face_visibilityenumfull / partial / none
product_visibilityenumhero / secondary / none
settingenumindoor / outdoor / studio / abstract

Texture signals

SignalTypeDescription
grain_level0–1Film/digital grain presence
surface_smoothness0–1Dominant surface texture — 1 = polished/smooth
texture_richness0–1Overall tactile complexity of the scene
material_tagsarray[string]Detected materials: ceramic, linen, wood, glass, etc.

Embedding

SignalTypeDescription
siglip_embeddingfloat[768]SigLIP 2 (ViT-B-16-SigLIP-384) visual embedding vector
brand_similarity_score0–1Cosine similarity to brand centroid embedding
outlier_flagbooleanTrue if similarity score < brand mean − 1.5σ

All signals are available via the API on a per-asset and per-brand-aggregate basis.