图片生成：gemini-2.5-flash-image

使用 Vortap 调用 gemini-2.5-flash-image 模型生成或编辑图片。

接口信息

POST /v1beta/models/gemini-2.5-flash-image:generateContent

Base URL

https://www.vortapapi.com/v1

该接口使用 generateContent 调用方式，请在查询参数中传入 API Key。

查询参数

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

请求头

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

请求体

请求体为 JSON，通常包含 contents 字段，用于传入文本提示词、图片输入或多模态内容。

常用字段

字段	类型	必填	说明
contents	array	是	对话内容列表。每个元素通常包含 role 和 parts。
contents[].role	string	否	消息角色，例如 user。
contents[].parts	array	是	输入内容片段，可包含文本或图片等内容。
contents[].parts[].text	string	否	文本提示词。
generationConfig	object	否	生成配置。
generationConfig.responseModalities	array	否	指定返回内容类型，例如 ["TEXT", "IMAGE"]。

文本生成图片示例

curl -X POST "https://www.vortapapi.com/v1beta/models/gemini-2.5-flash-image:generateContent?key=sk-***" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [
      {
        "role": "user",
        "parts": [
          {
            "text": "生成一张写实风格的图片：一只橘猫坐在咖啡馆窗边，窗外下着小雨，暖色灯光。"
          }
        ]
      }
    ],
    "generationConfig": {
      "responseModalities": ["TEXT", "IMAGE"]
    }
  }'

图片编辑示例

以下示例展示如何同时提交文本指令和图片输入，用于对图片进行编辑。

curl -X POST "https://www.vortapapi.com/v1beta/models/gemini-2.5-flash-image:generateContent?key=sk-***" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [
      {
        "role": "user",
        "parts": [
          {
            "text": "请将图片中的背景替换为海边日落场景，保持主体人物不变。"
          },
          {
            "inlineData": {
              "mimeType": "image/png",
              "data": "BASE64_IMAGE_DATA"
            }
          }
        ]
      }
    ],
    "generationConfig": {
      "responseModalities": ["TEXT", "IMAGE"]
    }
  }'

响应示例

响应中通常会包含文本说明和图片数据。图片可能以 Base64 编码形式返回。

{
  "candidates": [
    {
      "content": {
        "parts": [
          {
            "text": "已根据提示生成图片。"
          },
          {
            "inlineData": {
              "mimeType": "image/png",
              "data": "BASE64_IMAGE_DATA"
            }
          }
        ]
      }
    }
  ]
}

注意事项

• key 参数必须使用有效的 Vortap API Key。
• 请求头 Content-Type 需要设置为 application/json。
• 如需返回图片内容，建议在 generationConfig.responseModalities 中包含 "IMAGE"。
• 传入图片时，inlineData.data 应为去除前缀后的 Base64 字符串，例如不要包含 data:image/png;base64,。