跳转到主要内容
POST
Gemini 原生格式
  • 使用 Google 原生 API 格式调用 Gemini 模型
  • 支持同步和流式两种生成方法
  • 参数精简,便于快速上手

使用示例

生成内容

接口:
请求体:

流式生成内容

接口:
请求体:

多模态输入

注意事项

  • 使用 generateContent 获取完整 JSON 响应。
  • 使用 streamGenerateContent 进行流式生成。
  • 尽可能把文本指令放在多模态 part 之前。

响应

generateContent 直接返回 Gemini GenerateContentResponse 对象,不带 code / data 包装。文本位于 candidates[].content.parts[].text,token 计数位于 usageMetadata。思考模型可能会添加带 thought: true 或 thoughtSignature 的 part;跳过没有 text 的 part 即可。

流式输出

streamGenerateContent 返回 text/event-stream。每个事件是一行包含部分 GenerateContentResponse 的 data:,流以 data: [DONE] 结束。接受 alt=sse 查询参数,但不是必需的。
  • 按顺序拼接各个 text part。最后一个事件携带 finishReason。

错误

  • 401:缺少 API Key 或 API Key 无效。
  • 400:请求无效,或模型不是 Gemini 模型。响应体使用 Google 错误结构:{"error": {"code": 400, "message": "...", "status": "INVALID_ARGUMENT"}}。
  • 404:未知的 model id。
响应体示例见错误码,哪些模型支持此格式见 LLM 模型。

授权

Authorization
string
header
必填

所有 API 接口都需要 Bearer Token 认证。

创建 API Key:登录 PoYo,进入 仪表盘 → API 密钥(poyo.ai/zh/dashboard/api-key),点击创建 Key。

在请求头中添加:

路径参数

model
string
必填

Gemini 模型名称。示例:gemini-3-flash-preview。

示例:

"gemini-3-flash-preview"

method
enum<string>
必填

请求方法。generateContent 返回完整 JSON 响应,streamGenerateContent 用于流式生成。

可用选项:
generateContent,
streamGenerateContent
示例:

"generateContent"

请求体

application/json
contents
object[]
必填

包含角色和 parts 的对话内容。每个 content 对象可包含 role(user 或 model)以及由文本或内联数据组成的 parts 数组。

generationConfig
object

生成配置,包括 temperature、topP、topK、maxOutputTokens 和 stopSequences。

safetySettings
object[]

安全设置。

响应

内容已生成

candidates
object[]
promptFeedback
object