gemini-3.1-flash-lite-image

POSThttps://www.aipro2.com/v1beta/models/gemini-3.1-flash-lite-image:generateContent

官方文档：https://ai.google.dev/gemini-api/docs/image-generation?hl=zh-cn — Gemini 3.1 Flash-Lite Image（Nano Banana 2 Lite）文生图、图生图、视频转图与图像编辑。

Header 参数

• Authorizationstring
  Bearer API Key

  示例Bearer {{YOUR_API_KEY}}

请求体参数

application/json

• contents*array<object>
  对话内容列表，必填。文生图时至少包含 1 条 user 消息；图生图/编辑时在 parts 中附带 inlineData 或 fileData；多轮编辑时按时间顺序追加历史消息。上游约束：总输入 token 不超过 65536；单文件输入不超过 500MB。
• generationConfigobject
  生成配置。生图场景下 responseModalities 必须包含 IMAGE；imageConfig 控制宽高比与输出格式；thinkingConfig 可选。
• response_formatstring
  填url返回url，不填默认base64
• safetySettingsarray<object>
  安全设置，可选。控制各类有害内容过滤阈值。
• systemInstructionobject
  系统指令，可选。用于约束输出风格、语言、格式等，如图生图时要求“只输出图片相关说明”或翻译场景限制输出内容。

响应

application/jsonPostV1betaModelsGemini31FlashLiteImageGenerateContentResponse

• candidates*array<object>
  模型候选回复列表
• createTime*string
  响应创建时间
• modelVersion*string
  实际使用的模型版本
• responseId*string
  本次响应的唯一 ID
• usageMetadata*object
  Token 用量元数据

请求体示例新手推荐 · 文生图 · 1:1新手推荐 · 文生图 · 9:16 竖屏进阶推荐 · 文生图 · Thinking + PNG 输出进阶推荐 · 单轮图像编辑进阶推荐 · 多参考图合成（≤3 张）进阶推荐 · 视频转图片

1{2  "contents": [3    {4      "parts": [5        {6          "text": "A cute cat sitting on a wooden table, watercolor style."7        }8      ],9      "role": "user"10    }11  ],12  "generationConfig": {13    "imageConfig": {14      "aspectRatio": "1:1"15    },16    "responseModalities": [17      "IMAGE"18    ]19  },20  "response_format": "url"21}

代码示例cURLPythonJavaScriptGoPHP

1curl -X POST "https://www.aipro2.com/v1beta/models/gemini-3.1-flash-lite-image:generateContent" \2  -H "Authorization: Bearer <API Key>" \3  -H "Content-Type: application/json" \4  -d '{5    "contents": [6      {7        "parts": [8          {9            "text": "A cute cat sitting on a wooden table, watercolor style."10          }11        ],12        "role": "user"13      }14    ],15    "generationConfig": {16      "imageConfig": {17        "aspectRatio": "1:1"18      },19      "responseModalities": [20        "IMAGE"21      ]22    },23    "response_format": "url"24  }'

响应示例 · 200example

1{2  "candidates": [3    {4      "content": {5        "parts": [6          {7            "inlineData": {8              "data": "string",9              "mimeType": "string"10            },11            "thoughtSignature": "string"12          }13        ],14        "role": "string"15      },16      "finishReason": "string"17    }18  ],19  "createTime": "string",20  "modelVersion": "string",21  "responseId": "string",22  "usageMetadata": {23    "candidatesTokenCount": 0,24    "candidatesTokensDetails": [25      {26        "modality": "string",27        "tokenCount": 028      }29    ],30    "promptTokenCount": 0,31    "promptTokensDetails": [32      {33        "modality": "string",34        "tokenCount": 035      }36    ],37    "totalTokenCount": 0,38    "trafficType": "string"39  }40}