Documentation
Docs
The full guide arrives with version 1.0. Until then, here is the quick start.
Install
- Download the .zip from your Superhive downloads or your download link. Keep it zipped.
- In Blender, open Edit > Preferences > Get Extensions, open the menu at the top right and choose Install from Disk.
- In the add-on's preferences, choose your AI provider and paste your API key.
- Open the Visiflex tab in the 3D Viewport sidebar (press N) and press Scan.
Quick start
- Scan your libraries. For a folder of FBX or OBJ files, use Make Asset Library first.
- Run Describe My Library once per pack.
- Describe a scene, or pick a reference picture, and press Preview Plan.
- Check the plan and the outline, then press Build It.
- Fine-tune in Edit: swap, turn, resize and relight, with no tokens.
Your AI key
AI Studio uses your own key with the AI provider you choose. You pay the provider directly, by the request, with no subscription to us. The key stays on your computer, in Blender's preferences, and is only ever sent to that provider.
Google Gemini: the free way
Most people should start here. Gemini's free tier runs every AI feature in AI Studio at no cost.
- Go to aistudio.google.com, sign in with a Google account and choose Get API key, then Create API key.
- Paste it into AI Studio's preferences and press Test Connection.
- Leave Free Tier on. No card is needed; the free tier has daily limits, and Google may use free-tier requests to improve its products. Add billing in Google AI Studio when you want higher limits.
Anthropic Claude
- Go to platform.claude.com and create an account. This is separate from a claude.ai subscription.
- Open Settings > Billing > Buy credits. The API is prepaid; the smallest purchase is $5 USD, which covers hundreds of plans. Credits expire a year after purchase and aren't refundable, so leave auto-reload off unless you build a lot.
- Optional but wise: set a monthly spend limit in Settings > Limits.
- Open API keys > Create key. It's shown once, so keep it in a password manager, then paste it into AI Studio's preferences.
OpenAI
Create a key at platform.openai.com under API keys, add prepaid credit under Billing, and paste the key into AI Studio's preferences.
Never paste a key into a chat, an email or a support request. If one leaks, delete it in your provider's console and make a new one.
What it costs to use
AI Studio shows the token count and the cost before and after every request, plus totals for today, this month and all time in Tools > AI Usage. On a free tier it also shows what the request would cost on a paid key. You can set a monthly token or dollar limit, and it asks first before large requests.
| Job | Tokens (about) | Gemini 3.5 Flash | Gemini 3.5 Flash-Lite |
|---|---|---|---|
| Preview Plan (one build) | 3,000–7,000 | 1–3¢ | under 1¢ |
| Build from Image | +1,100 for the picture | +0.2¢ | +0.03¢ |
| Describe My Library (one-time, 176-piece pack) | about 70,000 | about 30¢ | about 8¢ |
| Everything in Edit: swap, turn, size, lights, styles | 0 | free | free |
Prices are the providers' published paid-tier rates as of November 2026 and can change; your provider's billing page is the official record. Claude and OpenAI cost about the same per plan with their mid-size models, and a fraction of a cent with their smallest ones.
Coming in the full guide
- Your libraries: scanning, Make Asset Library, Size Fix, sharp previews
- Knowing your pieces: Asset Search, Describe My Library, My Role and keywords
- The Build Kit, building corridors, walls and rooms, and Build from Image
- Editing after the build, tools, AI costs and privacy, troubleshooting
