Google AI Studio / Gemini API

Gemini API 第一次调用

api

EndpointEndpoint

https://generativelanguage.googleapis.com/v1beta

认证Authentication

x-goog-api-key: API Key

前置条件Prerequisites

• Google AI Studio 支持地区内可用的 Google 账号Google AI Studio Google
• 从 Google AI Studio API Keys 页面获取密钥Google AI Studio API Keys
• 从当前模型列表确认目标 Gemini 模型及其 Free Tier 状态Gemini Free Tier

操作步骤Steps

1. 创建或查看 API Key

   登录 Google AI Studio，在 API Keys 页面创建或查看项目密钥。将密钥保存到 GEMINI_API_KEY 环境变量，不要写进源码、截图或公开仓库。

   操作Action：打开 https://aistudio.google.com/app/apikey

2. 确认模型和免费层级

   先在官方模型与定价页面确认模型是否有 Free Tier，以及账号所在地区能否使用。模型清单和速率限制会变化。

   操作Action：打开 https://ai.google.dev/gemini-api/docs/pricing

3. 发送 REST 请求

   将模型名替换为当前官方模型页确认的可用 ID。

   可复制命令Copyable command复制命令Copy command

   export GEMINI_API_KEY="你的 Key"
   curl https://generativelanguage.googleapis.com/v1beta/models/gemini-3.8-flash:generateContent -H 'Content-Type: application/json' -H "x-goog-api-key: $GEMINI_API_KEY" -d '{"contents":[{"parts":[{"text":"用一句话解释 API 是什么。"}]}]}'

   预期结果Expected：返回 candidates[0].content.parts 中的文本；到 Google AI Studio Usage 页面检查请求与用量。

4. Python SDK 示例

   Python 3.9+；SDK 从 GEMINI_API_KEY 环境变量读取密钥。

   可复制命令Copyable command复制命令Copy command

   python -m pip install -U google-genai
   
   from google import genai
   
   client = genai.Client()
   response = client.models.generate_content(
       model="gemini-3.8-flash",
       contents="用一句话解释 API 是什么。",
   )
   print(response.text)

   预期结果Expected：终端打印模型生成的文本；若模型不可用，先从当前官方模型清单复制模型 ID。

5. Node.js SDK 示例

   安装官方 Google Gen AI SDK；确保启动终端的环境中已设置 GEMINI_API_KEY。

   可复制命令Copyable command复制命令Copy command

   npm install @google/genai
   
   import { GoogleGenAI } from "@google/genai";
   
   const ai = new GoogleGenAI({});
   const response = await ai.models.generateContent({
     model: "gemini-3.8-flash",
     contents: "用一句话解释 API 是什么。",
   });
   console.log(response.text);

   预期结果Expected：Node.js 打印模型生成的文本。

官方来源Official sources

• https://ai.google.dev/gemini-api/docs/get-started ↗
• https://ai.google.dev/gemini-api/docs/pricing ↗
• https://ai.google.dev/gemini-api/docs/models ↗