Qwen synchronous | Qwen Cloud

POST

/services/aigc/multimodal-generation/generation

cURL

curl --location 'https://dashscope-intl.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation' \
--header 'Content-Type: application/json' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--data '{
  "model": "qwen-image-2.0-pro",
  "input": {
    "messages": [
      {
        "role": "user",
        "content": [
          {
            "text": "Healing-style hand-drawn poster featuring three puppies playing with a ball on lush green grass. The main title Come Play Ball! is prominently displayed at the top in bold, blue cartoon font."
          }
        ]
      }
    ]
  },
  "parameters": {
    "negative_prompt": "",
    "prompt_extend": true,
    "watermark": false,
    "size": "2048*2048"
  }
}'

{
  "output": {
    "choices": [
      {
        "finish_reason": "stop",
        "message": {
          "content": [
            {
              "image": "https://dashscope-result-sh.oss-cn-shanghai.aliyuncs.com/xxx.png?Expires=xxx"
            }
          ],
          "role": "assistant"
        }
      }
    ]
  },
  "usage": {
    "height": 928,
    "image_count": 1,
    "width": 1664
  },
  "request_id": "d0250a3d-b07f-49e1-bdc8-6793f4929xxx"
}

Get an API key and set it as an environment variable. If using the SDK, install it.

Authorizations

string

header

required

DashScope API Key. Create one in the Qwen Cloud console.

Body

application/json

enum<string>

required

Model name.

Available options:qwen-image-2.0-pro,qwen-image-2.0,qwen-image-max,qwen-image-plus,qwen-image

Example:qwen-image-2.0-pro

object

required

Input data containing the messages array.

Show child attributes

object[]

required

Single-turn only. Exactly one message with role user.

Required range:items: 1–1

Show child attributes

enum<string>

required

Must be user.

Available options:user

object[]

required

Message content array. Must contain exactly one text object.

Required range:items: 1–1

Show child attributes

string

required

Positive prompt describing the desired content, style, and composition. Max 800 characters. Excess is auto-truncated.

Example:Healing-style hand-drawn poster featuring three puppies playing with a ball on lush green grass.

Required range:length <= 800

object

Image generation parameters.

Show child attributes

string

Describes content you do NOT want in the image. Max 500 characters. Excess is auto-truncated.

Required range:length <= 500

string

default"2048*2048"

Output resolution as width*height. qwen-image-2.0 series: total pixels between 512*512 and 2048*2048, default 2048*2048. qwen-image-max: supports custom resolution (total pixels between 512*512 and 2048*2048) and fixed sizes. qwen-image-plus/image: fixed sizes only. Fixed sizes for qwen-image-max/plus/image: 1664*928 (16:9, default), 1472*1104 (4:3), 1328*1328 (1:1), 1104*1472 (3:4), 928*1664 (9:16).

Example:2048*2048

integer

default1

Number of images to generate. Default: 1. qwen-image-2.0 series: 1-6. qwen-image-max/plus series: fixed at 1.

Required range:1 <= x <= 6

boolean

defaulttrue

Enable prompt rewriting. true (default): model optimizes the prompt. false: use your prompt as-is.

boolean

defaultfalse

Add a "Qwen-Image" watermark to the bottom-right corner. Default: false.

integer

Random number seed. Range: [0, 2147483647]. Same seed produces more consistent (but not identical) results. If omitted, a random seed is used.

Required range:0 <= x <= 2147483647

Response

200-application/json

object

Show child attributes

object[]

List of generated results. Contains one element per generated image.

Show child attributes

string

stop means normal completion.

Example:stop

object

Show child attributes

enum<string>

Always assistant.

Available options:assistant

object[]

Response content array.

Show child attributes

string

URL of the generated image (PNG). Valid for 24 hours. Download promptly.

object

Task result statistics. Not returned for qwen-image-2.0 series.

Show child attributes

integer

Total number of tasks.

integer

Number of successful tasks.

integer

Number of failed tasks.

object

Usage statistics (successful results only).

Show child attributes

integer

Number of images generated.

integer

Width of the generated image in pixels.

integer

Height of the generated image in pixels.

string

default"d0250a3d-b07f-49e1-bdc8-6793f4929xxx"

Unique request identifier for tracing and troubleshooting.

Example:abf1645b-b630-433a-92f6-xxxxxx