Google AI (Gemini) Free API Guide

Provider fit matrix

Production readiness checklist

Python setup snapshot

Start with the smallest possible chat completion, then move the key to your server-side secret manager before production.

from openai import OpenAI

client = OpenAI(
    api_key="your-google-key",
    # Check Google AI (Gemini) docs for its OpenAI-compatible base URL
)

response = client.chat.completions.create(
    model="Gemini 3.1 Pro",
    messages=[{"role": "user", "content": "Hello from yangmao.ai"}],
)
print(response.choices[0].message.content)

cURL smoke test

Use this to verify endpoint, auth header, model name, response shape, and quota before adding SDK abstractions.

curl https://api.provider.example/v1/chat/completions \
  -H "Authorization: Bearer $GOOGLE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "Gemini 3.1 Pro",
    "messages": [{"role": "user", "content": "Hello from yangmao.ai"}]
  }'

Decision checklist

Related internal links

FAQ