文档

文本生成(Gemini)

使用 Gemini 原生 generateContent 格式生成文本

POSThttps://api.tokenbyte.ai/v1beta/models/{model}:generateContent

流式输出将操作名改为 streamGenerateContent。模型 ID 是路径的一部分,请从模型列表复制。

Header 参数

参数必填说明
x-goog-api-keyTokenByte API Key
Content-Typeapplication/json

路径参数

参数说明
model支持 Gemini 协议的完整模型 ID
actiongenerateContentstreamGenerateContent

Body 参数

参数类型必填说明
contentsarray多轮消息,每项包含 roleparts
systemInstructionobject系统指令内容
generationConfigobject温度、Top-P、Top-K、最大输出与停止序列
toolsarray函数声明等工具
toolConfigobject工具调用策略
safetySettingsarray模型支持时使用的安全阈值

contents[].role 通常为 usermodelparts 可包含 textinlineDatafileDatafunctionCallfunctionResponse。内联媒体的 data 使用 Base64 编码,并同时提供 mimeType

响应

结果位于 candidates[].content.parts。文本 Part 使用 text,工具调用 Part 使用 functionCallfinishReason 表示停止原因,usageMetadata 包含提示词、候选输出和总 Token 数。