Google Gemini Setup

Google Gemini is the recommended AI provider for AI Scene Organizer due to its rapid response times (often under 0.8 seconds) and a highly generous Free Tier accessible via Google AI Studio.

1. Getting an API Key

  1. Navigate to Google AI Studio.
  2. Log in using any personal or corporate Google account.
  3. Click the Get API key button in the top-left sidebar.
  4. Click Create API key (you can create a key in a new project or select an existing one).
  5. Copy the generated key. It will start with AIzaSy.

2. Configuring Unity

Once you have your key:

  1. Open your Unity Project.
  2. Open Project Settings: Edit ➔ Project Settings...
  3. Click on the AI Scene Organizer tab in the sidebar.
  4. Set the Active Provider dropdown to Gemini.
  5. Paste your copied key into the Gemini API Key field.
  6. Click Apply & Save Settings.

In the settings, you can configure the specific Gemini model:

Model ID Cost Performance Recommendation
gemini-1.5-flash Free (Up to 15 RPM) Blazing Fast (~0.5s), very good layout parsing. Recommended for daily use.
gemini-1.5-pro Free (Up to 2 RPM) High Reasoning, handles extremely deep trees. Best for complex, nested levels.

4. Troubleshooting Gemini Connection

  • Error 403 Forbidden / API_KEY_INVALID: Make sure there are no leading or trailing spaces in the API Key input.
  • Error 429 Too Many Requests (Quota Exceeded): The Gemini Free Tier has a limit of 15 requests per minute (RPM). If you hit this limit, wait 60 seconds before executing another prompt, or upgrade to a pay-as-you-go plan inside AI Studio.
  • Geographic Restrictions: Google AI Studio is unavailable in a small number of countries. If you reside in a restricted region, please use the OpenRouter Guide to route Gemini requests through a gateway.
This site uses Just the Docs, a documentation theme for Jekyll.