图像编辑 - Modex

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Body 参数multipart/form-data

model

enum<string>

必需

模型名称，用于图像生成的模型。推荐使用 qwen-image-edit

值:

qwen-image-edit

示例:

qwen-image-edit

image

file

必需

源图像（最多传入1张图）
要编辑的图像 File 对象或对象数组。必须是有效的图片文件且小于 10MB。图像格式：JPG、JPEG、PNG、BMP、TIFF、WEBP。

prompt

string

必需

提示词，所需图像的文本描述。最大长度为 800 个字符。

negative_prompt

string

可选

描述不希望在画面中看到的内容。
示例值：低分辨率、错误、最差质量、低质量、残缺、多余的手指、比例不良等。

n

integer

可选

（默认值 1，1～4张）一次性生成的图片数量：数量越多生成速度越慢。
qwen-image-edit只支持生成一张，请勿超过1张，否则扣费会*n。

response_format

enum<string>

可选

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

枚举值:

urlb64_json

默认值:

url

seed

integer

可选

随机数种子。取值范围是[0, 2147483647]。

如果不提供，则算法自动生成一个随机数作为种子。

如果您希望生成内容保持相对稳定，请使用相同的seed参数值。

提示：模型生成过程具有概率性，因此即使使用相同的 seed，也不能保证每次生成结果完全一致。

请求示例代码

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 'model="qwen-image-edit"' \
--form 'image=@""' \
--form 'prompt=""' \
--form 'negative_prompt=""' \
--form 'n=""' \
--form 'response_format=""' \
--form 'seed=""'

返回响应

🟢200成功

application/json

Body

created

integer

必需

data

array [object]

必需

url

string

可选

示例

URL成功示例Base64成功示例

{
    "created": 1757255628,
    "data": [
        {
            "url": "https://dashscope-result-sh.oss-cn-shanghai.aliyuncs.com/7d/ef/20250907/0eea5e95/36e551bc-216a-4e88-bfa6-72dc738722a6-1.png?Expires=1757861427&OSSAccessKeyId=LTAI5tKPD3TMqf2Lna1fASuh&Signature=mCw%2FUlMTfV1xXrloIg63uXO4Q70%3D"
        }
    ],
    "usage": {
        "total_tokens": 0,
        "input_tokens": 0,
        "output_tokens": 0,
        "input_tokens_details": {
            "text_tokens": 0,
            "image_tokens": 0
        }
    }
}