Skip to content
Agentic Workflowdocs
v0.8.2Install free

use the app / connections

Connect Google Gemini (AI Studio)

Create a Gemini API key in Google AI Studio (or Vertex AI) and use it with Aria, agents and the Google model nodes.

≈ 2 min Extension Web app JWT
  • A Google account. AI Studio keys work without a Cloud project; Vertex AI keys need a Google Cloud project with billing.
Method Use it when
Aria & agents Recommended Chat with Aria or an agent on Google Gemini models. The key is kept in Settings › Providers.
Workflow nodes Use Chat Google, Google Embeddings in a workflow. The key is a saved credential.
  1. Create a key. In Google AI Studio, open Get API key, click Create API key and copy it. For Vertex AI, create the key in the Google Cloud Console instead.
  2. Open Settings › Providers and click + Add provider.
  3. Pick Google as the Provider, give it a Label and paste the key into API key.
  4. Type the Model id (a gemini-… id), then click Add.
  5. Optionally click Set as default, so Aria and agents set to Same as Aria use it.
  • A 401, “invalid API key” or “Incorrect API key” error. The key was mistyped, revoked, or belongs to another account. Create a new key and update the credential (or the provider in Settings › Providers).
  • A 429 or “quota” error. The account is out of credit or over its rate limit. Add credit or wait, then run again.
  • An embeddings node fails with 401 while a chat node with the same key works. The credential is a Bearer Token. Embeddings nodes pass the value to the provider as it is, so use a JWT credential that holds only the key.
  • “API key not valid” with a Vertex AI key. In Chat Google, set Platform Type to gcp. Leave it empty or on gai for an AI Studio key.
Ask Aria