跳到正文
土土金API

API 参考

Gemini generateContent 原生接口

Gemini 原生接口 generateContent 的请求头、路径、参数、请求与响应示例。格式与 Google Gemini API 一致,Google Gen AI SDK 改 base URL 即可使用,已在本站实测。

Gemini 原生接口按 Google Gemini API 的格式收发数据:模型名写在 URL 路径里,请求体用 contents 和 parts 组织对话,生成参数放进 generationConfig。已经用 Google Gen AI SDK 写好的代码,把 base URL 改成 https://www.tutujin.com 即可。本接口(generateContent)已在本站实测。

POSThttps://www.tutujin.com/v1beta/models/gemini-3.8-flash:generateContent

路径格式是 /v1beta/models/模型名:generateContent,把模型名换成你要调用的模型,请求体里不需要再写 model。

请求头

请求头必填说明
x-goog-api-key二选一控制台创建的 API Key(sk-...)。Google Gen AI SDK 默认用这个请求头
Authorization二选一Bearer sk-...,和 x-goog-api-key 任选一种
Content-Type是application/json

请求参数

参数类型必填说明
contentsarray是对话内容,按时间顺序排列。每项包含 role(user 或 model)和 parts
contents[].partsarray是内容片段。文本写 {"text": "..."};图片、PDF 等用 inlineData,包含 mimeType 和 base64 编码的 data
systemInstructionobject否系统提示词,结构和一条内容相同,例如 {"parts": [{"text": "..."}]}
generationConfigobject否生成参数,见下表
safetySettingsarray否按类别设置安全过滤阈值
toolsarray否工具,例如 functionDeclarations 函数声明
toolConfigobject否函数调用模式,例如只允许调用指定函数

generationConfig

字段类型说明
temperaturenumber采样温度,越高越发散
topPnumber核采样
topKinteger只从概率最高的 K 个 token 里采样
maxOutputTokensinteger本次最多生成多少 tokens
stopSequencesarray遇到这些字符串时停止生成
responseMimeTypestring设为 application/json 时要求输出 JSON
responseSchemaobject配合 JSON 输出使用的结构定义
thinkingConfigobject思考配置,例如 {"thinkingBudget": 1024};支持的字段因模型而异
candidateCountinteger返回几个候选回答

请求示例

curl "https://www.tutujin.com/v1beta/models/gemini-3.8-flash:generateContent" \
  -H "x-goog-api-key: $TUTUJIN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "systemInstruction": {"parts": [{"text": "你是电商运营助手,回答简洁。"}]},
    "contents": [
      {"role": "user", "parts": [{"text": "给一款 500ml 保温杯写 3 个卖点"}]}
    ],
    "generationConfig": {"temperature": 0.7, "maxOutputTokens": 512}
  }'

SDK 会在 base URL 后面拼接 /v1beta/models/...,所以 base URL 只填站点根地址。

响应示例

JSON
{
  "candidates": [
    {
      "content": {
        "role": "model",
        "parts": [{ "text": "1. 双层真空,保温 12 小时……" }]
      },
      "finishReason": "STOP",
      "index": 0
    }
  ],
  "usageMetadata": {
    "promptTokenCount": 28,
    "candidatesTokenCount": 96,
    "totalTokenCount": 124
  },
  "modelVersion": "gemini-3.8-flash"
}
字段说明
candidates[].content.parts[].text模型的回答,可能分成多个片段
candidates[].finishReasonSTOP 正常结束;MAX_TOKENS 达到生成上限;SAFETY 被安全过滤拦截
usageMetadata.promptTokenCount输入 tokens,按输入单价计费
usageMetadata.candidatesTokenCount输出 tokens,按输出单价计费
usageMetadata.thoughtsTokenCount思考 tokens,开启思考的模型才有,计入输出
usageMetadata.cachedContentTokenCount命中缓存的输入 tokens,出现时按缓存读取价计费

流式输出

Gemini 的流式接口路径是 /v1beta/models/模型名:streamGenerateContent?alt=sse,SDK 里对应 generate_content_stream(Python)和 generateContentStream(Node.js)。

流式请求会按原格式转发,但本站没有单独实测 Gemini 原生格式的流式输出,上线前请先用小流量自测。也可以改用 Chat Completions 格式调用目录里支持该接口的 Gemini 模型,用 "stream": true 获取流式输出。

注意事项

  • 模型名写在 URL 路径里,大小写要和模型广场一致。
  • 对话里模型一方的 role 是 model,不是 assistant。
  • 图片、PDF 等文件用 inlineData 以 base64 放进请求体;文件越大,请求体越大,注意控制大小。
  • 开启思考的模型,思考 tokens 计入输出,可以用 thinkingConfig 控制预算。
  • 不同 Gemini 分组的线路和价格不同,见选择分组。同一个 Gemini 模型通常也可以用 Chat Completions 调用,方便和其他厂商的模型共用一套代码。

支持此接口的模型

模型厂商最低价分组输入 ¥/百万输出 ¥/百万按次 ¥/次
gemini-3.8-flashGoogle标准¥1.5¥7.5—
gemini-3.1-pro-previewGoogle标准¥4¥24—
gemini-2.5-flash-imageGoogleGemini 优质——¥0.16
Nano-bananaGoogleGemini 优质——¥0.16
gemini-nano-banana-2.1-2kGoogle标准——¥0.2
gemini-nano-banana-2.1-4kGoogle标准——¥0.2
gemini-nano-banana-2.1Google标准——¥0.2
gemini-3.1-flash-lite-imageGoogleGemini 优质——¥0.2

价格为人民币,取各模型最低价分组;价格更新于 2026年11月13日 18:03。

共 63 个模型支持此接口,上表列出其中一部分。 在模型广场查看全部

没找到答案?加客服微信 JsnonoChat,发送报错信息里的 request id,我们帮你排查。