Gemini API 入门：从 AI Studio 到第一次调用

这篇解决什么： 如何把 Gemini 接到自己的应用，而不是只在网页里聊天。
适合谁： 已了解 Gemini 入门，要写服务端或脚本的人。
边界： 办公侧边栏见 Workspace；OpenAI 生态见 OpenAI API 入门。

密钥、模型 ID、SDK 包名以 Google AI / Gemini API 官方文档 为准（核对：2026-09-18）。下文不写死易变价目。

和「网页 Gemini」差在哪

	网页 / App	Gemini API
用途	人点一点完成任务	程序批量、嵌入产品
身份	Google 账号会话	API Key / 云凭证
责任	个人核对	你要做限流、日志、隐私、评测

调研工作流仍可先在产品里验证提示词：Gemini 调研。

起步步骤（稳定版）

1. 在官方控制台创建项目与 API Key（或云侧服务账号）。
2. Key 只放服务端；前端直出 Key 等于公开付费通道。
3. 用官方当前推荐的 SDK 发一次「最短文本生成」。
4. 打印模型名、用量字段（若有），确认计费项目正确。
5. 再加：超时、重试、内容安全过滤、输出长度上限。

示意（伪代码，方法名以你安装的 SDK 为准）：

// 伪代码：请替换为官方 SDK 的实际 client 与方法名
const reply = await gemini.generateText({
  model: '/* 控制台里的当前模型 ID */',
  prompt: '用三句话解释什么是向量检索。',
});
console.log(reply.text);

和 OpenAI API 对照时别踩的坑

• 消息格式、工具协议、安全设置字段都不同——不要假设「换个 base URL 就能跑」。
• 需要跨云抽象时，自己做一层 provider adapter。
• 结构化输出、流式、嵌入（若提供）各自查 Gemini 文档；OpenAI 侧对照：JSON/Vision、Embeddings、Responses。

何时用 API，何时用 Workspace

• 文档还在 Docs/Sheets 里协作 → Workspace 指南
• 要写入你们数据库/工单系统 → API
• 只要选型 ChatGPT vs Gemini → 双边对比

安全与合规

• 日志避免落盘用户隐私原文
• 地区与数据处理条款读官方；企业场景走企业合同与 VPC 选项（若有）
• 本站不提供「镜像 Gemini API」教程

相关阅读

• Gemini 教程中心
• Gemini 入门
• Gemini + Workspace
• ChatGPT vs Gemini
• OpenAI API 入门
• API 分类

使用入口

• 官方文档：ai.google.dev
• 体验 Gemini 对话