← 返回 Blog
UseAIAPIAI API2min

Gemini API Key 获取完整指南（2026版）：从 aistudio.google.com 登录到第一条 curl 请求，一步不跳

很多开发者在初次接触 Gemini API 时，常常被官方分散的文档和隐藏的细节卡住。本文将梳理从账号登录、密钥生成、终端验证到 Python 代码接入的完整流程，不省略任何关键步骤，同时汇总实际操作中最容易踩坑的环节，帮助开发者快速打通第一条 API 调用链路。

GeminiGemini API 密钥

Gemini API 密钥完整上手指南：从登录到代码调用全流程

很多开发者在初次接触 Gemini API 时，常常被官方分散的文档和隐藏的细节卡住。本文将梳理从账号登录、密钥生成、终端验证到 Python 代码接入的完整流程，不省略任何关键步骤，同时汇总实际操作中最容易踩坑的环节，帮助开发者快速打通第一条 API 调用链路。

一、获取 API 密钥：唯一官方入口

Gemini API 的密钥只能通过 Google AI Studio 平台获取，这是官方指定的唯一通道，具体操作步骤如下：

  1. 打开浏览器访问官方平台：https://aistudio.google.com
  2. 使用 Google 账号（Gmail 邮箱）登录，没有账号可直接在页面注册
  3. 登录后仔细阅读并接受 Gemini API 服务条款，特别注意数据共享和使用范围相关条款
  4. 登录成功后，在左侧导航栏找到「🔑 获取 API 密钥」选项，或直接访问快捷地址：https://aistudio.google.com/app/apikey
  5. 点击「创建 API 密钥」按钮，系统会提供两个选项：在已有 Google Cloud 项目下创建，或新建项目

    • 新手开发者建议直接选择「新建项目」，输入项目名称（如 my-first-ai-app）后一路确认即可

  6. 免费层用户无需绑定信用卡，完成上述步骤即可获得可用的 API 密钥

重要安全提示

生成成功后，页面会显示一串以AIzaSy开头的密钥字符串。请立即将其复制到密码管理器或加密备忘录中保存 —— 页面关闭后将无法再次查看完整密钥，只能删除旧密钥并重新生成。

二、终端验证：先确认通路再写代码

拿到密钥后，不要急于打开 IDE 编写代码。建议先通过终端工具进行一次最小化验证，确认 API 通路是否正常：

  • macOS/Linux 系统使用 Terminal 终端
  • Windows 系统使用 PowerShell 终端

将以下命令中的YOUR_API_KEY替换为你刚复制的密钥，然后在终端中执行：

bash

运行

curl -X POST \
  "https://generativelanguage.googleapis.com/v1beta/models/gemini-2.5-flash:generateContent?key=YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [
      {
        "parts": [
          { "text": "你好，Gemini。用一句话介绍你自己。" }
        ]
      }
    ]
  }'

结果判定与常见问题

  • ✅ 验证成功：返回的 JSON 数据中包含candidates字段，且content.parts[0].text有非空内容
  • ❌ 验证失败：若返回error: { "code": 400, "message": "API key not valid" }，通常是以下两种原因：

    1. 密钥复制不完整（最常见错误）
    2. 对应项目未启用 Generative Language API

      • 解决方法：访问https://console.cloud.google.com，选中对应项目，进入「API 与服务→库」，搜索并启用「Generative Language API」后重试

三、Python 代码接入：官方推荐的 SDK 方式

终端验证通过后，即可进入代码开发环节。Google 目前官方推荐使用google-genai Python SDK，这是最新的开发体系，使用更加便捷。

3.1 安装 SDK

执行以下命令安装最新版本的 SDK：

bash

运行

pip install -U google-genai

3.2 配置环境变量（严禁硬编码密钥）

不要将 API 密钥直接写在代码中，建议通过环境变量管理。可以在项目根目录创建.env文件，或直接在终端中导出：

bash

运行

export GOOGLE_API_KEY="AIzaSy..."

注意：原文中出现的GOOGLE-API_KEY（带横杠）是无效的环境变量名，标准写法为GOOGLE_API_KEY，SDK 也会识别GEMINI_API_KEY等别名，但GOOGLE_API_KEY兼容性最好。

3.3 最小可运行脚本

创建一个 Python 文件，写入以下代码：

python

运行

from google import genai

# 不传入api_key参数时，Client会自动读取环境变量GOOGLE_API_KEY
client = genai.Client()

response = client.models.generate_content(
    model="gemini-2.5-flash",
    contents="用三个词描述今天的编程心情"
)

print(response.text)

运行该脚本，若能正常输出结果，说明你已完成从申请密钥到代码接入的完整链路。

结语

掌握 Gemini API 的基础调用只是 AI 开发的第一步。随着项目复杂度提升，开发者可能会遇到免费配额不足、多模型切换困难、企业级稳定性要求高等问题。

UseAIAPI作为一站式大模型服务平台，聚合了 Gemini、Claude、ChatGPT、DeepSeek 等全球主流前沿 AI 大模型，提供稳定可靠的企业级定制化服务，无需复杂配置即可快速接入使用。平台推出了极具竞争力的优惠政策，全线服务最低可享官方定价 5 折，大幅降低了高强度开发和内容生产场景下的使用成本，让更多开发者和企业能够以更低的门槛享受到先进 AI 技术带来的效率提升。