Gemini 协议

使用 Gemini generateContent 格式发送内容。

服务地址

本页覆盖 Gemini 原生 REST 的模型列表、内容生成、流式生成和嵌入接口。Gemini 图像参数请查看图片与视频生成中的 Gemini 原生图片指南。

模型与发现

用途	方法	路径
Gemini 模型列表	GET	/v1beta/models
Gemini 兼容模型列表	GET	/v1/models

内容生成

用途	方法	路径
generateContent	POST	/v1beta/models/{model}:generateContent
streamGenerateContent	POST	/v1beta/models/{model}:streamGenerateContent

嵌入

用途	方法	路径
embedContent	POST	/v1beta/models/{model}:embedContent
batchEmbedContents	POST	/v1beta/models/{model}:batchEmbedContents
Gemini 兼容嵌入	POST	/v1/engines/{model}/embeddings

最小请求

将 YOUR_MODEL 替换为实际模型 ID，并放在 URL 路径中。推荐使用 x-goog-api-key: YOUR_API_KEY；网关也兼容 Bearer，只有客户端明确要求时才使用查询参数 key，避免 Key 出现在日志和历史记录中。

curl "https://api.popgo.site/v1beta/models/YOUR_MODEL:generateContent" \
  -H "x-goog-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [
      {"parts": [{"text": "请回复连接成功"}]}
    ]
  }'

验证

成功响应包含候选内容或嵌入结果。流式请求使用 streamGenerateContent；嵌入请求根据客户端选择 embedContent、batchEmbedContents 或兼容路径。出现 404 时检查模型 ID、协议路径和 Key 分组。