Gemini generateContent

Google Gemini 官方原生格式。路径前缀为 /v1beta（不是 /v1），model 位于 URL 路径中。

POSThttps://zerofa.ai/v1beta/models/{model}:generateContent

路径前缀必须使用 /v1beta。流式请求将方法改为 :streamGenerateContent?alt=sse。

请求参数

Path 参数

modelstring必填

Gemini 系列模型，写在 /models/{model}:generateContent 路径中。完整列表见模型广场。

示例：gemini-3-flash-preview

Header 参数

x-goog-api-keystring必填

Gemini 原生鉴权头，填入 sk-zerofa-*。也兼容 Authorization: Bearer <key>。

示例：sk-zerofa-xxx

Content-Typestring必填

示例：application/json

Body 参数application/json

contentsarray必填

对话内容。每项包含 role（可选）和 parts，part 可为 text 或 inlineData。

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

generationConfigobject可选

采样配置，包括 temperature、topP、topK 和 maxOutputTokens 等。

示例：{"temperature":0.7}

systemInstructionobject可选

系统指令。

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

toolsarray可选

函数声明（functionDeclarations）等工具。

safetySettingsarray可选

安全阈值配置。

能力

流式、函数调用和 inlineData 图片等多模态能力均按 Gemini 原生格式生效。
如不希望绑定 Gemini 格式，可使用 Chat Completions 通过同一套 OpenAI 代码跨厂商切换模型，ZeroFA 会自动转换。

请求与响应体

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

curl https://zerofa.ai/v1beta/models/gemini-3-flash-preview:generateContent \
  -H "x-goog-api-key: sk-zerofa-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
  }
}