Gemini Compatible
使用原生 generateContent 接口调用 Gemini 模型
使用支持第三方调用的 Gemini 分组 API Key，通过原生 generateContent 接口请求模型。AIGoCode 的 Gemini 分组不提供 OpenAI 兼容协议，客户端需要支持 Gemini 原生接口和自定义请求地址。
请求地址与认证
| 用途 | 地址 |
|---|---|
| 协议地址前缀 | https://api.aigocode.app/v1beta |
| 本页模型的完整请求地址 | POST https://api.aigocode.app/v1beta/models/gemini-3.8-flash:generateContent |
本页通过请求头 x-goog-api-key: YOUR_API_KEY 传入 Key。如果客户端会自动拼接 /v1beta，填写服务根地址 https://api.aigocode.app，避免路径重复。
先按 认证方式 设置环境变量 AIGOCODE_API_KEY。下方 curl 命令适用于 macOS / Linux；Windows Cmd、PowerShell 和 Python 示例见 第一次请求。
最小请求
curl "https://api.aigocode.app/v1beta/models/gemini-3.8-flash:generateContent" \
-H "x-goog-api-key: $AIGOCODE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"contents": [
{
"role": "user",
"parts": [
{
"text": "请只回复：Hello from AIGoCode!"
}
]
}
]
}'成功响应
以下为上述请求的实际返回，ID、时间和用量使用占位符。
{
"candidates": [
{
"content": {
"role": "model",
"parts": [
{
"thoughtSignature": "xxx",
"text": "Hello from AIGoCode!"
}
]
},
"finishReason": "STOP"
}
],
"usageMetadata": {
"promptTokenCount": xx,
"candidatesTokenCount": xx,
"totalTokenCount": xx,
"thoughtsTokenCount": xx
},
"modelVersion": "gemini-3.8-flash",
"responseId": "resp_xxx"
}