Wan T2I synchronous | Qwen Cloud

POST

/services/aigc/multimodal-generation/generation

cURL - wan2.6-t2i (sync)

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": "wan2.6-t2i",
  "input": {
    "messages": [
      {
        "role": "user",
        "content": [
          {
            "text": "A flower shop with exquisite windows, a beautiful wooden door, and flowers on display"
          }
        ]
      }
    ]
  },
  "parameters": {
    "prompt_extend": true,
    "watermark": false,
    "n": 1,
    "negative_prompt": "",
    "size": "1280*1280"
  }
}'

{
  "output": {
    "choices": [
      {
        "finish_reason": "stop",
        "message": {
          "content": [
            {
              "image": "https://dashscope-463f.oss-accelerate.aliyuncs.com/xxxx.png?Expires=xxx",
              "type": "image"
            }
          ],
          "role": "assistant"
        }
      }
    ],
    "finished": true
  },
  "usage": {
    "image_count": 1,
    "input_tokens": 0,
    "output_tokens": 0,
    "size": "1280*1280",
    "total_tokens": 0
  },
  "request_id": "815505c6-7c3d-49d7-b197-xxxxxx"
}

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

This synchronous endpoint is for wan2.6-t2i only. Retrieve generated images directly in a single request without polling. For wan2.5 and earlier, or asynchronous processing, use the async submit endpoint.

SDK version requirements

DashScope Python SDK: Version 1.25.7 or later.
DashScope Java SDK: Version 2.22.6 or later.

Authorizations

string

header

required

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

Body

application/json

enum<string>

required

The model name. For the wan2.6-t2i model, use wan2.6-t2i.

Available options:wan2.6-t2i

Example:wan2.6-t2i

object

required

The input object containing the message array.

Show child attributes

object[]

required

An array for the request content. Only single-turn conversations are supported (one set of role and content).

Show child attributes

enum<string>

required

The role of the message. Must be user.

Available options:user

object[]

required

An array for the message content.

Show child attributes

string

required

The positive prompt describing the content, style, and composition of the image to generate. Chinese and English are supported. Maximum 2,100 characters. Only one text is allowed per request.

Example:A flower shop with exquisite windows, a beautiful wooden door, and flowers on display

object

Parameters for wan2.6-t2i model.

Show child attributes

string

Optional. Describes content you do not want in the image. Maximum 500 characters. Chinese and English supported. Example: low resolution, low quality, deformed limbs, deformed fingers, oversaturated, waxy, no facial details, overly smooth, AI-like, chaotic composition, blurry text, distorted text.

string

default"1280*1280"

The resolution of the output image in width*height format. Default: 1280*1280. The total number of pixels must be between 12801280 and 14401440, and the aspect ratio must be between 1:4 and 4:1. Recommended resolutions: 1:1 (12801280), 3:4 (11041472), 4:3 (14721104), 9:16 (9601696), 16:9 (1696*960).

Example:1280*1280

integer

default4

The number of images to generate. Value: 1 to 4. Default: 4. Note: billing is per image (Cost = Unit price x Number of images). Set to 1 for testing.

Required range:1 <= x <= 4

boolean

defaulttrue

Whether to enable prompt rewriting. When enabled, this feature uses an LLM to optimize the positive prompt, significantly improving results for shorter prompts but adding a few seconds to processing time. Default: true.

boolean

defaultfalse

Whether to add a watermark in the lower-right corner of the image with the text "AI-generated". Default: false.

integer

Optional. Random number seed. Range: [0, 2147483647]. Using the same seed produces more consistent results, but identical results are not guaranteed. If not provided, the system uses a random number.

Required range:0 <= x <= 2147483647

Response

200-application/json

object

Show child attributes

object[]

List of generated results.

Show child attributes

string

stop indicates normal completion.

Example:stop

object

Show child attributes

enum<string>

Always assistant.

Available options:assistant

object[]

Response content array containing generated image URLs.

Show child attributes

string

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

enum<string>

Content type. Always image.

Available options:image

boolean

Whether the generation has completed.

object

Usage statistics.

Show child attributes

integer

Number of images generated.

integer

Number of input tokens. Currently fixed at 0.

integer

Number of output tokens. Currently fixed at 0.

string

Resolution of the generated image(s).

integer

Total tokens consumed. Currently fixed at 0.

string

default"815505c6-7c3d-49d7-b197-xxxxxx"

Unique request identifier for tracing and troubleshooting.

​SDK version requirements

Authorizations

Body

Response

SDK version requirements