图片生成：gemini-3-pro-image-preview 控制宽高比与清晰度

使用 Vortap 调用 gemini-3-pro-image-preview 生成图片时，可以通过 imageConfig.aspectRatio 控制画面比例，并通过 imageConfig.imageSize 控制输出清晰度。

接口

POST https://www.vortapapi.com/v1/v1beta/models/gemini-3-pro-image-preview:generateContent

鉴权

Vortap 使用 API Key 进行鉴权。请在查询参数中传入 key。

?key=sk-***

查询参数

名称	类型	必填	说明
key	string	是	Vortap API Key，例如 sk-***。

请求头

名称	必填	说明
Content-Type	是	固定为 application/json。

请求体

字段	类型	必填	说明
contents	array	是	输入内容，通常包含文本提示词。
contents[].parts	array	是	内容片段列表。
contents[].parts[].text	string	是	图片生成提示词。
generationConfig	object	否	生成配置。
generationConfig.responseModalities	array	是	响应模态。生成图片时通常设置为 ["TEXT", "IMAGE"]。
generationConfig.imageConfig	object	否	图片输出配置。
generationConfig.imageConfig.aspectRatio	string	否	图片宽高比，例如 1:1、16:9、9:16、4:3、3:4。
generationConfig.imageConfig.imageSize	string	否	图片清晰度/尺寸档位，例如 1K、2K。

示例：生成 16:9 的 2K 图片

curl -X POST "https://www.vortapapi.com/v1/v1beta/models/gemini-3-pro-image-preview:generateContent?key=sk-***" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [
      {
        "parts": [
          {
            "text": "生成一张未来城市夜景图片，霓虹灯、雨后街道、电影感构图，高细节。"
          }
        ]
      }
    ],
    "generationConfig": {
      "responseModalities": ["TEXT", "IMAGE"],
      "imageConfig": {
        "aspectRatio": "16:9",
        "imageSize": "2K"
      }
    }
  }'

示例：生成竖版 9:16 图片

curl -X POST "https://www.vortapapi.com/v1/v1beta/models/gemini-3-pro-image-preview:generateContent?key=sk-***" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [
      {
        "parts": [
          {
            "text": "生成一张竖版海报：雪山、极光、孤独的旅行者，写实摄影风格。"
          }
        ]
      }
    ],
    "generationConfig": {
      "responseModalities": ["TEXT", "IMAGE"],
      "imageConfig": {
        "aspectRatio": "9:16",
        "imageSize": "2K"
      }
    }
  }'

响应示例

接口会在 candidates[].content.parts[] 中返回文本或图片数据。图片通常以 inlineData 的形式返回，其中 data 为 Base64 编码内容。

{
  "candidates": [
    {
      "content": {
        "parts": [
          {
            "text": "已生成图片。"
          },
          {
            "inlineData": {
              "mimeType": "image/png",
              "data": "iVBORw0KGgoAAAANSUhEUg..."
            }
          }
        ]
      }
    }
  ]
}

提取图片数据

返回结果中的图片位于：

candidates[0].content.parts[].inlineData.data

inlineData.data 是 Base64 字符串，可按 mimeType 保存为对应格式的图片文件。