用 curl 测试 Gemini API：请求与回应解析

不想装任何 SDK？通过命令行原生 cURL 构造标准 POST 请求，全景拆解 HTTP 标头、JSON Payload 结构与状态码返回。

一、单行 cURL 终端极简测试指令

无需安装任何外部语言运行时，直接在终端中粘贴以下命令：
curl "https://generativelanguage.googleapis.com/v1beta/models/gemini-1.5-flash:generateContent?key=$GEMINI_API_KEY" \
-H 'Content-Type: application/json' \
-X POST \
-d '{
"contents": [{
"parts":[{"text": "写一首五言绝句赞美春天"}]
}]
}'

二、响应体核心字段深度拆解

API 返回的 JSON 包含以下关键路径：
- candidates[0].content.parts[0].text：模型生成的实际文本结果；
- candidates[0].finishReason：生成结束状态，正常为 STOP，若为 SAFETY 则代表被安全过滤器阻断；
- usageMetadata：展示 promptTokenCount（输入消耗）与 candidatesTokenCount（输出消耗）。

三、基础密钥申请指南

尚未获取密钥的开发者，请先参考：[Gemini API 密钥快速申请教程](https://aihuiyuan.club/articles/gemini-api-key-google-ai-studio-free)。