Skip to Content
goldflow.cc Docs
ChatGemini

Gemini 文本聊天 / 媒体识别

POST
/v1beta/models/{model}:generateContent

Gemini generateContent 兼容接口,用于文本聊天和媒体识别请求。

Authorization

bearerAuth
headerAuthorizationBearer <API key>

使用 Authorization Bearer API Key 进行鉴权。

Path Parameters

model*string

Gemini 兼容接口路径中的模型 ID。

Request Body

application/json
  1. body
contents*array<>

Gemini 请求内容列表,每项包含角色和 parts。

Items1 <= items
systemInstruction?

Gemini 系统指令。

generationConfig?

Gemini 生成参数,例如温度、topP、最大输出 token、图片输出模态等。

safetySettings?array<>

Gemini 安全设置列表。

tools?array<>

Gemini 可调用工具定义列表。

Response Body

Gemini 内容生成响应。

application/json
  1. response
candidates?array<>

Gemini 返回的候选结果列表。

promptFeedback?

输入提示的安全或拦截反馈。

usageMetadata?

token 使用量等统计信息。

curl -X POST 'https://goldflow.cc/v1beta/models/gemini-2.5-flash:generateContent' \  -H 'Content-Type: application/json' \  -d '{  "contents": [    {      "role": "user",      "parts": [        {          "text": "你好,请介绍 goldflow.cc。"        }      ]    }  ]}'
Example Response
{  "candidates": [    {}  ],  "promptFeedback": {},  "usageMetadata": {}}