六、API 开发与接入指南

导读

本页主题：六、API 开发与接入指南。这篇内容会把相关信息按“先理解 → 再操作 → 最后排错/扩展”的顺序组织，把关键概念、入口与注意事项放在同一页里，方便你快速查阅与回看。

覆盖重点：产品形态、入口与权限、开发接入方式与典型集成方案。

你会得到什么

• 你将获得：核心概念图谱 + 关键入口 + 可执行步骤
• 适合人群：新手快速上手 / 已用过但想系统化
• 阅读建议：先看“导读/要点”，再按小节逐个核对
• 备注：以官方页面与产品实际可用性为准

快速开始（建议 3 分钟）

• 先浏览本页目录，找到与你目标最接近的小节
• 按步骤完成一次最小操作（例如：打开入口/创建 Key/跑通一次调用）
• 遇到问题先看“注意事项/常见问题”，再回到对应小节核对条件

六、API 开发与接入指南

API 密钥获取 访问 Google AI Studio 点击 "Create API Key" 选择项目或创建新项目 复制密钥（格式：AIza...） Gemini 3.1 Pro API 定价 表格 上下文长度 输入价格 输出价格 ≤200K tokens $2.00/百万 tokens $12.00/百万 tokens

200K tokens $4.00/百万 tokens $18.00/百万 tokens 上下文缓存：$0.31-$0.625/百万 tokens + 存储费 $4.50/百万 tokens/小时 模型 ID 对照表 表格 模型 模型 ID 适用场景 Gemini 3.1 Pro gemini-3.1-pro-preview 最新预览版，代码与 Agentic 任务 Gemini 2.5 Pro gemini-2.5-pro-preview-06-05 稳定版，通用复杂任务 Gemini 2.5 Flash gemini-2.5-flash-preview 高速响应，成本敏感场景 Gemini 2.5 Flash-Lite gemini-2.5-flash-lite-preview 极速、最便宜（输入 $0.1/百万 tokens） Gemini 3 Pro Image gemini-3-pro-image-preview 图像生成（Nano Banana Pro） Python 调用示例 Python 复制 from google import genai from google.genai.types import HttpOptions

client = genai.Client(http_options=HttpOptions(api_version="v1"))

response = client.models.generate_content( model="gemini-3.1-pro-preview", contents="Explain quantum computing in simple terms" ) print(response.text) 关键 API 端点 内容生成：POST /v1beta/models/{model}:generateContent 流式生成：POST /v1beta/models/{model}:streamGenerateContent 多模态嵌入：POST /v1beta/models/{model}:embedContent 批量预测：POST /v1beta/projects/{project}/locations/{location}/batchPredictionJobs 工具调用（Function Calling） Gemini 3.1 增强了函数调用可靠性，支持通过 tools 参数配置外部 API 和自定义工具。