Base Asset
Base Assets are sometimes referred to as raw models or source models in tutorials or elsewhere in the docs. Base asset is a user uploaded model. All future processing is applied to these assets only.
This is where you find endpoints some critical endpoints:
- Uploading a model
- Optimizing a model
- Read 3D Metadata of the uploaded model
- Get running jobs (we suggest you to check webhooks though)
- Find all optimized versions of a base asset
What happens to uploaded files?
Each base asset upload will trigger some analysis process to generate 3D metadata and render images for using that file in an easier way in downstream processes. You are going to find this data when you call Get Base Asset endpoint and look at .json or image files inside the data -> downloads.
Automatically exported models
If the uploaded model is a CAD file, we will also automatically output a .glb and .usd version of it. If the uploaded model is a 3ds Max file, we will automatically output a .glb, .gltf, .fbx, and .usdz version of it while translating all V-ray materials to PBR materials. Read reference documentation of DCC Importer for more information on this topic.
Base Asset Endpoints
Here are all the base asset endpoints:
📄️ Optimize
There are two ways to optimize a base asset:
📄️ Multi Optimize
Optimizes multiple models with one request
📄️ Get Running Jobs
Returns rapidmodels (until 1 week) that are still being processed or were not successfully optimized
📄️ Get Base Asset
Returns detailed information about an uploaded 3D model asset, including its processing status,
📄️ Delete Base Asset
📄️ Update Base Asset - Add Tags, Set scale factor
A tag can have 255 utf-8 characters including whitespaces
📄️ Get Download URLs
Returns a list of urls to download the individual base asset files
📄️ Get Download URLs for converted files.
Returns a list of urls to download the individual converted formats
📄️ Get imported DCC files
Returns a list of urls to download the individual converted DCC material and quality control files
📄️ Download zip
Downloads all model files as zip.
📄️ Get QC render files for a base asset
The keys of the images are built with the following reasoning:
📄️ Delete Tag of a Base Asset
📄️ Get Base Assets
Paginated response of your base assets. Search for base assets by name or tag
📄️ Delete Multiple Base Assets
📄️ Add converted formats to the model
This endpoint starts the conversion process to the provided target formats. The conversion process is asynchronous and can take some time to complete.
📄️ Get format conversion jobs
Returns an array of objects, each object represents a format conversion job with its status, progress, and target formats.
📄️ Create Base Asset - Get Upload Link
This endpoint initiates a new base asset upload process and returns:
📄️ Create Base Asset - Complete Upload
Final step in the upload process. Call this endpoint after:
📄️ Retries a failed import
📄️ Get Associated Rapid Models
Get all rapid models which were optimized from this base asset