如何用 Gemini 3.5 Flash API 搭建自动化编码助手:30 分钟完整教程
从注册 API 到搭建多步骤编码工作流,零基础也能上手的完整教学
入门 · 30 分钟 · 2026年5月20日
教程目标
在 30 分钟内,用 Gemini 3.5 Flash API 搭建一个自动化编码助手,实现代码生成、审查和重构三合一的工作流。本文是完整 step-by-step 教学。
你将搭建什么
- 编码助手核心:基于 Gemini 3.5 Flash 的代码生成与审查系统
- 自动化管道:从需求描述到代码输出的端到端工作流
- 质量监控:自动代码审查和重构建议
准备清单
- Google AI Studio 或 Gemini API 账号(免费额度可用)
- 基础 Python 和终端操作知识
- 一个 API 密钥(5 分钟可拿到)
总体架构
教学流程拆解为 4 个模块,按顺序推进即可。全部完成后,你将拥有一个可以实际使用的 AI 编码助手。
| 模块 | 输入 | 输出 | 预估时间 |
|---|---|---|---|
| 获取 API 密钥 | Google 账号 | Gemini API Key | 5 分钟 |
| 环境搭建 | 终端 | Python SDK 就绪 | 5 分钟 |
| 核心编码助手 | API 密钥 | 代码生成函数 | 12 分钟 |
| 自动化工作流 | 编码函数 | 完整管道 | 8 分钟 |
第 1 步:获取 Gemini 3.5 Flash API 密钥
Gemini 3.5 Flash 今天刚刚通过 Google I/O 2026 发布,可通过 Google AI Studio 直接获取。访问 Google AI Studio 并用 Google 账号登录:
- 点击右上角「Get API Key」
- 在 Google Cloud Console 创建或选择项目
- 启用 Gemini API,生成 API 密钥
- 复制密钥保存到安全位置
# 保存密钥为环境变量
export GEMINI_API_KEY="你的_API_密钥"提示:Gemini 3.5 Flash 定价为 $1.50/百万输入 token 和 $9.00/百万输出 token,比 2.5 Flash 贵了约 3 倍,但性能接近旗舰模型。对于个人开发者来说,免费额度足够日常使用。
第 2 步:安装 Python SDK 并验证连通性
Gemini 官方提供了 google-genai Python SDK,安装非常简单:
# 安装 Gemini Python SDK
pip install google-genai
# 验证安装
python3 -c "import google.genai; print('SDK ready')"接下来验证 API 连通性:
from google import genai
client = genai.Client(api_key="你的_API_密钥")
response = client.models.generate_content(
model="gemini-3.5-flash",
contents="用 Python 写一个快速排序函数"
)
print(response.text[:200])如果看到生成的代码输出,说明 API 正常工作。
| 配置项 | 值 | 说明 |
|---|---|---|
| 模型名 | gemini-3.5-flash | 稳定版,非 preview |
| 输入定价 | $1.50/M tokens | 百万 token 计算 |
| 输出定价 | $9.00/M tokens | 含思维链 token |
| 上下文窗口 | 1,000,000 tokens | 适合长文件处理 |
第 3 步:搭建编码助手核心功能
有了 SDK 基础,我们来搭建一个多功能编码助手。这个函数可以处理代码生成、审查和重构三大任务:
from google import genai
import os
client = genai.Client(api_key=os.environ["GEMINI_API_KEY"])
def coding_assistant(task_type, input_text):
"""多功能编码助手:generate / review / refactor"""
prompts = {
"generate": f"请根据以下需求生成完整可运行的代码,包含必要注释:
{input_text}",
"review": f"请审查以下代码,指出问题、安全漏洞和优化建议:
{input_text}
"refactor": f"请重构以下代码,提高可读性和性能:
{input_text}
}
response = client.models.generate_content(
model="gemini-3.5-flash",
contents=prompts.get(task_type, input_text),
config={
"temperature": 0.3, # 编码任务降低随机性
"max_output_tokens": 4096
}
)
return response.text
# 测试:生成一个简单的 Web 服务器
result = coding_assistant("generate", "用 Python Flask 写一个 REST API,包含用户 CRUD 操作")
print(result[:500])提示:Gemini 3.5 Flash 在编码任务上表现非常出色——Google 官方将其定位为「最强的 agentic 和 coding 模型」。它的思维链能力让代码输出质量接近 Anthropic Claude。
第 4 步:搭建自动化多步骤编码工作流
这是最关键的一步——将编码助手封装为自动化管道,实现从需求到最终代码输出的完整流程:
import json
from google import genai
client = genai.Client(api_key=os.environ["GEMINI_API_KEY"])
class CodingPipeline:
def __init__(self):
self.history = []
def generate_code(self, requirement):
step1 = client.models.generate_content(
model="gemini-3.5-flash",
contents=f"作为资深工程师,请分析以下需求并输出技术设计方案:
{requirement}"
)
design = step1.text
self.history.append({"step": "design", "output": design[:200]})
step2 = client.models.generate_content(
model="gemini-3.5-flash",
contents=f"基于以下设计方案,生成完整可运行的代码:
{design}"
)
code = step2.text
self.history.append({"step": "code", "output": code[:200]})
step3 = client.models.generate_content(
model="gemini-3.5-flash",
contents=f"审查以下代码并输出优化建议:
{code}"
)
review = step3.text
self.history.append({"step": "review", "output": review[:200]})
return {"design": design, "code": code, "review": review}
# 使用管道
pipeline = CodingPipeline()
result = pipeline.generate_code("一个命令行 Todo 应用,支持添加、删除、标记完成")
print(json.dumps(result, indent=2))进阶:接入 n8n 自动化
将这个编码管道接入 n8n,可以让 AI 编码助手自动响应 GitHub Issue、Slack 消息或定时任务。推荐使用 n8n Cloud 托管节点,省去自建服务器的麻烦。
有人实践成功 AI 自动化工作流后实现了可观收入:一位自由开发者通过 Claude Code + n8n 搭建 AI 自动化系统,6 个月从 $4,000 做到 $12,000/月。另一位数据分析师也通过类似方案达到 月入 $3,800。
常见问题排查(FAQ)
Q1:API 返回 429 Too Many Requests?
Gemini API 有免费额度限制,建议使用 time.sleep() 控制请求间隔,或升级到付费套餐。
Q2:代码输出不完整?
检查 max_output_tokens 设置,Gemini 3.5 Flash 默认输出较短,建议设为 4096 或更高。
Q3:Gemini 3.5 Flash 和 Claude Code 怎么选?
Gemini 3.5 Flash 胜在速度(推理更快)和性价比($9/M 输出 vs Claude 的 $15/M)。如果你是预算敏感的独立开发者,推荐通过 OpenRouter 统一管理多个模型,按需切换。
SEO+GEO:FAQ 结构满足 GEO 提取偏好,同时覆盖长尾搜索词
工具词条(触发工具悬浮卡)
正文中自然出现的工具名,平台侧会匹配已维护 tools 库生成 hover-card:Gemini、Gemini API、Google AI Studio、Python、n8n、Claude Code、OpenRouter、Google Cloud
参考视频/素材
- Google Blog: Gemini 3.5 正式发布公告
- Google AI Dev: Gemini 3.5 Flash API 文档
- HN 讨论: Gemini 3.5 Flash (588 points)
内链引导
- 成功案例:他用 Claude + n8n 搭建 AI 自动化系统,6 个月从 $4,000 到 $12,000/月
- 推荐工具:通过 OpenRouter 统一管理多模型 API 调用
相关推荐
Cursor FAQ: 15 Common Questions about AI Code Editor (2026)
Evaluating Cursor as your AI code editor? This FAQ answers the 15 most common questions from real developers: How much does Cursor cost? Cursor vs Copilot vs Claude Code? Can I use my own API key? Is it good for beginners? Based on extensive hands-on testing with all three tools, this guide gives you straight answers with no fluff.
Cursor AI Editor Complete Guide 2026: Setup, Pricing, Composer & Design Mode
Cursor is the AI-first code editor built on VS Code that combines in-editor AI chat, Composer agent, Design Mode, and Bugbot. This complete 2026 guide covers installation, VS Code migration, pricing plans, Composer agentic coding, Design Mode visual editing, SDK 3.7 custom tools, and how Cursor compares to Claude Code and GitHub Copilot.
主题中心
2026 AI 编程工具全景指南
从 Copilot 改版到 Claude Code / DeepSeek 低成本方案——把分散资讯收成可搜索、可对比的工具矩阵。
进入「2026 AI 编程工具全景指南」 →赚钱视角
这个趋势怎么赚钱?
WayToClawEarn 的差异在可验证的赚钱案例,而不只是资讯。从这些复盘开始:
浏览全部案例 →