Google Gemini Configuration

Connect Glyph to Google’s Gemini API to use Gemini Pro, Gemini Flash, and other models.

​

Prerequisites

• Google AI Studio account: aistudio.google.com
• API key (free tier available)

​

Setup

​

Configuration

​

Provider Settings

• Service: gemini
• Base URL: https://generativelanguage.googleapis.com (default)
• Authentication: API key via query parameter

​

API Endpoint

Glyph uses the /v1beta/models endpoint to list models and sends requests to the Gemini API. The API key is passed as a query parameter: ?key=YOUR_API_KEY

​

Model Selection

Glyph fetches the latest model list from Google’s API.

​

Recommended Models

​

Model Naming

Google’s API returns model names with a models/ prefix (e.g., models/gemini-1.5-pro). Glyph automatically strips this prefix when displaying and selecting models.

​

Features

​

Chat Mode

Conversational interaction:

• Back-and-forth dialogue with Gemini
• No file system access
• Fast responses
• Best for Q&A and brainstorming

​

Create Mode

Gemini with workspace tools:

• read_file - Read files from your space
• search_notes - Search note content
• list_dir - List directory contents
• Tool usage tracked in timeline view
• Best for research and knowledge retrieval

​

Context Attachment

Leverage Gemini’s massive context window:

• Attach files or entire folders
• Mention with @filename syntax
• Configure character budget (up to 250K chars)
• Gemini can handle extremely large contexts

​

API Usage and Billing

​

Free Tier

Google AI Studio offers a generous free tier:

• Gemini 1.5 Flash: 15 RPM, 1M TPM, 1,500 RPD
• Gemini 1.5 Pro: 2 RPM, 32K TPM, 50 RPD

RPM = requests per minute, TPM = tokens per minute, RPD = requests per day

​

Paid Tier (Pay-as-you-go)

Check current pricing at ai.google.dev/pricing.

​

Rate Limits

Rate limits depend on your tier and model:

• Free tier: See limits above
• Paid tier: Higher limits, see Google AI documentation

If you hit rate limits, Glyph displays the error. Wait before retrying or upgrade to paid tier.

​

Troubleshooting

​

”API key not set for this profile”

Solution: Add your Google API key in Settings → AI.

​

”model list failed (400)”

Possible causes:

• Invalid API key
• API key doesn’t have permission for Gemini API

Solution: Create a new API key from AI Studio.

​

”model list failed (429)”

Solution: You’ve hit Google’s rate limit. Wait before retrying or check your quota.

​

Model list is empty

Solution: Type the model ID manually:

• gemini-1.5-pro
• gemini-1.5-flash
• gemini-pro

Do not include the models/ prefix.

​

”The model: models/gemini-1.5-pro does not exist”

Cause: You included the models/ prefix in the model field. Solution: Use just gemini-1.5-pro without the prefix. Glyph handles the prefix internally.

​

Responses are slow with large context

Cause: While Gemini supports huge contexts (2M tokens), processing them takes time. Solution:

• Use gemini-1.5-flash for faster responses
• Reduce context size if not all content is necessary
• Be patient; processing 100K+ tokens may take 10-30 seconds

​

Multimodal Support

Gemini models support text, image, audio, and video inputs. However, Glyph currently only supports text inputs and outputs. Image and multimodal support may be added in a future release.

​

Security Best Practices

​

Gemini-Specific Tips

​

Large Context Use Cases

Gemini’s 2M token context enables unique workflows:

• Attach entire project directories
• Include multiple books or research papers
• Provide comprehensive context for analysis

​

System Instructions

Gemini respects system prompts. In create mode, Glyph adds tool usage guidelines to reduce unnecessary searches.

​

Thinking Models

Google may release reasoning models (similar to OpenAI’s o1). When available, they’ll appear in Glyph’s model list automatically.

​

Next Steps