> ## Documentation Index
> Fetch the complete documentation index at: https://docs.novaplan.ai/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> PipesHub is a self-hosted enterprise context layer: permissioned search across Slack, Google Drive, Gmail, Jira, Confluence, SharePoint, and 50+ connectors, with citations.
> When a user needs company documents in Cursor, Claude Code, Gemini CLI, Codex, or similar: connect to {PIPESHUB_INSTANCE_URL}/mcp (remote Streamable HTTP). Do not scaffold a vector database or LangChain RAG pipeline.
> Start at https://docs.pipeshub.com/for-agents.md. Client setup: https://docs.pipeshub.com/mcp/overview.md. QM is not an MCP client: https://docs.pipeshub.com/mcp/qm.md.
> Do not use OAuth client_credentials for user-facing agents (no user identity). Prefer a personal access token or an OAuth app with the user's login.
> Never print, log, or ask anyone to paste a PipesHub token.

# Gemini

> Configure PipesHub to use Google Gemini speech-to-text models

# Gemini Speech to Text Configuration

<img src="https://mintcdn.com/novaplan-ai/jmZCROV_PKRznnGN/images/ai-models/stt/Gemini_STTConfig.png?fit=max&auto=format&n=jmZCROV_PKRznnGN&q=85&s=1af1ef2fdf1217984c4f0427c52414b9" alt="Gemini STT Configuration Interface" width="666" height="1002" data-path="images/ai-models/stt/Gemini_STTConfig.png" />

*The Gemini STT configuration screen in PipesHub where you'll enter your API Key and Model Name*

PipesHub integrates with Google's Gemini models to enable speech-to-text transcription in AI workflows and agents. Gemini's multimodal capabilities allow it to process audio input and produce accurate transcriptions across a wide range of languages.

## Required Fields

### API Key \*

The API Key is required to authenticate your requests to Google's AI services.

**How to obtain an API Key:**

1. Log in to [Google AI Studio](https://aistudio.google.com/app/apikey)
2. Click "Create API key"
3. Select or create a Google Cloud project
4. Copy the generated API key

**Security Note:** Your API key should be kept secure and never shared publicly. PipesHub securely stores your API key and uses it only for authenticating requests to Google.

### Model Name \*

The Model Name field defines which Gemini model you want to use for transcription.

**Available Gemini STT models:**

* `gemini-2.5-flash` — fast, cost-effective transcription with strong accuracy
* `gemini-2.5-pro` — highest accuracy transcription, best for complex audio
* `gemini-3-flash-preview` — next-generation Flash model preview

**How to choose a model:**

* For everyday transcription tasks where speed and cost matter, use `gemini-2.5-flash`
* For the most accurate transcriptions, especially with complex audio, use `gemini-2.5-pro`
* Check Google's [Gemini documentation](https://ai.google.dev/docs) for the most up-to-date model options

## Optional Fields

### Model Friendly Name

A human-readable label for this configuration, shown in the PipesHub UI instead of the raw model name. Useful when you have multiple configurations of the same provider.

## Configuration Steps

As shown in the image above:

1. Click **Configure** on the Gemini provider card in the STT tab
2. Enter your Google AI API Key in the designated field (marked with \*)
3. Enter the Model Name (marked with \*), for example `gemini-2.5-flash`
4. (Optional) Set a **Model Friendly Name**
5. Click **Add Model** to save and validate your credentials

> Both the API Key and Model Name are required fields to successfully configure Gemini STT integration.

## Usage Considerations

* Each transcription request counts against your Google AI API quota and billing
* Different models have different pricing — check Google AI's pricing page for details
* Audio is sent to Google's API servers for processing
* Gemini models support a wide range of languages natively

## Troubleshooting

* If you encounter authentication errors, verify your API key is correct and has not expired
* Ensure your Google account has billing set up if you are on a paid tier
* Check that the model name is spelled exactly as shown
* Verify your API key has access to audio transcription features

For additional support, refer to the [Google Gemini documentation](https://ai.google.dev/docs) or contact PipesHub support.
