Google AI Studio 与 Gemini 2.5 Pro 怎么用:访问 aistudio、创建 API 密钥、第一次提示与限速
打开 AI Studio,建好密钥,用 Gemini 2.5 Pro 发一条能核对结果的提示,再去 Rate limits 页看你自己项目的数字。
你想在浏览器里先试 Gemini 2.5 Pro,再决定要不要写进自己的脚本。官方入口是 aistudio.google.com(Google AI Studio):登录 Google 账号、创建 API 密钥、在 Playground 里选模型、发第一条能核对结果的提示。额度与限速以 AI Studio 里你项目当前显示的数字为准。
这篇写的是 Google AI Studio 与 Gemini 2.5 Pro:访问、API 密钥、第一次提示与限速。模型能力与限速只引用 ai.google.dev 官方文档,RPM 表以 AI Studio 里你项目当前显示为准。
谁该从 AI Studio 开始
适合
想快速试 Gemini 2.5 Pro、对比输出、或拿 API 密钥做原型。
不适合当终点
生产密钥放服务端或 Secret Manager,不要写进前端仓库。
| Step | Where | Official |
|---|---|---|
| Console | aistudio.google.com | api-key docs |
| Key | Dashboard → API Keys | ai.google.dev/.../api-key |
| Limits | Rate limits page | ai.google.dev/.../rate-limits |
| Model | Playground / API | gemini-2.5-pro |
一遍走完:登录、密钥、第一次提示
- 01打开 Google AI Studio 并登录
浏览器访问 aistudio.google.com,用 Google 账号登录。新用户接受服务条款后,官方 API 密钥文档写会自动创建默认 Cloud 项目并生成 API 密钥。已有 Cloud 账号的用户从 Dashboard → Projects 导入项目。
- 02创建或复制 API 密钥
Dashboard 打开 API Keys,点 Create API key。2026 年起新密钥默认为 auth 密钥;不要提交到 Git 或写进前端代码。本地可设 GEMINI_API_KEY 或 GOOGLE_API_KEY。
- 03在 Playground 选 Gemini 2.5 Pro
在模型列表选 Gemini 2.5 Pro(端点 gemini-2.5-pro)。官方模型页描述为 2.5 系列里面向复杂任务、深度推理与编码的型号。实验/预览变体通常限速更严。
- 04发第一条可核对的提示
只问一件能对照检查的事,例如用三句话解释 JSON 每个字段并列出假设类型。走 API 时把 model 设为 gemini-2.5-pro。
export GEMINI_API_KEY="your_key" # do not commit
curl "https://generativelanguage.googleapis.com/v1beta/models/gemini-2.5-pro:generateContent" \
-H "x-goog-api-key: $GEMINI_API_KEY" \
-H "Content-Type: application/json" \
-d '{"contents":[{"parts":[{"text":"Explain each key in three sentences"}]}]}'限速怎么读
- 限速按什么算
- 官方:按项目计,不是按单个 API 密钥。
- 三个常见维度
- RPM、TPM、RPD。任一超限返回 429 RESOURCE_EXHAUSTED。
- RPD 何时重置
- 太平洋时间午夜重置。
- 免费档与付费档
- Usage tiers 表决定上限;在 AI Studio Projects 页查看层级。
- 实验/预览模型
- 官方写明实验与预览型号限速更严;稳定端点 gemini-2.5-pro。
先登录 AI Studio,创建密钥,在 Playground 用 gemini-2.5-pro 发一条能核对结果的提示,再去 Rate limits 页看你自己项目的数字。
和 IDE 里的 Gemini 不是同一条路
浏览器里的 AI Studio 适合试模型和拿 API 密钥;VS Code 里的 Gemini Code Assist 走 Google Cloud 组织席位另一条线。要对齐一次 API 设计或提示词草稿,可以把要点摊在同一页。用 oakmeet 开一间会过期的房:浏览器、空间码、不用注册。房间边界见 八人、大约一小时。IDE 集成可对照 Gemini Code Assist 与 Cursor Agent。
新用户会自动有 API 密钥吗?
官方 API 密钥文档:新用户在 AI Studio 接受条款后会自动创建默认 Cloud 项目并生成 API 密钥。已有 Cloud 账号需导入项目再创建。
429 一定是 RPM 超限吗?
不一定。官方 rate-limits 与 troubleshooting 写明 RPM、TPM、RPD 以及付费档 10 分钟滚动消费限额都可能触发 429。
能把 API 密钥放在网页前端吗?
官方安全指引反对在生产客户端编译密钥;应通过后端代理或 Secret Manager。泄露密钥可能被封禁。
Gemini 2.5 Pro 和 2.5 Flash 怎么选?
官方模型页:Pro 面向复杂任务与深度推理;Flash 强调低延迟高吞吐性价比。高频调用先对比 Flash 在你项目里的限速。