使用 gemini-2.5-flash-image 生成图片并控制宽高比

通过 Vortap 调用 gemini-2.5-flash-image 模型时，可以使用内容生成接口提交图片生成请求，并在请求中指定图片相关配置，例如宽高比。

接口地址

POST https://www.vortapapi.com/v1beta/models/gemini-2.5-flash-image:generateContent

鉴权方式

该接口使用查询参数 key 传入 Vortap API Key。

?key=sk-***

查询参数

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

请求头

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

请求示例

curl -X POST "https://www.vortapapi.com/v1beta/models/gemini-2.5-flash-image:generateContent?key=sk-***" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [
      {
        "parts": [
          {
            "text": "生成一张未来感城市夜景图片，霓虹灯、雨后街道、电影感构图。"
          }
        ]
      }
    ]
  }'

控制图片宽高比

如需控制生成图片的宽高比，可在请求体中加入图片生成相关配置字段。具体可用参数以 Vortap 当前模型能力为准。

示例：

curl -X POST "https://www.vortapapi.com/v1beta/models/gemini-2.5-flash-image:generateContent?key=sk-***" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [
      {
        "parts": [
          {
            "text": "生成一张横版海报：一辆红色跑车行驶在沙漠公路上，夕阳背景，写实风格。"
          }
        ]
      }
    ],
    "generationConfig": {
      "aspectRatio": "16:9"
    }
  }'

常见宽高比

宽高比	适用场景
1:1	头像、社交媒体方图
16:9	横版封面、视频缩略图、桌面壁纸
9:16	竖版海报、短视频封面
4:3	通用横版图片
3:4	竖版插画、商品图

响应

接口会返回模型生成的内容。若请求成功，响应中通常包含文本说明或图片数据，具体字段取决于模型输出格式与请求配置。