Gemini generateContent

Google Gemini 官方原生格式。注意前缀是 /api/v1beta(不是 /api/v1),model 在路径里。

生产环境POSThttps://api.lolai.lol/v1beta/models/{model}:generateContent

前缀是 /api/v1beta,不是 /api/v1。流式把方法换成 :streamGenerateContent?alt=sse。

请求参数

Path 参数

modelstring必填

Gemini 系列模型,写在路径里(/models/{model}:generateContent),完整列表见模型广场。

示例:gemini-2.5-flash

Header 参数

Authorizationstring必填

API Key,格式 Bearer <key>。

示例:Bearer sk-lolai-xxx

Content-Typestring必填

示例:application/json

Body 参数application/json

contentsarray必填

对话内容,每项 { role?, parts: [{ text } | { inlineData }] }。

示例:[{"parts":[{"text":"hi"}]}]

generationConfigobject可选

采样配置:temperature / topP / topK / maxOutputTokens 等。

示例:{"temperature":0.7}

systemInstructionobject可选

系统指令。

示例:{"parts":[{"text":"..."}]}

toolsarray可选

函数声明(functionDeclarations)等工具。

safetySettingsarray可选

安全阈值配置。

能力

流式(streamGenerateContent)、函数调用、多模态(inlineData 图片)等都按 Gemini 原生格式生效。
不想绑 Gemini 格式?用 Chat Completions 一套 OpenAI 代码跨厂商切模型,我们自动翻译。

请求与响应体

用下面的示例确认请求格式与返回结构。需要在线发起请求时,点击页面顶部「调试」拉起在线运行面板。

curl https://api.lolai.lol/v1beta/models/gemini-2.5-flash:generateContent \
  -H "Authorization: Bearer sk-lolai-xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{ "parts": [{ "text": "你好" }] }]
  }'

响应 · 200

{
  "candidates": [{
    "content": { "role": "model", "parts": [{ "text": "你好!" }] },
    "finishReason": "STOP"
  }],
  "usageMetadata": {
    "promptTokenCount": 4,
    "candidatesTokenCount": 12,
    "totalTokenCount": 16
  }
}