文本生成(Gemini)
使用 Gemini 原生 generateContent 格式生成文本
POST
https://api.tokenbyte.ai/v1beta/models/{model}:generateContent流式输出将操作名改为 streamGenerateContent。模型 ID 是路径的一部分,请从模型列表复制。
Header 参数
| 参数 | 必填 | 说明 |
|---|---|---|
x-goog-api-key | 是 | TokenByte API Key |
Content-Type | 是 | application/json |
路径参数
| 参数 | 说明 |
|---|---|
model | 支持 Gemini 协议的完整模型 ID |
action | generateContent 或 streamGenerateContent |
Body 参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
contents | array | 是 | 多轮消息,每项包含 role 与 parts |
systemInstruction | object | 否 | 系统指令内容 |
generationConfig | object | 否 | 温度、Top-P、Top-K、最大输出与停止序列 |
tools | array | 否 | 函数声明等工具 |
toolConfig | object | 否 | 工具调用策略 |
safetySettings | array | 否 | 模型支持时使用的安全阈值 |
contents[].role 通常为 user 或 model。parts 可包含 text、inlineData、fileData、functionCall 或 functionResponse。内联媒体的 data 使用 Base64 编码,并同时提供 mimeType。
响应
结果位于 candidates[].content.parts。文本 Part 使用 text,工具调用 Part 使用 functionCall。finishReason 表示停止原因,usageMetadata 包含提示词、候选输出和总 Token 数。