1. Overview
The Ana x Gemini integration connects the Google Gemini API to Ana, giving you natural language access to the Gemini developer platform. Once configured, Ana can list available models and their capabilities, inspect your tuned models, and manage uploaded files — all without leaving your workflow.Connect Gemini to Ana to query and manage your Google Gemini API resources using natural language.
2. Prerequisites
You’ll need:- A Google account with access to Google AI Studio
- A Gemini API key (free tier available)
- A TextQL account with permission to add API connectors
3. Capabilities
Once configured, Ana can:- List the Gemini models available to your API key, including context window sizes and supported generation methods.
- Inspect your tuned models and their training state.
- List and manage files uploaded to the Gemini Files API.
- Call Gemini endpoints on your behalf for content generation, embeddings, and token counting.
4. Setup Instructions
Step 1: Generate your Gemini API key
- Go to aistudio.google.com and sign in with your Google account.
- Click Get API key in the left sidebar (or go directly to aistudio.google.com/app/apikey).
- Click Create API key.
- Choose to create the key in a new or existing Google Cloud project.
- Copy the API key immediately and store it securely.
Step 2: Add Gemini as an API connector in TextQL
- Go to app.textql.com and sign in.
- In the bottom left sidebar, click Connectors > APIs and select Gemini.
- In the configuration panel, fill in the fields:
- Name (e.g.
Gemini) - API Key: paste the key copied from Step 1
- Name (e.g.
- Click Test to verify the key, then click Save.
Step 3: Verify the connection
Once saved, confirm the connector is active:- Go to app.textql.com.
- On the bottom left sidebar click Connectors → APIs and check that Gemini appears in your list of active connectors.
- Open a new Ana chat and ask a simple query, such as: “What Gemini models are available to me?”
- If Ana returns results, the connection is working. If you see an error, refer to Section 6: Troubleshooting.
5. Usage Examples
Once configured, you can ask Ana:- “List the Gemini models available to my API key.”
- “What’s the context window size for the latest Gemini Pro model?”
- “Show me my tuned models and their current state.”
- “What files have I uploaded to the Gemini Files API?”
- “Count the tokens in this prompt using Gemini.”
6. Troubleshooting
| Symptom | Likely Cause | Fix |
|---|---|---|
Test fails with 400 API_KEY_INVALID | Invalid, revoked, or incorrectly copied API key | Generate a new API key in Google AI Studio and update the connector in TextQL. |
403 PERMISSION_DENIED | The key’s Google Cloud project has the Generative Language API disabled, or the key has application restrictions that block server-side calls | Enable the Generative Language API for the project, or remove/adjust the key’s restrictions in the Google Cloud console. |
429 RESOURCE_EXHAUSTED | Rate limit or quota exceeded on the free tier | Wait for the quota to reset, or enable billing on the key’s Google Cloud project for higher limits. |
| Ana returns no results | The query targets a resource the key can’t see (e.g. tuned models in a different project) | Verify the API key belongs to the Google Cloud project containing the resources you expect Ana to query. |
7. Security Notes
- Gemini API keys remain valid until they are manually revoked. Store them securely and rotate them if you suspect they have been exposed.
- Consider adding restrictions to the key in the Google Cloud console to limit where it can be used.
- Do not share API keys in email, chat, tickets, or other unsecured locations.
- If you no longer need the integration, delete the API key in Google AI Studio and remove the connector from TextQL.
- For more details on how Google handles API authentication, refer to the Gemini API documentation.