curl --request POST \
  --url https://api.powertokens.ai/v1/images/edits \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "qwen-image-2.0-pro",
  "response_format": "url",
  "input": {
    "messages": [
      {
        "role": "user",
        "content": [
          {
            "image": "https://example.com/source.webp"
          },
          {
            "text": "Replace the background with a seaside sunset"
          }
        ]
      }
    ]
  },
  "n": 2,
  "size": "1536*1024",
  "watermark": false,
  "prompt_extend": true,
  "negative_prompt": "low quality",
  "seed": 0
}
'

{
  "created": 123,
  "data": [
    {
      "url": "<string>",
      "b64_json": "<string>",
      "revised_prompt": "<string>"
    }
  ],
  "metadata": {}
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": "<string>",
    "param": "<string>"
  }
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": "<string>",
    "param": "<string>"
  }
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": "<string>",
    "param": "<string>"
  }
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": "<string>",
    "param": "<string>"
  }
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": "<string>",
    "param": "<string>"
  }
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": "<string>",
    "param": "<string>"
  }
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": "<string>",
    "param": "<string>"
  }
}

Alibaba

Qwen Image Edit

Calls Ali qwen-image-2.0-pro to perform single-image editing or multi-image fusion.

The public calling convention keeps top-level model, input, response_format, and exposes n, size, watermark, prompt_extend, negative_prompt, seed as top-level fields. Input images are placed in input.messages[0].content[].image, and the editing instruction is in a text item within the same array. The request body does not accept a top-level parameters field.

POST

images

edits

curl --request POST \
  --url https://api.powertokens.ai/v1/images/edits \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "qwen-image-2.0-pro",
  "response_format": "url",
  "input": {
    "messages": [
      {
        "role": "user",
        "content": [
          {
            "image": "https://example.com/source.webp"
          },
          {
            "text": "Replace the background with a seaside sunset"
          }
        ]
      }
    ]
  },
  "n": 2,
  "size": "1536*1024",
  "watermark": false,
  "prompt_extend": true,
  "negative_prompt": "low quality",
  "seed": 0
}
'

{
  "created": 123,
  "data": [
    {
      "url": "<string>",
      "b64_json": "<string>",
      "revised_prompt": "<string>"
    }
  ],
  "metadata": {}
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": "<string>",
    "param": "<string>"
  }
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": "<string>",
    "param": "<string>"
  }
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": "<string>",
    "param": "<string>"
  }
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": "<string>",
    "param": "<string>"
  }
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": "<string>",
    "param": "<string>"
  }
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": "<string>",
    "param": "<string>"
  }
}

{
  "error": {
    "message": "<string>",
    "type": "<string>",
    "code": "<string>",
    "param": "<string>"
  }
}

Authorizations

Authorization

string

header

required

Pass Authorization: Bearer <token> in the request header.

Body

application/json

model

enum<string>

required

Model name. Example: qwen-image-2.0-pro.

Available options:

qwen-image-2.0-pro

input

object

required

Show child attributes

response_format

enum<string>

default:url

Response format. url returns an image download link; b64_json returns Base64-encoded image data. Default is url.

Available options:

url,

b64_json

integer

Number of output images. Default is 1. For the qwen-image-2.0 series, you can generate 1-6 images.

Required range: 1 <= x <= 6

size

string

default:512*512

Output image resolution in width*height format, for example 1024*1536. For the qwen-image-2.0 series, total pixels must be between 512*512 and 2048*2048. By default, total pixels are close to 1024*1024, and the aspect ratio is close to the input image (for multi-image input, the last image). Recommended common resolutions: 1:1 1024*1024, 1536*1536; 2:3 768*1152, 1024*1536; 3:2 1152*768, 1536*1024; 3:4 960*1280, 1080*1440; 4:3 1280*960, 1440*1080; 9:16 720*1280, 1080*1920; 16:9 1280*720, 1920*1080; 21:9 1344*576, 2048*872.

watermark

boolean

default:false

Whether to add a "Qwen-Image" watermark in the lower-right corner of the image. Default is false.

prompt_extend

boolean

Whether to enable smart prompt rewriting. Default is true. When enabled, the model optimizes the positive prompt (text), which is especially helpful for simple prompts.

negative_prompt

string

Negative prompt used to describe content you do not want to see in the image and to constrain the image. Chinese and English are supported. Maximum length is 500 characters.

seed

integer<int64>

Random seed. Range [0, 2147483647]. Using the same seed value can make generated content relatively stable. If omitted, the algorithm automatically uses a random seed. Note: generation is probabilistic, so the same seed cannot guarantee identical results every time.

Response

Success. Returns the image editing result.

created

integer<int64>

Creation time as a Unix timestamp (seconds).

data

object[]

List of generated images.

Show child attributes

metadata

object

Additional result information. Field contents vary by capability.

Image to Image

Qwen Text to Image

Chat Models

Image Models

Video Models

Audio Models

asset library

Qwen Image Edit

Authorizations

Body

Response