Skip to main content
Unlayer Docs
Unlisted page
This page is unlisted. Search engines will not index it, and only users having a direct link can access it.

Custom Gemini Key

Enterprise Feature

This feature is only available in Enterprise plan. Learn More

You can configure your own Google Gemini API key to power AI features in your project. This routes Gemini-model requests through your own Google account so:

  • Billing — Google bills calls made with your key to your provider account. AI Assistant and image requests still consume Unlayer AI credits and follow project credit limits; using your key does not waive those credits. See AI credit pricing.
  • Rate limits — your Google account's rate limits apply, not Unlayer's shared pool.

Setting up your custom key​

  1. Open your project in Console.
  2. Navigate to Settings → AI → AI Provider Keys.
  3. Paste your Gemini API key into the Gemini API Key input.
  4. Click Save Key.

The key is validated against Google before being stored. Once saved, every AI feature that resolves to a Gemini model uses this key instead of Unlayer's default.

What this affects​

Your custom key powers Gemini-routed image generation and editing in the AI Assistant, standalone Image Editor, and Images API. Images can also use OpenAI models; Gemini is not the only supported image provider. features.ai.image.model selects the image model independently of the Assistant's conversation model.

If a configured fallback switches providers, the key for the provider actually called is used. A Google key does not cover OpenAI requests. See Picking an Image Model.

OpenAI-model requests continue to route through Unlayer's hosted service unless you've configured a Custom OpenAI Key.

If your key stops working​

If your Google key is revoked, deleted, or otherwise rejected by the provider, AI requests that route through it fail with a clear in-editor message: "The custom AI provider API key configured for this project was rejected. Update or remove it in the Unlayer Console to restore AI features." Update the key in Console — or remove it to fall back to Unlayer's built-in key (standard billing applies).