---
title: How to get a Google Gemini API key - Workflow Suite
description: >-
  Create a Gemini API key in Google AI Studio, connect it on the Developer
  page of Workflow Suite and pick a default model to write functions with AI.
source_url:
  html: >-
    https://docs.workflow-suite.app/get-gemini-api-key
  md: >-
    https://docs.workflow-suite.app/get-gemini-api-key.md
---

# How to get a Google Gemini API key

Workflow Suite can write and change the code of your functions with AI. It uses your own key from an AI provider. This page shows how to create a Google Gemini API key, where to paste it in Workflow Suite and how to pick a default model.

## Create the key at Google

1. Open **Google AI Studio** and sign in with your Google account: <a href="https://aistudio.google.com" target="_blank" rel="noopener">aistudio.google.com</a>.
2. Open **Get API key**. Direct link: <a href="https://aistudio.google.com/apikey" target="_blank" rel="noopener">aistudio.google.com/apikey</a>.
3. Select **Create API key** and choose or create a Google Cloud project.
4. Copy the key. It starts with `AIza`.
5. For more than the limits of the free tier, turn on billing for that project in Google AI Studio. Generation is then billed to your Google account.

> [!WARNING]
> **Keep the key private**
> Treat the key like a password: paste it into Workflow Suite and do not share it. We never need your key to help you, so leave it out of support requests.

## Paste the key into Workflow Suite

1. In your Shopify admin, open **Workflow Suite** and select **Developer** in the app menu.
2. Open the tab **Connections**. Under **Write and change functions with AI** there is one card per provider.
3. In the **Google Gemini** card, paste the key into **API key**.
4. Select **Save key**.

The card then shows **Key connected** and the model it uses.

> [!NOTE]
> **What happens when you save**
> - The key is checked with Google first. If Google rejects it or cannot be reached, the key is not saved and a message tells you why.
> - An accepted key is stored encrypted and is never shown again. To use another key, paste it into the same field and select **Replace key**.
> - The key is used only when you generate. Your request and the function's code are then sent to Google under your account.
> - Your functions cannot read this key, and it never reaches the sandbox they run in. For keys your own code needs, see [Secrets](https://docs.workflow-suite.app/secrets.md).
> - **Disconnect** deletes the saved key. Writing functions with Google then stops working until you connect a key again.

## Pick a default model

Once the key is saved, the card has a **Default model** list. This model is preselected when you write a function with AI. You can pick another model each time.

- Workflow Suite starts with **Gemini 3.8 Flash** when your key offers it.
- The list is Google's own list for your key, with models such as **Gemini 4 Carbon**, **Gemini 4 Argon** and **Gemini 3.5 Flash-Lite**. It can show more models than these.
- An older model you already saved keeps working as long as Google offers it, and the card names the newer model with a button to switch.

## Write a function with AI

1. Open **Functions** in the app menu and open a function.
2. Select **Write with AI** above the code.
3. Pick the **Model**, describe what should change and select **Generate**. With more than one provider connected, pick the **Provider** first.

The new code is loaded into the editor. Nothing is saved until you save, so review and test it first.

On a new, empty function, **Create with AI** drafts the code, sample variables and the permissions it needs from your description.

> [!NOTE]
> **Billed to your Google account**
> Generation is billed to your own Google account, not to your Workflow Suite plan. For models with a known price, the model list shows an estimated cost per generation. What you pay is set by Google.

## Related

- [Run code and functions](https://docs.workflow-suite.app/run-code.md) - what functions are and how a workflow runs them.
- [Secrets](https://docs.workflow-suite.app/secrets.md) - keys and passwords for your own steps and code.
- [Build workflows with an AI assistant over MCP](https://docs.workflow-suite.app/build-workflows-with-ai-over-mcp.md) - a different feature: an AI assistant that builds whole workflows over MCP.
