yangmao.ai · Python setup money page

Google AI (Gemini) Python API Setup

Use this page when you need a working Python starting point for Google AI (Gemini), then validate quota and model names in the official console before production.

Open official provider → Get one OpenAI-compatible key → Compare API gateway options →

Quick verdict

Free API: 免费 API 无需信用卡
Rate limits: 15 RPM (Flash)
Best model starting point: Gemini 3.1 Pro
Mainland China access: direct or relatively friendly

Provider fit matrix

Best fit Fast provider evaluation, prototypes, and fallback routing

Watch out Free credits and rate limits can change without warning

Production fallback Keep at least one compatible backup provider before shipping

Production readiness checklist

Quota gate Start inside 免费 API 无需信用卡; log usage before adding retries or batch jobs.

No-card check Try the free path first, then confirm whether billing is required for API keys, higher RPM, or production endpoints.

Regional smoke test Still run one request from your deployment region and from mainland China if users are there.

Source freshness Snapshot date: 2026-06-16; official quota and pricing can change without notice.

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)

Free API and pricing notes

免费 API 无需信用卡

Google AI Studio offers completely free API access, no credit card required, rate limited

Access and production risk

Mainland China friendly / direct path likely

Partially accessible, VPN recommended for stability

How to set it up

Create or locate your provider API key in the official dashboard.

Install the OpenAI-compatible Python SDK or the provider-supported SDK.

Set the API key in an environment variable instead of hard-coding secrets.

Run a small Google AI (Gemini) chat completion with Gemini 3.1 Pro.

Watch free credits, RPM/TPM limits, response shape, and error messages before scaling.

Google AI (Gemini) production validation table

Use this table before sending real users, scheduled agents, or paid traffic to Google AI (Gemini). The goal is to validate source freshness, quota behavior, regional access, and fallback needs instead of trusting a stale free-credit claim.

Check Pass condition If it fails

Signup and billing state Key creation works and the account can spend the recorded 免费 API 无需信用卡. Compare Google AI (Gemini) alternatives or route through a gateway before inviting users.

First request from target region A minimal request succeeds from your deployment region and mainland-China test point if relevant. Do not ship cron jobs or public demos until latency, DNS, TLS, and auth are repeatable.

Quota, retry, and error shape Rate-limit behavior matches the current 15 RPM (Flash) note or official dashboard values. Cap retries, add request logging, and keep a second route for 429/5xx bursts.

Cost per accepted task Real prompts stay within your target token, query, image-credit, or compute budget. Use cheaper primary routes, caching, shorter prompts, or fallback only after validation failure.

Credit-change alerts

Want to know when free credits, pricing, or availability changes? Subscribe first, then compare official providers, API gateways, and alternatives.

Subscribe → Get an OpenLLMAPI key → Compare API gateways →

Source snapshot

Data source: yangmao.ai provider YAML tracker plus provider docs reviewed by the daily crawler. Official dashboards can change quota and pricing without notice; verify before production.

yangmao.ai provider id: google
Official source: https://aistudio.google.com
Last updated: 2026-06-16
Free tier: Gemini free tier unlimited
API credits: 免费 API 无需信用卡
Rate limit: 15 RPM (Flash)
Access note: Partially accessible, VPN recommended for stability

FAQ

Does Google AI (Gemini) have a free API?

Yes. Current yangmao.ai record: 免费 API 无需信用卡. Rate limit note: 15 RPM (Flash).

Is Google AI (Gemini) OpenAI-compatible?

The recorded setup uses an OpenAI-compatible pattern or SDK-style call. Validate the latest base URL and model names in Google AI (Gemini) docs.

Can I use Google AI (Gemini) from mainland China?

Google AI (Gemini) is marked as relatively direct or Mainland-China-friendly in the current tracker.

What should I do when Google AI (Gemini) credits run out?

Compare the alternatives below, check /en/free-ai-api/, and shortlist official providers or API gateway options before production.