Gemini Images API#

通过 Gemini generateContent 使用 Nano Banana 模型生成和编辑图片。

Base URL: https://api.unigateway.ai

文生图#

curl -sS -X POST "https://api.unigateway.ai/v1beta/models/gemini-3-pro-image-preview:generateContent" \
  -H "Authorization: Bearer $UNIGATEWAY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{ "parts": [{ "text": "你的提示词。" }] }],
    "generationConfig": {
      "responseModalities": ["TEXT", "IMAGE"],
      "imageConfig": { "aspectRatio": "16:9", "imageSize": "4K" }
    }
  }'

将模型换成 gemini-3.1-flash-image-preview 即为 Nano Banana 2。

图生图#

在 parts[] 中通过 inline_data 传入图片，配合文字指令：

B64=$(base64 -i input.png 2>/dev/null || base64 -w0 input.png)
curl -sS -X POST "https://api.unigateway.ai/v1beta/models/gemini-3-pro-image-preview:generateContent" \
  -H "Authorization: Bearer $UNIGATEWAY_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{
    \"contents\": [{ \"parts\": [
      {\"text\": \"你的编辑指令。\"},
      {\"inline_data\": {\"mime_type\": \"image/png\", \"data\": \"${B64}\"}}
    ]}],
    \"generationConfig\": {
      \"responseModalities\": [\"TEXT\", \"IMAGE\"],
      \"imageConfig\": { \"aspectRatio\": \"16:9\", \"imageSize\": \"4K\" }
    }
  }"

多张图片：在 parts[] 中继续添加 inline_data 块。

图片尺寸控制#

保存返回#

jq -r 'first(..|objects|select(.inlineData?.data)|.inlineData.data)' result.json | base64 -D > out.png  # macOS
jq -r 'first(..|objects|select(.inlineData?.data)|.inlineData.data)' result.json | base64 --decode > out.png  # Linux

响应格式#

{
  "candidates": [{
    "content": {
      "parts": [
        { "text": "Here is the generated image." },
        { "inlineData": { "mimeType": "image/png", "data": "..." } }
      ]
    }
  }]
}

常见错误#