API
CLUB

Gemini 图片

通过 Chat Completions 生成图片，参考图放在消息内容中，结果同步返回。

查看价格获取 API 密钥

可用模型

gemini-3-pro-image标准gemini-3-pro-image-preview标准gemini-3.1-flash-image标准gemini-3.1-flash-image-preview标准gemini-nano-banana-2.1标准

选择模型，下方示例和参数会切换为该模型。

gemini-3-pro-image-preview

Chat Completions · 生图 · POST /v1/chat/completions

请求示例
curl -X POST 'https://code.exgravity.ai/v1/chat/completions' \
  -H "Authorization: Bearer $UIKA_API_KEY" \
  -H "Content-Type: application/json" \
  --data-raw '{
  "model": "gemini-3-pro-image-preview",
  "stream": false,
  "messages": [
    {
      "role": "user",
      "content": [
        {
          "type": "text",
          "text": "一只橘猫坐在窗边，柔和的午后阳光，电影质感"
        }
      ]
    }
  ],
  "modalities": [
    "text",
    "image"
  ],
  "extra_body": {
    "google": {
      "image_config": {
        "aspect_ratio": "1:1",
        "image_size": "1K"
      }
    }
  }
}'

请求参数

字段说明
messages[].content使用 text 内容；参考图片增加 image_url 内容。
modalities["text", "image"]，请求图片输出。
extra_body.google.image_config.aspect_ratio1:1 / 16:9 / 9:16 / 4:3 / 3:4 / 3:2 / 2:3 / 4:5 / 5:4 / 21:9
extra_body.google.image_config.image_size1K / 2K / 4K

参考素材

image_url.url 使用服务端可访问的 HTTPS 图片地址，或受支持的图片 data URL。

带参考素材的请求
curl -X POST 'https://code.exgravity.ai/v1/chat/completions' \
  -H "Authorization: Bearer $UIKA_API_KEY" \
  -H "Content-Type: application/json" \
  --data-raw '{
  "model": "gemini-3-pro-image-preview",
  "stream": false,
  "messages": [
    {
      "role": "user",
      "content": [
        {
          "type": "text",
          "text": "一只橘猫坐在窗边，柔和的午后阳光，电影质感"
        },
        {
          "type": "image_url",
          "image_url": {
            "url": "https://your-domain.example/reference.png"
          }
        }
      ]
    }
  ],
  "modalities": [
    "text",
    "image"
  ],
  "extra_body": {
    "google": {
      "image_config": {
        "aspect_ratio": "1:1",
        "image_size": "1K"
      }
    }
  }
}'

返回结果

同步返回 choices[].message。图片可能位于 images[].image_url.url，或 content 的 image_url 内容中；返回 data:image/...;base64,... 时可直接解码保存。