图编辑

POST

https://portal.dongzhou.cloud/v1/images/edits

💡

该接口是图片编辑接口，用于在已有图片基础上，根据 prompt 对图片内容进行修改。

该接口通常使用 multipart/form-data 上传图片文件

适用于局部修图、背景替换、元素增删、风格调整等场景。

请求参数

Header 参数

Body 参数multipart/form-data必填

返回响应

🟢200非流式

application/json

Bodyapplication/json

🟢200流式

请求示例

Shell

JavaScript

Java

Swift

curl --location 'https://portal.dongzhou.cloud/v1/images/edits' \
--header 'authorization: Bearer sk-6IDouxxxxxxxx' \
--form 'image=@""' \
--form 'prompt="Create a lovely gift basket with these four items in it"' \
--form 'model="gpt-image-1.5"' \
--form 'background="auto"' \
--form 'input_fidelity="high"' \
--form 'mask=@""' \
--form 'moderation="auto"' \
--form 'n="1"' \
--form 'output_compression="100"' \
--form 'output_format="png"' \
--form 'partial_images="1"' \
--form 'quality="high"' \
--form 'size="1024x1024"' \
--form 'stream="false"' \
--form 'user="user-1234"'

响应示例

200 - 非流式 - 成功示例

{
    "background": "opaque",
    "created": 1778820383,
    "data": [
        {
            "b64_json": "iVBORw0KGg"
        }
    ],
    "model": "gpt-image-2",
    "output_format": "png",
    "quality": "high",
    "size": "1536x1024",
    "usage": {
        "input_tokens": 797,
        "input_tokens_details": {
            "image_tokens": 782,
            "text_tokens": 15
        },
        "output_tokens": 5488,
        "output_tokens_details": {
            "image_tokens": 5488,
            "text_tokens": 0
        },
        "total_tokens": 6285
    }
}

修改于 2026-05-15 06:13:47

文生图

Responses Api