VNTANA icon

VNTANA

Interact with VNTANA 3D content management platform

Actions16

Product → Upload 3D Model

AI-generated

Summary

Creates a new VNTANA product from a 3D model file in an input binary property, uploads the file via a signed storage URL, and queues it for conversion/optimization using a chosen preset or custom settings.

Inputs

  • Name (required) — Name of the new product.
  • Pipeline UUID (required) — UUID of the optimization pipeline. Get it with Pipeline → List.
  • Workspace UUID (required) — Target workspace. If left empty, falls back to the default workspace UUID in credentials; errors if neither is set.
  • Binary Property (required) — Name of the input binary property holding the 3D model (default 'data'). The file name is sanitized and an extension is added from the binary metadata or MIME type if missing.
  • Optimization Mode — 'Preset' (default) or 'Advanced'.
  • Optimization Preset — Shown in Preset mode: Web Optimized (50K polys, 2048 textures, Draco), High Quality (100K polys, 4096 textures, no Draco), Mobile (25K polys, 1024 textures), or Preserve Original (format conversion only).
  • Advanced optimization settings — Shown in Advanced mode: Draco compression, target polygon count (1,000–1,000,000), force polygon count, remove obstructed geometry, bake small features, pivot point (bottom-center/center), max texture resolution, texture compression aggression (1–10), lossless textures, KTX2 format, and ambient occlusion baking (strength, radius, resolution, shown only when baking is on).
  • Additional Options — Optional description, status (Draft, Live Internal, Live Public; defaults to Draft and is also sent as publishToStatus), tag UUIDs and project UUIDs (comma-separated), and attributes as key-value pairs and/or JSON (JSON wins on duplicate keys; invalid JSON throws an error).

Output shape

One item per input item with a JSON object: success, product {uuid, name, assetType 'THREE_D', status, conversionStatus 'PENDING'}, and upload {fileName, fileSize, contentType, blobId, requestUuid}. No binary data is returned.

Conversion runs asynchronously on VNTANA, so conversionStatus is a hardcoded 'PENDING' and does not reflect the final result. Use Product → Search to check progress. The file is rejected if it is empty, over 30GB, has an unsafe file name, or has a MIME type outside glb/gltf/usdz/octet-stream/zip. With Continue On Fail enabled, errors are returned as {error} items. The product is created before the upload, so a failed upload can leave an empty product behind.

Examples

Example 1: Upload a GLB downloaded by an HTTP Request node and optimize it for the web.

Name='Chair-001', Pipeline UUID from Pipeline → List, Binary Property='data', Optimization Mode=Preset, Preset=Web Optimized.

Example 2: Upload a high-detail model with custom settings, SKU attribute, and a live status.

Optimization Mode=Advanced, Target Polygon Count=80000, Max Texture Resolution=4096, Draco off; Additional Options: Status=Live Internal, Attributes (Key-Value) SKU=ABC123.

Links

Discussion