Skip to main content
POST
/
v1beta
/
models
/
{model}
:generateContent
curl -s -X POST \
  "https://api.deerapi.com/v1beta/models/gemini-3.1-flash-image-preview:generateContent" \
  -H "Authorization: Bearer $DEERAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{"parts": [{"text": "A cute baby sea otter floating in the ocean"}]}],
    "generationConfig": {
      "responseModalities": ["TEXT", "IMAGE"]
    }
  }' | jq -r '.candidates[0].content.parts[] | select(.inlineData) | .inlineData.data' | head -1 | base64 --decode > output.png
{
  "candidates": [
    {
      "content": {
        "role": "<string>",
        "parts": [
          {
            "text": "<string>",
            "inlineData": {
              "data": "<string>",
              "mimeType": "<string>"
            }
          }
        ]
      },
      "finishReason": "<string>",
      "index": 123,
      "safetyRatings": [
        "<string>"
      ]
    }
  ],
  "usageMetadata": {
    "promptTokenCount": 123,
    "candidatesTokenCount": 123,
    "totalTokenCount": 123,
    "thoughtsTokenCount": 123,
    "promptTokensDetails": [
      {}
    ]
  },
  "promptFeedback": {
    "safetyRatings": [
      "<string>"
    ]
  }
}

​
概述

通过 DeerAPI 调用 Gemini 原生图像生成接口。完全兼容 Google Gemini API，只需替换 Base URL 和 API Key 即可使用。 详细使用指南请参考：调用 gemini-3-pro-image 指南

​
宽高比与分辨率

通过 imageConfig 控制输出图片的宽高比和分辨率。 支持的宽高比：1:1, 1:4, 1:8, 2:3, 3:2, 3:4, 4:1, 4:3, 4:5, 5:4, 8:1, 9:16, 16:9, 21:9 支持的分辨率（Gemini 3 系列）：512px、1K（默认）、2K、4K
分辨率参数必须使用大写 K（如 2K、4K），小写会被拒绝。gemini-2.5-flash-image 固定 1024px，不支持 imageSize 参数。

​
输出模式

  • ["TEXT", "IMAGE"]：默认模式，同时输出文字描述和图片
  • ["IMAGE"]：强制仅输出图片，解决频繁出现纯文本输出的问题

​
Google Search 增强

在 tools 中添加 {"google_search": {}} 可让模型基于实时信息生成图片（如天气预报、新闻事件等）。 Gemini 3.1 Flash Image 还支持 Google Image Search，可从网络图片中获取视觉参考。

​
参考文档

Authorizations

​
Authorization
string
header
required

Bearer token authentication. Use your DeerAPI key.

Path Parameters

​
model
string
required

需要调用的 model_id，例如 gemini-3.1-flash-image-preview（推荐）、gemini-3-pro-image-preview（专业创作）、gemini-2.5-flash-image（快速生成）

Body

application/json

整个请求体

​
contents
object[]
required

包含了对话历史或当前要发送的内容，是进行对话的核心字段。

​
generationConfig
object
required

模型生成行为配置。图像生成时，responseModalities 应设定为 ["TEXT", "IMAGE"]。

​
tools
object[]

可选工具列表。例如启用 Google Search 增强生图效果：[{"google_search": {}}]

Response

200 - application/json

成功

​
candidates
object[]
required
​
usageMetadata
object
required
​
promptFeedback
object