路径前缀必须使用 /v1beta。流式请求将方法改为 :streamGenerateContent?alt=sse。
请求参数
Path 参数
modelstring必填Gemini 系列模型，写在 /models/{model}:generateContent 路径中。完整列表见模型广场。
示例：
your-gemini-model-idHeader 参数
x-goog-api-keystring必填Gemini 原生鉴权头，填入 sk-zerofa-*。也兼容 Authorization: Bearer <key>。
示例：
sk-zerofa-xxxContent-Typestring必填示例：
application/jsonBody 参数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/your-gemini-model-id: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
}
}