Gemini GenerateContent
Gemini 原生 GenerateContent 与 streamGenerateContent 接口。
Gemini 是独立协议入口
客户端按 Google Gemini 原生路径请求，顶级AI按 Gemini 协议选择模型、转发、提取 usageMetadata 并结算。
路径
| 用途 | 方法与路径 |
|---|---|
| 非流式生成 | POST /v1beta/models/{model}:generateContent |
| 流式生成 | POST /v1beta/models/{model}:streamGenerateContent |
| 模型列表 | GET /v1beta/models 或 GET /v1beta/models/ |
请求路径必须包含 /v1beta/models/ 前缀。{model} 这一段可以写 gemini-2.5-flash 或 models/gemini-2.5-flash，网关只会归一化模型值内部的 models/ 前缀；模型列表响应会按 Gemini 习惯返回 models/{publicModel}。
鉴权
x-goog-api-key 填用户 Key
x-goog-api-key 里填写顶级AI用户 API Key，不是 Google 官方后台的 provider Key。
完整 Header 规则见 Base URL 与鉴权 和 请求头。本页示例统一使用 x-goog-api-key。Bearer 只作为兼容方式；x-api-key 和 URL ?key= 会被拒绝。
非流式请求
curl https://dingjiai.com/v1beta/models/gemini-2.5-flash:generateContent \
-H "x-goog-api-key: YOUR_USER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"contents": [
{
"role": "user",
"parts": [
{ "text": "用一句话介绍顶级AI网关" }
]
}
]
}'请求体里的 model 和 stream 字段不会作为顶级AI模型选择依据。模型以路径里的 {model} 为准。
流式请求
curl -N https://dingjiai.com/v1beta/models/gemini-2.5-flash:streamGenerateContent \
-H "x-goog-api-key: YOUR_USER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"contents": [
{
"role": "user",
"parts": [
{ "text": "列出三个接入注意事项" }
]
}
]
}'Gemini 流式必须使用 streamGenerateContent 路径。generateContent 请求体里写 "stream": true 会返回 stream_not_supported。
usageMetadata 与结算
Prop
Type
非流式响应需要带 usageMetadata。流式响应正常读到可用 usageMetadata 时才会结算，并会保留最后一个有效 usageMetadata；上游断流、客户端取消、缺少 usageMetadata 或格式不合法，本次调用会按失败处理。
模型列表
curl https://dingjiai.com/v1beta/models \
-H "x-goog-api-key: YOUR_USER_API_KEY"模型列表只返回当前服务公开可见、已启用，并且存在可用上游候选的 Gemini 模型。每个模型的 supportedGenerationMethods 包含 generateContent 和 streamGenerateContent。
最后更新于