--- title: AI Settings description: Configure the AI providers, AI branding, and AI credits that power Storyblok's AI features in your organization and spaces. url: https://www.storyblok.com/docs/manuals/ai-settings --- # AI Settings Storyblok’s AI features help you create and manage content, including [drafting](/docs/manuals/visual-editor#rich-text-editor), [translations](/docs/manuals/translations#generate-ai-translations), [alt text](/docs/manuals/assets#edit-metadata-and-images), and [SEO](https://www.storyblok.com/apps/storyblok-gmbh@ai-seo). To use AI, open the space or organization **Settings** → **AI Settings**, and select **Enable AI**. ## Supported providers The AI setup determines which provider and model Storyblok’s AI features use. There are two kinds of setup options: - **Default setups**: **GPT by OpenAI**, **Gemini by Google**, and **Claude by Anthropic** come with Storyblok and use your AI credits. - **Custom setups**: use your own provider account and API key. [Admins](/docs/manuals/roles) can assign a setup to the whole organization or to a single space. The following AI providers and models are available: | AI provider | Default setup | Custom setup | | --- | --- | --- | | OpenAI | `gpt-4o`, `gpt-5`, `gpt-5.1`, `gpt-5-mini`, `gpt-5-nano`, `gpt-6-luna`, `gpt-6.1-sol`, `gpt-6.1-terra` | Same as default | | Google Gemini | `gemini-2.5-flash`, `gemini-2.5-pro`, `gemini-3.8-flash` | Default models and `gemini-3.5-flash` | | Anthropic | `claude-sonnet-4-6`, `claude-haiku-4-5`, `claude-sonnet-5-5`, `claude-haiku-5-5` | Default models, `claude-opus-4-6`, and `claude-opus-5-5` | > [!NOTE] > Not all AI setups are available on every plan. For details, check the [pricing page](https://www.storyblok.com/pricing). ## Organization-level setup In your organization, open **Settings** → **AI Settings** → **General**. Select a default setup from **AI Setup**, or select **Create Custom AI setup** and follow the steps in [Create a custom AI setup](#create-a-custom-ai-setup). [![The organization AI Settings page shows the Enable AI toggle turned on and GPT by OpenAI selected under AI Setup.](https://a.storyblok.com/f/212319/2880x1680/363993c239/ai-settings-org-general.png/m/720x0/)](https://a.storyblok.com/f/212319/2880x1680/363993c239/ai-settings-org-general.png) Organization AI settings Custom setups you create here are available in every space in the organization, labeled **Org-level Custom AI setup**. ## Space-level setup In your space, open **Settings** → **AI Settings** → **General**. To use the organization’s setup, select **Inherit the Org-level configuration**. Otherwise, choose an **AI Setup** option: - **GPT by OpenAI**, **Gemini by Google**, or **Claude by Anthropic**: default setups. To change the model, select the settings icon next to the setup. - Setups labeled **Org-level Custom AI setup**: custom setups created in the organization settings. - **Create Custom AI setup**: a custom setup for this space only. [![The space AI Settings page shows the Storyblok Default AI Usage, the Inherit the Org-level configuration toggle turned off, and Gemini by Google selected under AI Setup.](https://a.storyblok.com/f/212319/2880x1680/827f16773f/ai-settings-space-general.png/m/720x0/)](https://a.storyblok.com/f/212319/2880x1680/827f16773f/ai-settings-space-general.png) Space AI settings ## Create a custom AI setup In the **Create Custom AI Setup** panel: 1. Enter a **Name** and, optionally, a **Description**. 2. Select the **AI Provider** and **Model**. 3. Enter your **API Key**. [![The Create Custom AI Setup panel shows OpenAI selected as the AI Provider and GPT-6.1 Sol as the Model, with empty Name, Description, and API Key fields.](https://a.storyblok.com/f/212319/2880x1680/18c4596ca9/ai-settings-model-selected.png/m/720x0/)](https://a.storyblok.com/f/212319/2880x1680/18c4596ca9/ai-settings-model-selected.png) AI provider and model selection To control how the AI responds, adjust the model’s generation settings, including **Temperature**, **Max Tokens**, and more. Some models don’t support every setting. Under **Validate AI Setup**, select **Run Validation** to check that the setup works. Select **Save**. [![The Create Custom AI Setup panel is scrolled to the generation settings and the Validate AI Setup section with the Run Validation button.](https://a.storyblok.com/f/212319/2880x1680/21596d3f9c/ai-settings-run-validation.png/m/720x0/)](https://a.storyblok.com/f/212319/2880x1680/21596d3f9c/ai-settings-run-validation.png) Generation settings and validation ## AI branding AI branding lets you define the AI output for your space. Open **Settings** → **AI Settings** → **Branding** and provide your brand’s style guide. [![The Branding tab shows the Business Context section with the Industry & Niche and Brand, Product, or Service fields filled in.](https://a.storyblok.com/f/212319/2880x1680/6ac93cb134/ai-settings-space-branding.png/m/720x0/)](https://a.storyblok.com/f/212319/2880x1680/6ac93cb134/ai-settings-space-branding.png) Space AI branding ### AI output rules AI output rules are the building blocks of granular AI branding. Write instructions in natural language, so the AI knows how to generate or format content. Some examples of AI output rules: - “Avoid pronouns in the first sentence of a paragraph.” - “Always write the brand name ‘Storyblok’ in bold.” [![The AI Output Rules tab lists two enabled rules: Brand name in bold and No pronouns in first sentence.](https://a.storyblok.com/f/212319/2880x1680/9f32cdaf61/ai-settings-output-rules.png/m/720x0/)](https://a.storyblok.com/f/212319/2880x1680/9f32cdaf61/ai-settings-output-rules.png) AI output rules list To create a new rule in a space, open **Settings** → **AI Settings** → **AI Output Rules** and select **Add new rule**. Name the rule, write the instructions, and select **Test Rule** before you **Save**. [![The AI Output Rule panel shows the Enable Output Rule toggle, the Name, Instruction, and AI Style Groups fields, and the Test Rule button.](https://a.storyblok.com/f/212319/2880x1680/9ee66ff363/ai-settings-output-rule-panel.png/m/720x0/)](https://a.storyblok.com/f/212319/2880x1680/9ee66ff363/ai-settings-output-rule-panel.png) New AI output rule ### AI style groups An AI style group is a collection of AI output rules. A style group can contain multiple output rules, and an output rule can be part of multiple style groups. Output rules only affect AI output when they’re part of an active style group, applied as a default at the organization or space level. For example, an “Internal HR compliance” style group can contain output rules that cover the use of emojis and gender-neutral language. To create a new group, open **Settings** → **AI Settings** → **AI Style Groups**, select **Add new style group**, and add output rules to the group. Run **Test Style Group** before you **Save**. [![The AI Style Group panel shows the Name, Description, and AI Output Rules fields, and the Test Style Group button.](https://a.storyblok.com/f/212319/2880x1680/85b3a6b375/ai-settings-style-group-panel.png/m/720x0/)](https://a.storyblok.com/f/212319/2880x1680/85b3a6b375/ai-settings-style-group-panel.png) New AI style group ### AI default outputs To apply AI style groups automatically whenever someone generates content with AI, set them as defaults. Open **Settings** → **AI Settings** → **Default Outputs** and select the groups. Defaults in a space’s settings apply to that space. Defaults in the organization settings apply to all spaces in the organization. [![The space Default Outputs tab shows the Alt Text style group selected under AI Style Groups.](https://a.storyblok.com/f/212319/2880x1680/88bd308eaa/ai-settings-space-default-outputs.png/m/720x0/)](https://a.storyblok.com/f/212319/2880x1680/88bd308eaa/ai-settings-space-default-outputs.png) Space default outputs ### Organization defaults In the organization settings, **Default Outputs** includes two more options: - **Apply organization-defined AI Style Groups to all Spaces**: every space must use the organization’s default groups. - **Enable Space-level AI Style Groups**: spaces can use individual output rules and style groups. If you allow space-level control, choose how they combine: - **Combine with organization-level AI Style Groups**: apply both the organization and the space’s groups. - **Override organization-level AI Style Groups**: prioritize the space’s groups if they exist. [![The organization Default Outputs tab shows the AI Style Groups selector, the Enable Space-level AI Style Groups option turned on, and Override organization-level AI Style Groups selected.](https://a.storyblok.com/f/212319/2880x1680/257157a12d/ai-settings-org-default-outputs.png/m/720x0/)](https://a.storyblok.com/f/212319/2880x1680/257157a12d/ai-settings-org-default-outputs.png) Organization default outputs ## AI credits Storyblok’s AI features consume AI credits. The number of AI credits available per space depends on your [pricing plan](https://www.storyblok.com/pricing). To learn more about AI credits, how they’re calculated, and how they differ from tokens, read the [AI Credits Explained blog post](https://www.storyblok.com/mp/ai-credits-explained). To track consumption, check the [space dashboard](/docs/manuals/space-dashboard#consumption-metrics) for remaining credits and a weekly or monthly breakdown, or the [organization dashboard](/docs/manuals/organizations#dashboard) for usage across every space in the organization. ### Usage history To view a breakdown of AI credit consumption, open **Settings** → **AI Settings** → **General** and select **View Usage History**. Choose a period and view usage by provider, feature, or user. In the organization settings, you can also view usage by space. ## Pagination - [Previous: Agents](/docs/manuals/agents) - [Next: Assets](/docs/manuals/assets)