OpenAI Setup

For teams requiring enterprise-level consistency or those who already integrate OpenAI inside their workflow, AI Scene Organizer offers full compatibility with GPT-4 models.

1. Acquiring an API Key

[!WARNING] OpenAI API keys are distinct from ChatGPT Plus subscriptions. You must create a developer account on the OpenAI Platform and add credit balance to your billing settings. Keys without a credit balance will immediately return 429 Quota Exceeded errors.

Go to the OpenAI Platform Dashboard.
Log in or create a developer account.
Navigate to Settings ➔ Billing and click Add Credits (minimum $5 recommended).
Go to API Keys in the sidebar.
Click Create new secret key, name it, and copy it immediately. The key starts with sk-.

2. Configuring Unity Settings

In the Unity Editor, open Edit ➔ Project Settings... ➔ AI Scene Organizer.
Set Active Provider to OpenAI.
Paste the key into the OpenAI API Key text field.
Click Apply & Save Settings.

3. Supported OpenAI Models

Configure your model preference in the settings panel:

gpt-4o-mini: Highly economical, extremely fast, and highly reliable at generating structural JSON lists. (Recommended model)
gpt-4o: Enhanced reasoning capabilities. Useful for parsing massive, highly chaotic scenes with thousands of objects, though slightly slower.

4. Troubleshooting OpenAI Connection

Error 429 Insufficient Quota: This indicates your OpenAI platform balance is empty ($0.00). Add billing credits in your platform dashboard billing tab. It may take up to 10 minutes for credits to reflect on your key.
Error 401 Unauthorized: Your key has been deleted, disabled, or copied incorrectly. Generate a new key and double check that the entry in Unity matches.