Skip to content

docs: update Gemini API documentation to 2.5 series#128

Merged
hoalongnatsu merged 1 commit intoVersusControl:mainfrom
NJX-njx:fix/98-gemini-docs
Mar 4, 2026
Merged

docs: update Gemini API documentation to 2.5 series#128
hoalongnatsu merged 1 commit intoVersusControl:mainfrom
NJX-njx:fix/98-gemini-docs

Conversation

@NJX-njx
Copy link
Copy Markdown
Contributor

@NJX-njx NJX-njx commented Mar 3, 2026

Summary

Updates the Gemini API setup documentation to the latest Gemini 2.5 series per maintainer feedback on #116.

Changes

  • Model table: Replaced deprecated models (gemini-1.0-pro, gemini-1.5-*, gemini-2.0-flash-exp) with Gemini 2.5 series:
    • \gemini-2.5-pro\ - Complex reasoning, production-ready
    • \gemini-2.5-flash\ - Fast responses, balanced performance
    • \gemini-2.5-flash-lite\ - Ultra-fast, cost-efficient
  • Pricing: Updated from ai.google.dev/pricing
  • CURL examples: Switched to \�1\ API and \gemini-2.5-flash:generateContent\
  • API naming: Changed 'Generative Language API' to 'Gemini API'
  • Config examples: Updated all model references throughout the doc

Closes #98

- Replace deprecated models (1.0/1.5/2.0) with Gemini 2.5 series
- Update model table: gemini-2.5-pro, gemini-2.5-flash, gemini-2.5-flash-lite
- Refresh pricing from ai.google.dev/pricing
- Update CURL examples to use v1 API and gemini-2.5-flash
- Change 'Generative Language API' to 'Gemini API'

Closes VersusControl#98

Made-with: Cursor
Copilot AI review requested due to automatic review settings March 3, 2026 14:11
Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Updates the Gemini API key setup guide to reflect the current Gemini 2.5 model lineup and associated setup examples, incorporating maintainer feedback from #116 and addressing the model freshness request in #98.

Changes:

  • Replaces deprecated Gemini model references with the Gemini 2.5 series across model selection and configuration examples.
  • Updates pricing table and cost tip to match current rates from Google AI pricing.
  • Updates curl examples to use the v1 API with gemini-2.5-flash:generateContent, and renames “Generative Language API” references to “Gemini API”.
Comments suppressed due to low confidence (2)

docs/api-key-setup/gemini-api-setup.md:35

  • The doc now instructs enabling/restricting the Gemini API, but later in the same guide ("Configure Google Cloud" step) it still says to enable the Generative AI API. Please align the API name throughout the document or add a brief clarification if these are intentionally different APIs for different setups.
3. Enable the **Gemini API**
4. Go to "Credentials" → "Create Credentials" → "API Key"
5. Restrict the API key to "Gemini API" for security

docs/api-key-setup/gemini-api-setup.md:176

  • Because the guide is now branded as "Gemini API", using the generativelanguage.googleapis.com hostname in the curl examples can be confusing for readers. Consider adding a short note near this example explaining that Gemini API requests are still sent to the generativelanguage.googleapis.com endpoint (and why), so users don’t think they’re using the wrong API.
curl -H "Content-Type: application/json" \
     -d '{"contents":[{"parts":[{"text":"Hello"}]}]}' \
     "https://generativelanguage.googleapis.com/v1/models/gemini-2.5-flash:generateContent?key=$GEMINI_API_KEY"

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

@hoalongnatsu
Copy link
Copy Markdown
Member

Thanks for PR

@hoalongnatsu hoalongnatsu merged commit 9725ca7 into VersusControl:main Mar 4, 2026
3 of 4 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Update Gemini AI Model Documentation

3 participants