Gemini Generate Content

接口说明

当前图像生成接口使用 Gemini 兼容的 :generateContent 形式，适合文本生图和最多 5 张参考图输入。

端点与方法

POST /v1beta/models/{model}:generateContent

示例：

POST https://xinbaoapi.dpdns.org/v1beta/models/gemini-3-pro-image-preview:generateContent

鉴权方式

Authorization: Bearer <API_KEY>

请求参数

必填参数

• contents：对话输入数组
• contents[].parts[].text：提示词

常用可选参数

• contents[].parts[].inlineData：参考图
• generationConfig.topP：采样参数
• generationConfig.responseModalities：返回模态，图片场景设为 ["IMAGE"]
• generationConfig.imageConfig.aspectRatio：输出比例
• generationConfig.imageConfig.imageSize：输出尺寸
• generationConfig.imageConfig.output：推荐使用 url
• systemInstruction：系统指令

完整请求示例

{
  "contents": [
    {
      "role": "user",
      "parts": [
        { "text": "请融合 5 张参考图的构图与风格，生成一张高清产品海报，光照自然，背景干净，适合电商主图。" },
        { "inlineData": { "mimeType": "image/jpeg", "data": "https://example.com/img1.jpg" } },
        { "inlineData": { "mimeType": "image/jpeg", "data": "https://example.com/img2.jpg" } },
        { "inlineData": { "mimeType": "image/png", "data": "https://example.com/img3.png" } },
        { "inlineData": { "mimeType": "image/webp", "data": "https://example.com/img4.webp" } },
        { "inlineData": { "mimeType": "image/jpeg", "data": "https://example.com/img5.jpg" } }
      ]
    }
  ],
  "generationConfig": {
    "topP": 0.95,
    "responseModalities": ["IMAGE"],
    "imageConfig": {
      "aspectRatio": "16:9",
      "imageSize": "2K",
      "output": "url"
    }
  },
  "tools": [{ "google_search": {} }],
  "systemInstruction": {
    "parts": [
      { "text": "你是一名资深电商视觉设计师，请输出商业可用的构图与光影效果。" }
    ]
  }
}

curl 示例

curl -X POST "https://xinbaoapi.dpdns.org/v1beta/models/gemini-3-pro-image-preview:generateContent" \
  -H "Authorization: Bearer <API_KEY>" \
  -H "Content-Type: application/json" \
  -d @request.json

返回示例

接口返回中，图片结果通常位于 candidates[*].content.parts[*].inlineData。

注意事项

• 当前服务端图片输入最多 5 张
• output="url" 时更适合实际业务接入
• 大图建议先上传图床，再使用公网 URL
• Auto 语义表示不传该字段，由服务端决定默认值

常见报错

• 图片数量超限
• 传入了不可访问的图片 URL
• 把原始中文 JSON 字符串塞入 data=，触发编码问题

相关页面

• 返回结果解析
• 图床建议