圖片編輯 API 參考

图片编辑：根据指令编辑现有图片

curl --request POST \
  --url https://api.apiyi.com/v1beta/models/gemini-3.1-flash-lite-image:generateContent \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "contents": [
    {
      "parts": [
        {
          "text": "把这两张图里的人物合成到同一个办公室场景中，做着搞怪表情"
        },
        {
          "inlineData": {
            "mimeType": "image/png",
            "data": "<BASE64_DATA_IMG_1>"
          }
        },
        {
          "inlineData": {
            "mimeType": "image/png",
            "data": "<BASE64_DATA_IMG_2>"
          }
        }
      ]
    }
  ],
  "generationConfig": {
    "responseModalities": [
      "IMAGE"
    ],
    "imageConfig": {
      "aspectRatio": "16:9",
      "imageSize": "1K"
    }
  }
}
'

import requests

url = "https://api.apiyi.com/v1beta/models/gemini-3.1-flash-lite-image:generateContent"

payload = {
    "contents": [{ "parts": [{ "text": "把这两张图里的人物合成到同一个办公室场景中，做着搞怪表情" }, { "inlineData": {
                        "mimeType": "image/png",
                        "data": "<BASE64_DATA_IMG_1>"
                    } }, { "inlineData": {
                        "mimeType": "image/png",
                        "data": "<BASE64_DATA_IMG_2>"
                    } }] }],
    "generationConfig": {
        "responseModalities": ["IMAGE"],
        "imageConfig": {
            "aspectRatio": "16:9",
            "imageSize": "1K"
        }
    }
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    contents: [
      {
        parts: [
          {text: '把这两张图里的人物合成到同一个办公室场景中，做着搞怪表情'},
          {inlineData: {mimeType: 'image/png', data: '<BASE64_DATA_IMG_1>'}},
          {inlineData: {mimeType: 'image/png', data: '<BASE64_DATA_IMG_2>'}}
        ]
      }
    ],
    generationConfig: {
      responseModalities: ['IMAGE'],
      imageConfig: {aspectRatio: '16:9', imageSize: '1K'}
    }
  })
};

fetch('https://api.apiyi.com/v1beta/models/gemini-3.1-flash-lite-image:generateContent', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.apiyi.com/v1beta/models/gemini-3.1-flash-lite-image:generateContent",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'contents' => [
        [
                'parts' => [
                                [
                                                                'text' => '把这两张图里的人物合成到同一个办公室场景中，做着搞怪表情'
                                ],
                                [
                                                                'inlineData' => [
                                                                                                                                'mimeType' => 'image/png',
                                                                                                                                'data' => '<BASE64_DATA_IMG_1>'
                                                                ]
                                ],
                                [
                                                                'inlineData' => [
                                                                                                                                'mimeType' => 'image/png',
                                                                                                                                'data' => '<BASE64_DATA_IMG_2>'
                                                                ]
                                ]
                ]
        ]
    ],
    'generationConfig' => [
        'responseModalities' => [
                'IMAGE'
        ],
        'imageConfig' => [
                'aspectRatio' => '16:9',
                'imageSize' => '1K'
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.apiyi.com/v1beta/models/gemini-3.1-flash-lite-image:generateContent"

	payload := strings.NewReader("{\n  \"contents\": [\n    {\n      \"parts\": [\n        {\n          \"text\": \"把这两张图里的人物合成到同一个办公室场景中，做着搞怪表情\"\n        },\n        {\n          \"inlineData\": {\n            \"mimeType\": \"image/png\",\n            \"data\": \"<BASE64_DATA_IMG_1>\"\n          }\n        },\n        {\n          \"inlineData\": {\n            \"mimeType\": \"image/png\",\n            \"data\": \"<BASE64_DATA_IMG_2>\"\n          }\n        }\n      ]\n    }\n  ],\n  \"generationConfig\": {\n    \"responseModalities\": [\n      \"IMAGE\"\n    ],\n    \"imageConfig\": {\n      \"aspectRatio\": \"16:9\",\n      \"imageSize\": \"1K\"\n    }\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.apiyi.com/v1beta/models/gemini-3.1-flash-lite-image:generateContent")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"contents\": [\n    {\n      \"parts\": [\n        {\n          \"text\": \"把这两张图里的人物合成到同一个办公室场景中，做着搞怪表情\"\n        },\n        {\n          \"inlineData\": {\n            \"mimeType\": \"image/png\",\n            \"data\": \"<BASE64_DATA_IMG_1>\"\n          }\n        },\n        {\n          \"inlineData\": {\n            \"mimeType\": \"image/png\",\n            \"data\": \"<BASE64_DATA_IMG_2>\"\n          }\n        }\n      ]\n    }\n  ],\n  \"generationConfig\": {\n    \"responseModalities\": [\n      \"IMAGE\"\n    ],\n    \"imageConfig\": {\n      \"aspectRatio\": \"16:9\",\n      \"imageSize\": \"1K\"\n    }\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.apiyi.com/v1beta/models/gemini-3.1-flash-lite-image:generateContent")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"contents\": [\n    {\n      \"parts\": [\n        {\n          \"text\": \"把这两张图里的人物合成到同一个办公室场景中，做着搞怪表情\"\n        },\n        {\n          \"inlineData\": {\n            \"mimeType\": \"image/png\",\n            \"data\": \"<BASE64_DATA_IMG_1>\"\n          }\n        },\n        {\n          \"inlineData\": {\n            \"mimeType\": \"image/png\",\n            \"data\": \"<BASE64_DATA_IMG_2>\"\n          }\n        }\n      ]\n    }\n  ],\n  \"generationConfig\": {\n    \"responseModalities\": [\n      \"IMAGE\"\n    ],\n    \"imageConfig\": {\n      \"aspectRatio\": \"16:9\",\n      \"imageSize\": \"1K\"\n    }\n  }\n}"

response = http.request(request)
puts response.read_body

{
  "candidates": [
    {
      "content": {
        "parts": [
          {
            "inlineData": {
              "mimeType": "image/png",
              "data": "<string>"
            }
          }
        ]
      },
      "finishReason": "STOP"
    }
  ],
  "usageMetadata": {
    "promptTokenCount": 10,
    "candidatesTokenCount": 258
  }
}

POST

v1beta

models

gemini-3.1-flash-lite-image:generateContent

图片编辑：根据指令编辑现有图片

curl --request POST \
  --url https://api.apiyi.com/v1beta/models/gemini-3.1-flash-lite-image:generateContent \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "contents": [
    {
      "parts": [
        {
          "text": "把这两张图里的人物合成到同一个办公室场景中，做着搞怪表情"
        },
        {
          "inlineData": {
            "mimeType": "image/png",
            "data": "<BASE64_DATA_IMG_1>"
          }
        },
        {
          "inlineData": {
            "mimeType": "image/png",
            "data": "<BASE64_DATA_IMG_2>"
          }
        }
      ]
    }
  ],
  "generationConfig": {
    "responseModalities": [
      "IMAGE"
    ],
    "imageConfig": {
      "aspectRatio": "16:9",
      "imageSize": "1K"
    }
  }
}
'

import requests

url = "https://api.apiyi.com/v1beta/models/gemini-3.1-flash-lite-image:generateContent"

payload = {
    "contents": [{ "parts": [{ "text": "把这两张图里的人物合成到同一个办公室场景中，做着搞怪表情" }, { "inlineData": {
                        "mimeType": "image/png",
                        "data": "<BASE64_DATA_IMG_1>"
                    } }, { "inlineData": {
                        "mimeType": "image/png",
                        "data": "<BASE64_DATA_IMG_2>"
                    } }] }],
    "generationConfig": {
        "responseModalities": ["IMAGE"],
        "imageConfig": {
            "aspectRatio": "16:9",
            "imageSize": "1K"
        }
    }
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    contents: [
      {
        parts: [
          {text: '把这两张图里的人物合成到同一个办公室场景中，做着搞怪表情'},
          {inlineData: {mimeType: 'image/png', data: '<BASE64_DATA_IMG_1>'}},
          {inlineData: {mimeType: 'image/png', data: '<BASE64_DATA_IMG_2>'}}
        ]
      }
    ],
    generationConfig: {
      responseModalities: ['IMAGE'],
      imageConfig: {aspectRatio: '16:9', imageSize: '1K'}
    }
  })
};

fetch('https://api.apiyi.com/v1beta/models/gemini-3.1-flash-lite-image:generateContent', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.apiyi.com/v1beta/models/gemini-3.1-flash-lite-image:generateContent",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'contents' => [
        [
                'parts' => [
                                [
                                                                'text' => '把这两张图里的人物合成到同一个办公室场景中，做着搞怪表情'
                                ],
                                [
                                                                'inlineData' => [
                                                                                                                                'mimeType' => 'image/png',
                                                                                                                                'data' => '<BASE64_DATA_IMG_1>'
                                                                ]
                                ],
                                [
                                                                'inlineData' => [
                                                                                                                                'mimeType' => 'image/png',
                                                                                                                                'data' => '<BASE64_DATA_IMG_2>'
                                                                ]
                                ]
                ]
        ]
    ],
    'generationConfig' => [
        'responseModalities' => [
                'IMAGE'
        ],
        'imageConfig' => [
                'aspectRatio' => '16:9',
                'imageSize' => '1K'
        ]
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.apiyi.com/v1beta/models/gemini-3.1-flash-lite-image:generateContent"

	payload := strings.NewReader("{\n  \"contents\": [\n    {\n      \"parts\": [\n        {\n          \"text\": \"把这两张图里的人物合成到同一个办公室场景中，做着搞怪表情\"\n        },\n        {\n          \"inlineData\": {\n            \"mimeType\": \"image/png\",\n            \"data\": \"<BASE64_DATA_IMG_1>\"\n          }\n        },\n        {\n          \"inlineData\": {\n            \"mimeType\": \"image/png\",\n            \"data\": \"<BASE64_DATA_IMG_2>\"\n          }\n        }\n      ]\n    }\n  ],\n  \"generationConfig\": {\n    \"responseModalities\": [\n      \"IMAGE\"\n    ],\n    \"imageConfig\": {\n      \"aspectRatio\": \"16:9\",\n      \"imageSize\": \"1K\"\n    }\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.apiyi.com/v1beta/models/gemini-3.1-flash-lite-image:generateContent")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"contents\": [\n    {\n      \"parts\": [\n        {\n          \"text\": \"把这两张图里的人物合成到同一个办公室场景中，做着搞怪表情\"\n        },\n        {\n          \"inlineData\": {\n            \"mimeType\": \"image/png\",\n            \"data\": \"<BASE64_DATA_IMG_1>\"\n          }\n        },\n        {\n          \"inlineData\": {\n            \"mimeType\": \"image/png\",\n            \"data\": \"<BASE64_DATA_IMG_2>\"\n          }\n        }\n      ]\n    }\n  ],\n  \"generationConfig\": {\n    \"responseModalities\": [\n      \"IMAGE\"\n    ],\n    \"imageConfig\": {\n      \"aspectRatio\": \"16:9\",\n      \"imageSize\": \"1K\"\n    }\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.apiyi.com/v1beta/models/gemini-3.1-flash-lite-image:generateContent")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"contents\": [\n    {\n      \"parts\": [\n        {\n          \"text\": \"把这两张图里的人物合成到同一个办公室场景中，做着搞怪表情\"\n        },\n        {\n          \"inlineData\": {\n            \"mimeType\": \"image/png\",\n            \"data\": \"<BASE64_DATA_IMG_1>\"\n          }\n        },\n        {\n          \"inlineData\": {\n            \"mimeType\": \"image/png\",\n            \"data\": \"<BASE64_DATA_IMG_2>\"\n          }\n        }\n      ]\n    }\n  ],\n  \"generationConfig\": {\n    \"responseModalities\": [\n      \"IMAGE\"\n    ],\n    \"imageConfig\": {\n      \"aspectRatio\": \"16:9\",\n      \"imageSize\": \"1K\"\n    }\n  }\n}"

response = http.request(request)
puts response.read_body

{
  "candidates": [
    {
      "content": {
        "parts": [
          {
            "inlineData": {
              "mimeType": "image/png",
              "data": "<string>"
            }
          }
        ]
      },
      "finishReason": "STOP"
    }
  ],
  "usageMetadata": {
    "promptTokenCount": 10,
    "candidatesTokenCount": 258
  }
}

右側的互動式 Playground 支援下拉選擇引數。請在 Authorization 中填入你的 API Key（格式：Bearer sk-xxx），即可一鍵傳送請求測試。

場景說明：本頁用於「圖片編輯」，必須上傳一張待編輯的圖片（base64 編碼）+ 編輯指令。如果只想根據文本生成新圖片，請使用文生圖介面。

🖥️ 瀏覽器 Playground 限制（重要）本介面的響應裡包含 base64 編碼的圖片（inlineData.data，數 MB 量級）。受瀏覽器渲染限制，右側 Playground 在收到響應後可能彈出 請求時發生錯誤: unable to complete request ——實際請求已經成功，只是瀏覽器無法把這麼長的 base64 顯示出來。推薦做法（小白零踩坑）：

直接複製下方”程式碼示例”中的 Python / Node.js / cURL 到本地執行，程式碼會自動 base64.b64decode 並把圖片儲存為本地檔案。
如要在瀏覽器裡試 Playground，用極小的參考圖（少於 50KB），縮小響應體積。

⚠️ parts 陣列結構（重要，多圖編輯必看）每個 part 只能是 text 或 inlineData 中的一個，二者不能同時出現在同一個 part 裡。這與谷歌官方 gemini-3.1-flash-lite-image 的契約一致。正確：一個 text part（編輯指令）+ N 個 inlineData part（每張圖一個）：

"contents": [{
  "parts": [
    {"text": "把這兩張圖裡的人物合成到同一個辦公室場景中"},
    {"inlineData": {"mimeType": "image/png", "data": "<BASE64_DATA_IMG_1>"}},
    {"inlineData": {"mimeType": "image/png", "data": "<BASE64_DATA_IMG_2>"}}
  ]
}]

錯誤（每個 part 同時塞了 text 和 inlineData，會導致非預期行為）：

"contents": [{
  "parts": [
    {"inlineData": {...}, "text": "這是提示詞嗎 1"},
    {"inlineData": {...}, "text": "這是提示詞嗎 2"}
  ]
}]

🖼️ 關於 inlineData.data 欄位本介面是 JSON 格式（非 multipart 檔案上傳），所以 Playground 無法直接選擇本地檔案，需要先把圖片轉成 Base64 字串再貼上到 data 輸入框。一行命令轉換 + 自動複製到剪貼簿：

# macOS
base64 -i your-image.jpg | tr -d '\n' | pbcopy

# Linux
base64 -w0 your-image.jpg | xclip -selection clipboard

# Windows PowerShell
[Convert]::ToBase64String([IO.File]::ReadAllBytes("your-image.jpg")) | Set-Clipboard

執行後直接在 Playground 的 data 欄位 Cmd+V / Ctrl+V 貼上即可。同時記得把 mimeType 切換為對應的 image/jpeg 或 image/png。建議：測試用小圖（少於 200KB），避免 base64 字串過長導致瀏覽器卡頓。頻繁測試圖片編輯更推薦用下方程式碼示例直接在本地執行。

程式碼示例

Python

import requests
import base64

API_KEY = "sk-your-api-key"

# 讀取待編輯的圖片
with open("input.jpg", "rb") as f:
    image_b64 = base64.b64encode(f.read()).decode()

response = requests.post(
    "https://api.apiyi.com/v1beta/models/gemini-3.1-flash-lite-image:generateContent",
    headers={"Authorization": f"Bearer {API_KEY}", "Content-Type": "application/json"},
    json={
        "contents": [{
            "parts": [
                {"text": "請把背景模糊化，突出前景的人物"},
                {"inlineData": {"mimeType": "image/jpeg", "data": image_b64}}
            ]
        }],
        "generationConfig": {
            "responseModalities": ["IMAGE"],
            "imageConfig": {"aspectRatio": "16:9", "imageSize": "1K"}
        }
    },
    timeout=300
).json()

img_data = response["candidates"][0]["content"]["parts"][0]["inlineData"]["data"]
with open("edited.png", 'wb') as f:
    f.write(base64.b64decode(img_data))
print("編輯後的圖片已儲存至 edited.png")

Node.js

import fs from "fs";

const API_KEY = "sk-your-api-key";
const imageB64 = fs.readFileSync("input.jpg").toString("base64");

const response = await fetch(
  "https://api.apiyi.com/v1beta/models/gemini-3.1-flash-lite-image:generateContent",
  {
    method: "POST",
    headers: {
      "Authorization": `Bearer ${API_KEY}`,
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      contents: [{
        parts: [
          { text: "請把背景模糊化，突出前景的人物" },
          { inlineData: { mimeType: "image/jpeg", data: imageB64 } }
        ]
      }],
      generationConfig: {
        responseModalities: ["IMAGE"],
        imageConfig: { aspectRatio: "16:9", imageSize: "1K" }
      }
    })
  }
);

const data = await response.json();
const imgBase64 = data.candidates[0].content.parts[0].inlineData.data;
fs.writeFileSync("edited.png", Buffer.from(imgBase64, "base64"));

cURL

# 注意：需要先將圖片轉為 base64 字串
# IMAGE_B64=$(base64 -i input.jpg | tr -d '\n')

curl -X POST "https://api.apiyi.com/v1beta/models/gemini-3.1-flash-lite-image:generateContent" \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{
      "parts": [
        {"text": "請把背景模糊化，突出前景的人物"},
        {"inlineData": {"mimeType": "image/jpeg", "data": "'"$IMAGE_B64"'"}}
      ]
    }],
    "generationConfig": {
      "responseModalities": ["IMAGE"],
      "imageConfig": {"aspectRatio": "16:9", "imageSize": "1K"}
    }
  }'

多圖編輯示例

把多張圖作為輸入合成或對比時，只用一個 text part（編輯指令），後面追加多個 inlineData part（每張圖一個）。

Python（多圖）

import requests
import base64

API_KEY = "sk-your-api-key"

def to_b64(path):
    with open(path, "rb") as f:
        return base64.b64encode(f.read()).decode()

# 準備多張圖（這裡以 2 張為例，最多可上傳多張）
images = ["person1.png", "person2.png"]
parts = [{"text": "把這兩張圖裡的人物合成到同一個辦公室場景中，做著搞怪表情"}]
for path in images:
    parts.append({"inlineData": {"mimeType": "image/png", "data": to_b64(path)}})

response = requests.post(
    "https://api.apiyi.com/v1beta/models/gemini-3.1-flash-lite-image:generateContent",
    headers={"Authorization": f"Bearer {API_KEY}", "Content-Type": "application/json"},
    json={
        "contents": [{"parts": parts}],
        "generationConfig": {
            "responseModalities": ["TEXT", "IMAGE"],
            "imageConfig": {"aspectRatio": "5:4", "imageSize": "1K"}
        }
    },
    timeout=300
).json()

img_data = response["candidates"][0]["content"]["parts"][0]["inlineData"]["data"]
with open("merged.png", "wb") as f:
    f.write(base64.b64decode(img_data))

引數說明速查

引數	型別	必填	說明
`contents[].parts`	array	是	由「1 個 text part + N 個 inlineData part」組成。每個 part 只能含 `text` 或 `inlineData` 之一，不可同時出現
`contents[].parts[].text`	string	是	編輯指令（建議只放在第一個 part 中）
`contents[].parts[].inlineData.mimeType`	string	是	`image/jpeg` 或 `image/png`
`contents[].parts[].inlineData.data`	string	是	圖片的 Base64 編碼（多圖編輯時重複多個 inlineData part）
`generationConfig.responseModalities`	array	是	通常為 `["IMAGE"]`
`generationConfig.imageConfig.aspectRatio`	string	否	14 種寬高比，預設 `1:1`
`generationConfig.imageConfig.imageSize`	string	否	僅支援 `1K`（Lite 專注 1K 畫布）

多輪對話式編輯

Nano Banana 2 Lite（gemini-3.1-flash-lite-image）支援對話式多輪編輯：把模型每一輪產出的圖片，作為 role: "model" 的 inlineData 追加回 contents，再發下一條 user 指令。模型會基於完整對話歷史繼續修改並累積效果（例如先改沙發顏色、再加配飾，前一步的改動會保留）。

import requests, base64

API_KEY = "sk-your-api-key"
URL = "https://api.apiyi.com/v1beta/models/gemini-3.1-flash-lite-image:generateContent"
H = {"Authorization": f"Bearer {API_KEY}", "Content-Type": "application/json"}
CFG = {"responseModalities": ["IMAGE"], "imageConfig": {"aspectRatio": "1:1", "imageSize": "1K"}}

contents = []  # 全程維護同一個對話歷史

def turn(instruction, save_to):
    contents.append({"role": "user", "parts": [{"text": instruction}]})
    data = requests.post(URL, headers=H,
                         json={"contents": contents, "generationConfig": CFG}, timeout=300).json()
    part = next(p for p in data["candidates"][0]["content"]["parts"] if "inlineData" in p)
    contents.append({"role": "model", "parts": [part]})   # 關鍵：把產出的圖回填進歷史
    with open(save_to, "wb") as f:
        f.write(base64.b64decode(part["inlineData"]["data"]))
    return part

turn("生成一隻橙色的貓，坐在藍色沙發上，簡筆畫風格", "step1.png")
turn("把沙發改成紅色，貓和構圖保持不變", "step2.png")       # 基於上一輪的圖修改
turn("給貓戴一頂黃色小帽子，其它保持不變", "step3.png")       # 繼續累積，紅沙發會保留

從已有圖片開始多輪：第一輪的 user 訊息裡放 inlineData（你自己的圖）+ 指令即可編輯現有照片，之後每輪照樣把模型產出回填進 contents。

授權

Authorization

string

header

必填

在 API易控制台获取的 API Key

主體

application/json

contents

object[]

必填

内容数组，包含编辑指令和待编辑的图片

Show child attributes

generationConfig

object

必填

Show child attributes

回應

成功生成图片

candidates

object[]

生成结果数组

Show child attributes

usageMetadata

object

Show child attributes

文生圖 API 參考 Nano Banana Lite Agent 技能

產品基礎

基礎 API

圖片 API（官轉）

影片 API（官轉）

多模態理解 API

文本 API

程式碼示例

Python

Node.js

cURL

多圖編輯示例

Python（多圖）

引數說明速查

多輪對話式編輯

授權

主體

回應

​程式碼示例

​Python

​Node.js

​cURL

​多圖編輯示例

​Python（多圖）

​引數說明速查

​多輪對話式編輯

授權

主體

回應

程式碼示例

Python

Node.js

cURL

多圖編輯示例

Python（多圖）

引數說明速查

多輪對話式編輯