Skip to main content

MaterialMultipartInput

Material fields as multipart/form-data. material[parameters] and material[metadata] are JSON-encoded strings. Map slots take image files; only the slots sent are replaced on update.

material[name]string

Required on create.

material[visibility]string

Possible values: [private, organization, unlisted, public]

material[organization_id]string
material[y_flip]boolean
material[normal_convention]string

Possible values: [opengl, directx]

material[parameters]string

JSON object, see MaterialParameters.

Example: {"roughnessFactor":0.8,"metallicFactor":0}
material[metadata]string

JSON object.

material[color_map]string<binary>

Base colour (sRGB).

material[opacity_map]string<binary>

Alpha (linear, grey); becomes the base_color alpha.

material[normal_map]string<binary>

Tangent-space normal (linear).

material[orm_map]string<binary>

Packed R=occlusion G=roughness B=metalness.

material[occlusion_map]string<binary>

Ambient occlusion (linear, grey).

material[roughness_map]string<binary>

Roughness (linear, grey).

material[metalness_map]string<binary>

Metalness (linear, grey).

material[emissive_map]string<binary>

Emission (sRGB).

material[displacement_map]string<binary>

Surface height (linear, grey).

material[sky_map]string<binary>

Equirectangular sky panorama; makes it a sky material.

material[splat_map]string<binary>

Terrain splat map (no runtime texture).

material[height_map]string<binary>

Terrain elevation packed as r * 255 + b, green 255 (no runtime texture; served as lossless WebP).

MaterialMultipartInput
{
  "material[name]": "string",
  "material[visibility]": "private",
  "material[organization_id]": "string",
  "material[y_flip]": true,
  "material[normal_convention]": "opengl",
  "material[parameters]": "{\"roughnessFactor\":0.8,\"metallicFactor\":0}",
  "material[metadata]": "string",
  "material[color_map]": "string",
  "material[opacity_map]": "string",
  "material[normal_map]": "string",
  "material[orm_map]": "string",
  "material[occlusion_map]": "string",
  "material[roughness_map]": "string",
  "material[metalness_map]": "string",
  "material[emissive_map]": "string",
  "material[displacement_map]": "string",
  "material[sky_map]": "string",
  "material[splat_map]": "string",
  "material[height_map]": "string"
}