Send a model from KeyShot
Upload a KeyShot scene with baked PBR materials using the Glossi Uploader script, or export a GLB and upload it yourself.
KeyShot's .bip and .ksp files can't be uploaded, but KeyShot exports GLB and bakes its procedural materials into PBR texture maps on the way. The Glossi Uploader script runs that export and uploads the result to your workspace. It works with KeyShot 11 and newer on Windows and macOS. Scripting is included in KeyShot Pro, KeyShot Studio and the trial, not in viewer licenses.
Moving a whole workflow over? Migrate from KeyShot covers what transfers and what you rebuild.
Enterprise. The script uploads with a workspace API key. API keys are available on Enterprise, and a workspace owner or admin creates them. Without one, use manual export.
Prepare the scene
KeyShot scenes often carry dense geometry and duplicate materials that make a large file. Save a copy of the project first, then:
- Delete geometry hidden inside the model.
- In the Material view, right-click a duplicate material and choose Link Duplicate Materials.
- Reduce mesh density:
- NURBS models: select the mesh, choose Tools > Retessellate, and lower Tessellation Quality while the silhouette holds. Angle Tolerance and Maximum Edge Length refine it further.
- Polygon meshes: use Tools > Mesh Simplification and lower the triangle count while watching the silhouette. This is destructive, so keep the backup.
- Hide or delete props, ground planes and alternate model sets you don't want shipped. The whole visible scene exports.
Install the script
- Download the script, a single
.pyfile. - Find KeyShot's Scripts folder under Edit > Preferences > Folders > Scripts. Typical defaults:
- Windows:
Documents\KeyShot Studio <version>\Scripts - macOS:
/Library/Application Support/KeyShot Studio/Scripts
- Windows:
- Copy the script into that folder as Glossi Uploader.py, so a later update replaces it instead of adding a second entry. Create the folder if it doesn't exist yet; on macOS, Finder may ask for an administrator password. You can also point the Scripts path at any folder you like.
- Open Window > Scripting Console and switch to the Scripts tab. Glossi Uploader is in the list.
Upload a model
- Open the scene.
- In Window > Scripting Console > Scripts, select Glossi Uploader and select Run.
- The first time, a Connect to Glossi dialog asks for your workspace API key. Get an API key. The script stores it and won't ask again.
- In Upload to Glossi, set the Model name (it defaults to the scene name) and the Texture baking quality:
- Standard: good detail, faster export, smaller file.
- High (slower, larger file): finer texture detail for close-ups.
- Select Ok.
KeyShot stays busy while the export and upload run, with progress in the Scripting Console output. A message confirms the upload, and the model appears in Library > Models when processing finishes.
The baked materials usually transfer well. Fine-tune roughness, metalness and color in the Studio after upload (materials).
Export manually
- Go to File > Export > glb/gltf.
- Tick Keep Original UVs if you edited the UV mapping.
- Choose Prefer Textures unless you use geometry nodes.
- If the file is still too large, lower the texture resolution in the export settings.
- Save the
.glband upload it with Add model > Upload a 3D file.
Troubleshooting
- The script isn't in the Scripts tab: check the file is in the folder shown under Edit > Preferences > Folders > Scripts, then reopen the Scripting Console.
- "That API key was not accepted": the key was revoked or mistyped. The script clears it; create a new one in Settings > Workspace > API Keys and run the script again.
- "GLB export produced no file": the scene is empty or nothing is visible. Unhide the model and run it again.
- Upload failed: the message shows where the exported GLB was saved. Upload it in the app while you sort out the connection.