KeyShot Plugin

Upload models to Glossi straight from KeyShot. The script exports the open scene as GLB using KeyShot's glTF exporter, which bakes KeyShot's procedural materials into PBR texture maps, and sends the result to your workspace.

Works with KeyShot 11 and newer, on Windows and macOS. Scripting is included in KeyShot Pro and KeyShot Studio licenses (and the free trial); it is not available in viewer-only licenses.

Install

1. Download the script (a single .py file).
2. Find KeyShot's Scripts folder: Edit > Preferences > Folders > Scripts shows the exact path on your machine. Typical defaults:
   • Windows - Documents\KeyShot Studio <version>\Scripts
   • macOS - /Library/Application Support/KeyShot Studio/Scripts
3. Copy the script into that folder, named Glossi Uploader.py - the Scripts list displays the filename, and keeping the name stable means a future update replaces the entry instead of adding a second one. The folder often doesn't exist until you create it - that's normal, KeyShot only creates it on demand. Create it and copy the file in (on macOS the default is in the system Library, so Finder may ask for an administrator password). If you'd rather avoid that, change the Scripts path in the same preferences panel to any folder you like and put the script there.
4. In KeyShot, open Window > Scripting Console and switch to the Scripts tab. The Glossi Uploader script appears in the list.

Upload a model

1. Open the scene you want to send.
2. Open Window > Scripting Console, switch to the Scripts tab, select Glossi Uploader in the list, and click Run.
3. First run only - a dialog asks for your workspace API key. Create one in Glossi under Workspace Settings > API Keys (details in Import from a 3D tool), paste it in, and confirm. The script stores the key locally and won't ask again.
4. In the upload dialog, set a Model name (defaults to the scene name) and pick a Texture baking quality:
   • Standard - good fidelity, faster export, smaller file
   • High - finer texture detail for close-up work, slower export
5. Click Ok.

KeyShot stays busy while the export, upload, and processing run - progress prints to the Scripting Console output. When it finishes, a message confirms the model is in Library > Models, ready to render.

Tips

• The whole scene exports. Hide or delete props, ground planes, and alternate model sets you don't want shipped before running the script.
• Materials arrive baked. KeyShot's procedural materials become PBR texture maps during export. They transfer well, but you can fine-tune roughness, metalness, and color in Glossi's material calibration after upload.
• Environments, lighting, and cameras don't transfer - that's expected. You rebuild those with Glossi backdrops, light rigs, and camera bookmarks. See Migrate from KeyShot for the full picture.
• Optimize heavy scenes first. Dense NURBS tessellation and duplicate materials inflate the GLB. The Import from KeyShot guide covers retessellation and material linking; everything there applies to plugin uploads too.

Troubleshooting

• The script doesn't appear in the Scripts tab - check the file landed in the folder shown under Edit > Preferences > Folders > Scripts, then reopen the Scripting Console.
• "Invalid API key" - the key was revoked, expired, or mistyped. The script clears a rejected key automatically; create a fresh one in Workspace Settings > API Keys and run the script again.
• Export produced no file - the scene is empty or nothing is visible. Unhide the model and run the script again.
• Upload failed mid-way - the error message shows where the exported GLB was saved, so you can upload it manually in the web app while you sort out the connection.