API 接口文档
Gemini
POST
https://api.tokenbay.com/v1beta/models/{model}:generateContentGemini 原生路径
Gemini 路径
Gemini 生成路径使用模型名和动作拼在 URL 中，模型名不从 JSON body 的 model 字段解析。
gemini
POST
/v1beta/models/{model}:generateContentPOST
/v1beta/models/{model}:streamGenerateContentPOST
/v1/models/{model}:generateContentPOST
/v1/models/{model}:streamGenerateContent请求
字段modelpath stringRequired模型名来自 URL 路径。
contentsarray<object>Required
Gemini 原生 contents，parts 可包含 text、inlineData、fileData 等。
contents[].rolestringOptionaluser 或 model。
contents[].parts[]array<object>Optional内容块数组。
parts[].textstringOptional文本内容。
parts[].inlineDataobjectOptionalbase64 内联数据，通常包含 mimeType 与 data。
parts[].fileDataobjectOptional文件输入，通常包含 mimeType 与 fileUri。
parts[].functionCallobjectOptional模型发起的函数调用。
parts[].functionResponseobjectOptional客户端返回的函数调用结果。
systemInstructionobjectOptional
系统指令。
systemInstruction.parts[].textstringOptional系统指令文本。
generationConfigobjectOptional
生成配置，如 temperature、topP、topK、maxOutputTokens、stopSequences、responseMimeType、responseSchema、thinkingConfig 等。
generationConfig.temperaturenumberOptional采样温度。
generationConfig.topP / topKnumberOptional采样控制参数。
generationConfig.maxOutputTokensintegerOptional最大输出 token 数。
generationConfig.stopSequencesstring[]Optional停止序列。
generationConfig.responseMimeTypestringOptional响应 MIME 类型，如 application/json。
generationConfig.responseSchemaobjectOptional结构化输出 schema。
generationConfig.responseModalitiesstring[]Optional请求输出模态。
generationConfig.thinkingConfigobjectOptional思考/推理配置。
safetySettingsarray<object>Optional
安全策略配置。
safetySettings[].categorystringOptional安全分类。
safetySettings[].thresholdstringOptional拦截阈值。
tools / toolConfigarray<object> | objectOptional
函数调用或工具配置。
tools[].functionDeclarations[]array<object>Optional函数声明数组。
functionDeclarations[].namestringOptional函数名。
functionDeclarations[].descriptionstringOptional函数描述。
functionDeclarations[].parametersobjectOptional函数参数 schema。
toolConfig.functionCallingConfig.modestringOptional函数调用模式。
响应
字段非流式响应保持 Gemini generateContent 形态；流式调用返回 Gemini 流式事件。
candidates[]array<object>Optional
候选输出，通常包含 content、finishReason、safetyRatings 等字段。
candidates[].content.parts[]array<object>Optional输出内容块。
parts[].textstringOptional文本输出。
parts[].functionCallobjectOptional函数调用输出。
candidates[].finishReasonstringOptional停止原因。
candidates[].safetyRatings[]array<object>Optional安全评级。
usageMetadataobjectOptional
token 用量统计。
usageMetadata.promptTokenCountintegerOptional输入 token 数。
usageMetadata.candidatesTokenCountintegerOptional候选输出 token 数。
usageMetadata.totalTokenCountintegerOptional总 token 数。
modelVersionstringOptional上游可能返回的模型版本。