# Send a model from KeyShot

URL: https://docs.glossi.io/bring-in-your-product/from-your-3d-tool/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](https://docs.glossi.io/bring-in-your-product/from-your-3d-tool/keyshot-migration.md) 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](https://docs.glossi.io/bring-in-your-product/from-your-3d-tool/keyshot.md#export-manually).

## 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:

1. Delete geometry hidden inside the model.
2. In the **Material** view, right-click a duplicate material and choose **Link Duplicate Materials**.
3. 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.
4. Hide or delete props, ground planes and alternate model sets you don't want shipped. The whole visible scene exports.

## Install the script

1. [Download the script](https://api.glossi.io/downloads/plugins/keyshot), a single `.py` file.
2. 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`
3. 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.
4. Open **Window > Scripting Console** and switch to the **Scripts** tab. **Glossi Uploader** is in the list.

## Upload a model

1. Open the scene.
2. In **Window > Scripting Console > Scripts**, select **Glossi Uploader** and select **Run**.
3. The first time, a **Connect to Glossi** dialog asks for your workspace API key. [Get an API key](https://docs.glossi.io/bring-in-your-product/from-your-3d-tool/overview.md#get-an-api-key-for-a-plugin). The script stores it and won't ask again.
4. 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.
5. 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](https://docs.glossi.io/studio/product-and-materials.md)).

## Export manually

1. Go to **File > Export > glb/gltf**.
2. Tick **Keep Original UVs** if you edited the UV mapping.
3. Choose **Prefer Textures** unless you use geometry nodes.
4. If the file is still too large, lower the texture resolution in the export settings.
5. Save the `.glb` and 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.

## Related

* [Migrate from KeyShot](https://docs.glossi.io/bring-in-your-product/from-your-3d-tool/keyshot-migration.md)
* [Prepare your 3D file](https://docs.glossi.io/bring-in-your-product/prepare-files.md)