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 OpenAI Key

Enterprise Feature

This feature is only available in Enterprise plan. Learn More

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

  • Billing — OpenAI 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 OpenAI 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 OpenAI API key into the OpenAI API Key input.
  4. Click Save Key.

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

What this affects​

Your custom key powers OpenAI-routed requests, including image generation and editing when the selected image model uses OpenAI. The conversation model and image model are chosen independently: features.ai.model controls text/design assistance, while features.ai.image.model controls images. The standalone Image Editor and Images API use the same image-provider key selection.

Gemini image requests use your Custom Gemini Key, when configured. If image fallback switches providers, the key configured for the provider actually called is used; otherwise that call uses Unlayer's key. See Picking an Image Model.

If your key stops working​

If your OpenAI 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).