Docs
Bring Your Own Gemini Key

Bring Your Own Gemini Key

Connect a Gemini API key so video analysis runs on your own Google account instead of your plan's video minutes.

Video analysis is the step that watches your recording and drafts the outline your script is built from. By default it runs on VideoMule's own Gemini access and uses your plan's video minutes. With your own Gemini key connected, analysis runs on your Google account instead.

Who can use it

  • Your workspace is on a paid plan or an AppSumo plan. During a trial the Connect button stays locked until the subscription starts.
  • You are an admin of the organization. Members can open the Integrations page but cannot connect or disconnect keys.

Billing and usage

Upload modeWith a Gemini key connectedWithout a key
Both video & audioYour Google accountPlan video minutes
Video onlyYour Google accountPlan video minutes
AutoYour Google accountPlan video minutes
Audio onlyPlan minutes (unchanged)Plan minutes

Storage and rendering are unchanged. Google bills Gemini usage to the account that owns the key; check Gemini API pricing and the key's quota in Google AI Studio.

The decision is made when an upload finishes. An upload that was analyzed on your key stays on your key if you retry it, and an upload that used plan minutes is not refunded if you connect a key afterwards. If your subscription ends or your AppSumo license is deactivated, new uploads go back to plan minutes until the plan is active again.

AppSumo plans

  • Both and Video only uploads stop consuming your one-time video analysis minutes while a key is connected. The Usage page marks that bucket as not in use.
  • Audio only uploads still use your monthly upload minutes, exactly as before.
  • Analysis minutes you used before connecting the key stay used; there is no credit back.
  • Extra analysis-minute add-ons bought on AppSumo are not needed while a key is connected. They remain on your account and apply again if you disconnect the key.

Step 1: Create a Gemini API key

  1. Open Google AI Studio and sign in with the Google account that should be billed.
  2. Click Create API key and choose or create a Google Cloud project.
  3. Copy the key. It starts with AIza.

Make sure the Gemini API is enabled for that project and that billing is set up if you expect to go past the free tier. A key with no quota is rejected the first time VideoMule uses it.

Step 2: Connect it in VideoMule

  1. In VideoMule, open Integrations from the dashboard sidebar.
  2. Under Gemini video analysis, paste the key into Gemini API key and click Connect.

VideoMule checks the key with Google before saving it. Once connected, the card shows the last four characters of the key, when it was validated, and which upload modes now run on your account.

Reconnecting a rejected key

If Google rejects the key or reports that its quota is exhausted while a video is being analyzed, that project fails with a message asking you to reconnect, and the Integrations card marks the key as invalid. Nothing falls back to VideoMule's own access and no plan minutes are charged for that upload. Disconnect the key, connect a working one (or add quota in Google AI Studio and reconnect the same one), then retry the video from the project.

Disconnecting

Click Disconnect on the Gemini card. New uploads go back to your plan's video minutes. Videos that already ran on your key are not affected, but retrying one of them needs a key connected again.