Gemini API 第一次调用
api
- EndpointEndpoint
https://generativelanguage.googleapis.com/v1beta- 认证Authentication
- x-goog-api-key: API Key
额度与限制Limits
官方 Free Tier 按模型与账号项目分别设置限额；具体 RPM、token/minute 与每日限制在 AI Studio Usage / 官方定价页核对。
前置条件Prerequisites
- Google AI Studio 支持地区内可用的 Google 账号Google AI Studio Google
- 从 Google AI Studio API Keys 页面获取密钥Google AI Studio API Keys
- 从当前模型列表确认目标 Gemini 模型及其 Free Tier 状态Gemini Free Tier
操作步骤Steps
- 创建或查看 API Key
登录 Google AI Studio，在 API Keys 页面创建或查看项目密钥。将密钥保存到 GEMINI_API_KEY 环境变量，不要写进源码、截图或公开仓库。
操作Action：打开 https://aistudio.google.com/app/apikey
- 确认模型和免费层级
先在官方模型与定价页面确认模型是否有 Free Tier，以及账号所在地区能否使用。模型清单和速率限制会变化。
操作Action：打开 https://ai.google.dev/gemini-api/docs/pricing
- 发送 REST 请求
将模型名替换为当前官方模型页确认的可用 ID。
命令已在上方「快速上手」给出。The copyable command already appears in Quick start above.
预期结果Expected：返回 candidates[0].content.parts 中的文本；到 Google AI Studio Usage 页面检查请求与用量。
- Python SDK 示例
Python 3.9+；SDK 从 GEMINI_API_KEY 环境变量读取密钥。
可复制命令Copyable commandpython -m pip install -U google-genai from google import genai client = genai.Client() response = client.models.generate_content( model="gemini-3.8-flash", contents="用一句话解释 API 是什么。", ) print(response.text)预期结果Expected：终端打印模型生成的文本；若模型不可用，先从当前官方模型清单复制模型 ID。
- Node.js SDK 示例
安装官方 Google Gen AI SDK；确保启动终端的环境中已设置 GEMINI_API_KEY。
可复制命令Copyable commandnpm install @google/genai import { GoogleGenAI } from "@google/genai"; const ai = new GoogleGenAI({}); const response = await ai.models.generateContent({ model: "gemini-3.8-flash", contents: "用一句话解释 API 是什么。", }); console.log(response.text);预期结果Expected：Node.js 打印模型生成的文本。
验证动作Validation
响应包含 candidates 文本；在 AI Studio Usage 页面确认请求记入预期项目与层级。
常见问题Common issues
- 400 或 403：检查 API Key、项目权限、模型 ID 与账号地区支持情况。400 403： API Key、 、 ID 。
- 429：查看 AI Studio Usage 中该模型的速率限制与配额重置时间；降低请求频率后再试。429： AI Studio Usage ； 。
- 免费层级不用于敏感数据；Google 官方定价说明 Free Tier 内容可能用于改进产品。；Google Free Tier 。