Google Gemini API Tester
Build, run and copy Google Gemini generateContent API requests as cURL, Python and JavaScript.
构建请求以及 cURL、Python 和 JavaScript 代码的过程完全在你的浏览器中完成。当你点击运行时,你的 Gemini API 密钥和提示词会从浏览器直接发送给 Google(generativelanguage.googleapis.com),而非 ArrayKit。密钥仅保留在本设备的浏览器内存中,绝不会被存储或发送给 ArrayKit。由于 Gemini 将密钥放在 URL 查询字符串中,它会出现在复制的代码片段里——请避免在共享机器上使用生产环境密钥,切勿将密钥粘贴到任何公开位置。
试用 OpenAI API 测试器
关于 Google Gemini API Tester
Gemini API 测试器让你无需离开浏览器即可构建、运行并复制 Google Gemini generateContent 请求。粘贴你的 Gemini API 密钥,选择像 gemini-1.5-flash、gemini-1.5-pro 或 gemini-2.0-flash 这样的模型,输入提示词,工具便会组装发送到 generativelanguage.googleapis.com 的 POST 请求,带有正确的 contents/parts JSON 请求体以及查询字符串中的密钥。点击运行即可发送调用并查看原始响应,或复制可直接使用的 cURL、Python 和 JavaScript 代码片段放入你自己的代码。它专为想要快速、省心地确认密钥是否可用、对比模型并获取样板代码的开发者、提示词工程师以及任何评估 Gemini 的人而设计。请求和代码在本地生成;运行时会将你的密钥和提示词直接发送给 Google。
功能特性
- 构建发送到 v1beta 端点的 Google Gemini generateContent POST 请求,密钥位于查询字符串中
- 带有 gemini-1.5-flash、gemini-1.5-pro 和 gemini-2.0-flash 建议的模型选择器
- 根据你的提示词自动生成正确的 contents 和 parts JSON 请求体
- 一键复制等效的 cURL、Python 和 JavaScript 代码
- 运行按钮实时发送调用并显示原始 JSON 响应或错误
- API 密钥的显示/隐藏切换,使其默认不可见
- API 密钥仅保留在浏览器内存中——绝不会被存储或发送给 ArrayKit
- 提供前往 Google AI Studio 创建 Gemini API 密钥的直接链接
如何使用 Google Gemini API Tester
- 将你的 Gemini API 密钥(以 AIza 开头)粘贴到密钥字段中
- 选择一个模型,如 gemini-1.5-flash,或输入你自己的模型
- 在提示词框中输入你的提示词
- 点击运行以发送请求并读取响应,或切换代码标签页并复制 cURL、Python 或 JavaScript
- 如果浏览器阻止了该调用,请复制 cURL 并从终端运行
示例
输入
curl "https://generativelanguage.googleapis.com/v1beta/models/gemini-1.5-flash:generateContent?key=YOUR_GEMINI_API_KEY" \
-H "Content-Type: application/json" \
-d '{"contents":[{"parts":[{"text":"Write a haiku about TypeScript."}]}]}'
输出
{
"candidates": [
{ "content": { "parts": [{ "text": "Types guard the morning..." }], "role": "model" } }
]
}
一个最简的 Gemini generateContent 请求及其响应结构。
常见错误与故障排除
- 浏览器以 CORS 或网络错误阻止运行。 — 浏览器并不总能直接调用 Gemini 端点。请改为复制生成的 cURL 或 Python,从终端或你的服务器运行。
- 400 API key not valid(API 密钥无效),或 PERMISSION_DENIED(权限被拒绝)。 — 检查来自 Google AI Studio 的密钥是否粘贴正确,以及该项目是否已启用 Generative Language API。
- 404 model not found(找不到模型)。 — 请使用有效的模型 id,如 gemini-1.5-flash、gemini-1.5-pro 或 gemini-2.0-flash;较旧或有区域限制的名称可能返回 404。
- 429 RESOURCE_EXHAUSTED / 配额超限。 — 你已触发速率或配额限制。请稍候重试,或在 Google Cloud 中为你的项目提升配额。
- 复制的代码片段中可见密钥。 — Gemini 密钥位于 URL 查询字符串中,因此会出现在 cURL 中。切勿将其提交或粘贴到任何公开位置;在实际代码中请使用环境变量。
常见问题
- 什么是 Gemini API 测试器?
- 它是一款 ArrayKit 工具,可根据密钥、模型和提示词构建 Google Gemini generateContent 请求,让你运行它们,并复制等效的 cURL、Python 和 JavaScript,从而快速测试 API。
- 我的 Gemini API 密钥会被发送给 ArrayKit 吗?
- 不会。请求和代码在你的浏览器本地构建。当你点击运行时,你的密钥和提示词会从浏览器直接发送给 Google 的 generativelanguage.googleapis.com 端点——绝不发送给 ArrayKit。密钥仅保留在浏览器内存中,绝不会被存储。
- 为什么运行会因 CORS 错误失败,而 cURL 却能用?
- Google 可能会阻止对 Gemini API 的直接浏览器源调用。生成的 cURL 或 Python 在不受 CORS 限制的终端或服务器中运行,因此请用它来确认该调用。
- 我可以测试哪些 Gemini 模型?
- 模型字段会建议 gemini-1.5-flash、gemini-1.5-pro 和 gemini-2.0-flash,你也可以输入你的密钥有权访问的任何其他模型 id。
- API 密钥在 Gemini 请求中放在哪里?
- Gemini 将密钥作为 v1beta generateContent URL 上的 ?key= 查询字符串参数,而不是放在 Authorization 请求头中,因此它会出现在复制的 URL 和 cURL 中。
- 在这里使用我的生产环境密钥安全吗?
- 请避免在共享或公共机器上使用生产环境密钥。密钥保留在本设备的浏览器内存中,但它会包含在复制的代码片段中,因此建议使用受限的密钥或测试密钥,若有泄露请及时轮换。
相关工具
全部 ArrayKit 工具