跳转到主要内容
POST
Google
Google Gemini 模型覆盖推理、编程、多模态输入和 Agent 工作流。本页 Playground 使用 Gemini Native,所有 Gemini 模型都支持该格式。在 model 路径参数中选择模型。

模型

  • gemini-4-argon — Gemini 4 Argon,前沿推理模型,上下文 1M,适用于长周期编程和知识工作。
  • gemini-3.8-flash — Gemini 3.8 Flash,适用于软件工程、自主 Agent 和企业工作流。
  • gemini-3.7-flash — Gemini 3.7 Flash,适用于 Agent 编程、多模态推理和工具使用。
  • gemini-3.5-flash — Gemini 3.5 Flash。
  • gemini-3.1-pro-preview — Gemini 3.1 Pro Preview。
  • gemini-3-pro-preview — Gemini 3 Pro Preview。
  • gemini-3-flash-preview — Gemini 3 Flash Preview。
所有 Gemini 模型都支持 Gemini Native 和 Chat Completions。

示例

  • 基础请求 — 使用 contents 和 generationConfig 调用 generateContent。
流式输出时把 method 设为 streamGenerateContent。如需以 Chat Completions 格式调用模型,在请求体的 model 字段中传入相同的 model id,发送到 Chat Completions。

注意事项

  • 在 Gemini Native 中,model id 放在 URL 路径里,而不是请求体中。
  • 全部模型及其支持的格式见 LLM 模型。

授权

Authorization
string
header
必填

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

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

在请求头中添加:

路径参数

model
enum<string>
默认值:gemini-3-flash-preview
必填

Gemini 模型 ID,在 URL 路径中传入。

可用选项:
gemini-4-argon,
gemini-3.8-flash,
gemini-3.7-flash,
gemini-3.5-flash,
gemini-3.1-pro-preview,
gemini-3-pro-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