2. 图生图 / 多图参考 / 局部重绘

POST

/v2/images/edits

基于一张或多张图片生成新图：图生图、多图参考合成、局部重绘都用这个接口。接口地址：POST https://image.kuaipao.pro/v2/images/edits。

multipart/form-data：与 OpenAI 官方接口一致，直接上传图片文件，多张图重复传 image 字段（也兼容 image[]）。

application/json：image 传图片 URL 或 data URL，多张图传数组。

mask 只有 gpt-image 系列支持：完全透明的区域表示需要重绘的部分，尺寸需与第一张图相同。

各模型支持的参考图数量见「v2 接入说明 / 图像模型能力表」。

请求示例（JSON，多图参考）

请求示例（上传文件，局部重绘）

请求参数

Authorization

Bearer Token

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Body 参数

application/json

必填

示例

多图参考合成局部重绘（mask）data URL 传图

{
    "model": "gemini-3-pro-image-preview-token",
    "prompt": "把图片1里的商品放到图片2的场景里，保持商品颜色和材质",
    "image": [
        "https://example.com/assets/product.png",
        "https://example.com/assets/scene.jpg"
    ],
    "aspect_ratio": "4:3",
    "resolution": "2K"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

多图参考合成局部重绘（mask）data URL 传图

curl --location '/v2/images/edits' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "model": "gemini-3-pro-image-preview-token",
    "prompt": "把图片1里的商品放到图片2的场景里，保持商品颜色和材质",
    "image": [
        "https://example.com/assets/product.png",
        "https://example.com/assets/scene.jpg"
    ],
    "aspect_ratio": "4:3",
    "resolution": "2K"
}'

返回响应

🟢200

application/json

生成成功

Bodyapplication/json

示例

返回 URL返回 Base64

{
    "created": 1790557800,
    "data": [
        {
            "url": "https://example.com/images/img-1.png"
        }
    ],
    "size": "1536x1024",
    "quality": "high",
    "output_format": "png"
}

🟠400BadRequest

🟠401Unauthorized

🟠403Forbidden

🟠429TooManyRequests

🔴503ServiceUnavailable

修改于 2026-09-30 13:54:50

1. 文生图

3. 图像完整示例代码