Google Gemini API key

What you need

You need a Cella Max plan, an internet connection, a Google account, and access to Google AI Studio in your region. Every Gemini API key belongs to a Google Cloud project, which owns its billing, permissions, quotas, and usage.

Good to know: An API key is a secret that can use quota or create charges on its Google Cloud project. Use a dedicated key or project where practical, do not share the key, and replace it immediately if it is exposed.

Create or find the key in Google AI Studio

1. Open Google AI Studio API keys and sign in.
2. Accept the terms if Google asks. New users may receive a default Google Cloud project and key automatically.
3. If a suitable key already appears, use its copy control. Otherwise, select Create API key and choose or create the project Cella should use.
4. If an existing Google Cloud project is missing, open Dashboard > Projects, select Import projects, import it, then return to API Keys.
5. Copy the new key. New keys created by Google AI Studio use Google's current authorization-key format and are restricted to the Gemini API by default.

Billing is optional for models and regions that have an available free tier. If your chosen model requires paid access or more quota, set up billing for the same Google Cloud project before testing in Cella.

Add the key to Cella

1. In Cella, open More > Settings > AI Engine.
2. Under Cloud Providers, tap Add Cloud Provider.
3. Set Provider to Google Gemini.
4. Leave Display name as Google Gemini, or enter a name that identifies the Google Cloud project.
5. Paste the key into API key. Do not add spaces before or after it.
6. Tap Choose model and select a compatible content-generation model returned for your key.
7. Tap Test connection.
8. When Cella shows Authenticated, structured output and chat tools verified, tap Save.

Cella stores the key in the iOS Keychain. When you select this provider for a vault, relevant document content is sent directly from your iPhone to Google under your Google Cloud project and terms.

If the connection fails

• Create API key is unavailable: Use a project where you have permission to create keys, or ask the project administrator for the required access.
• API key was rejected or blocked: Create a new key in Google AI Studio. Do not reuse an unrestricted or blocked older standard key.
• No models appear: Confirm that the key and project can use the Gemini API in your region.
• Rate limited or quota error: Check Dashboard > Usage and the billing or quota settings for the same project.
• Structured output or tools are unsupported: Return to Choose model and select another compatible content-generation model.

For current provider instructions, see Google's Gemini API key guide and Gemini API billing guide.