Skip to Content
goldflow.cc 文档
图片系列Gemini

Gemini 原生图像生成

POST
/v1beta/models/{model}:generateContent/

Gemini 官方 generateContent REST 格式的图像生成接口。请求体使用 contents[].parts[] 传入文本和图片,使用 generationConfig.responseModalities 请求图片输出。兼容 /v1beta/models/{model}:generateContent 与 /v1/models/{model}: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": "生成一张高级质感的产品摄影图,干净通透,柔和自然光,细节清晰。"        }      ]    }  ],  "generationConfig": {    "responseModalities": [      "IMAGE"    ],    "imageConfig": {      "aspectRatio": "4:3",      "imageSize": "2K"    }  }}'
Example Response
{  "candidates": [    {}  ],  "promptFeedback": {},  "usageMetadata": {}}