既梦3.0-图片编辑

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Body 参数multipart/form-data

image

file

必需

源图像 3.0版本仅支持1张。
要编辑的图像 File 对象。必须是png、jpg、webp 等格式。

prompt

string

必需

用于编辑图像的提示词，支持中、英文。
建议不超过300个汉字或600个英文单词。字数过多信息容易分散，模型可能因此忽略细节，只关注重点，造成视图片缺失部分元素。

model

string

必需

模型名称。doubao-seededit-3-0-i2i-250628

示例:

doubao-seededit-3-0-i2i-250628

size

string

可选

3.0 仅支持 adaptive

示例:

adaptive

response_format

enum<string>

可选

返回生成图像的数据格式。必须是 url 或 b64_json之一。URL 仅在图像生成后的 60 分钟内有效。

枚举值:

urlb64_json

默认值:

url

示例:

url

guidance_scale

number

可选

模型输出结果与prompt的一致程度，即生成图像的自由度；值越大，模型自由度越小，与用户输入的提示词相关性越强。取值范围：[1, 10] 之间的浮点数。

默认值:

5.5

watermark

boolean

可选

是否在生成的图片中添加水印。
false：不添加水印（默认值）。
true：在图片右下角添加“AI生成”字样的水印标识。

示例:

false

请求示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'https://api.pawmaas.com/v1/images/edits' \
--header 'Authorization: Bearer <token>' \
--form 'image=@""' \
--form 'prompt=""' \
--form 'model="doubao-seededit-3-0-i2i-250628"' \
--form 'size="adaptive"' \
--form 'response_format="url"' \
--form 'guidance_scale=""' \
--form 'watermark="false"'

返回响应

🟢200成功

application/json

Body

created

integer

必需

data

array [object]

必需

url

string

可选

示例

{
    "model": "doubao-seededit-3-0-i2i-250628",
    "created": 1757336790,
    "data": [
        {
            "url": "https://ark-content-generation-v2-cn-beijing.tos-cn-beijing.volces.com/doubao-seededit-3-0-i2i/0217573367793386282a478bab03bc7688c16d21409762caca085.jpeg?X-Tos-Algorithm=TOS4-HMAC-SHA256&X-Tos-Credential=AKLTYWJkZTExNjA1ZDUyNDc3YzhjNTM5OGIyNjBhNDcyOTQ%2F20250908%2Fcn-beijing%2Ftos%2Frequest&X-Tos-Date=20250908T130630Z&X-Tos-Expires=86400&X-Tos-Signature=6d0d8ddb2c17f4e6f96fe1341c70ff5153b08ecbd1c00f13ed8aeb72050767f0&X-Tos-SignedHeaders=host"
        }
    ],
    "usage": {
        "generated_images": 1,
        "output_tokens": 4096,
        "total_tokens": 4096
    }
}