API 接入Gemini
Gemini Generate Content
Google Gemini 原生请求格式
接口
POST
https://www.yunqiai.chat/v1beta/models/gemini-3.5-flash:generateContent所有请求使用 HTTPS，并通过请求头携带访问密钥。
请求参数
| 参数 | 类型 | 说明 |
|---|---|---|
contents必填 | array | Content 数组，每项含 role 与 parts |
systemInstruction | object | 系统指令，结构同 Content |
generationConfig.maxOutputTokens | integer | 最大输出 Token；上限随模型变化 |
generationConfig.temperature | number | 通常为 0–2，实际默认值与范围以模型为准 |
generationConfig.topP | number | 0–1 的核采样阈值 |
generationConfig.stopSequences | string[] | 停止序列 |
safetySettings | array | 按危害类别设置安全阈值 |
请求示例
curl --request POST \
--url https://www.yunqiai.chat/v1beta/models/gemini-3.5-flash:generateContent \
--header "x-goog-api-key: YOUR_API_KEY" \
--header "Content-Type: application/json" \
--data '{
"contents": [
{
"parts": [
{
"text": "你好，请介绍一下你自己"
}
]
}
]
}'Base64 图片输入
Gemini 使用 inlineData，data 字段只放裸 Base64，MIME 类型放在 mimeType。
{
"contents": [
{
"parts": [
{
"text": "描述这张图片"
},
{
"inlineData": {
"mimeType": "image/png",
"data": "BASE64_IMAGE_DATA"
}
}
]
}
],
"generationConfig": {
"maxOutputTokens": 256
}
}响应
{
"candidates": [
{
"content": {
"role": "model",
"parts": [
{
"text": "你好！我是一个 AI 助手。"
}
]
},
"finishReason": "STOP"
}
],
"modelVersion": "gemini-3.5-flash"
}协议参考
本页示例按 YunQi AI 的模型 ID、接口路径和参数格式编写；以下链接提供对应协议的字段说明。