Qwen Image 3.0 Pro

curl --request POST \
  --url https://api.evolink.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "qwen-image-3.0-pro",
  "prompt": "An orange cat wearing an astronaut helmet, cyberpunk neon background"
}
'

{
  "created": 1757156493,
  "id": "task-unified-1757156493-imcg5zqt",
  "model": "qwen-image-3.0-pro",
  "object": "image.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": true,
    "estimated_time": 30
  },
  "type": "image",
  "usage": {
    "billing_rule": "per_call",
    "credits_reserved": 1,
    "user_group": "default"
  }
}

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid request parameters",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid or expired token",
    "type": "authentication_error"
  }
}

{
  "error": {
    "code": "insufficient_quota",
    "message": "Insufficient quota. Please top up your account.",
    "type": "insufficient_quota"
  }
}

{
  "error": {
    "code": "model_access_denied",
    "message": "Token does not have access to model: qwen-image-3.0-pro",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Too many requests, please try again later",
    "type": "rate_limit_error"
  }
}

{
  "error": {
    "code": "internal_error",
    "message": "Internal server error",
    "type": "api_error"
  }
}

POST

images

generations

curl --request POST \
  --url https://api.evolink.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "qwen-image-3.0-pro",
  "prompt": "An orange cat wearing an astronaut helmet, cyberpunk neon background"
}
'

{
  "created": 1757156493,
  "id": "task-unified-1757156493-imcg5zqt",
  "model": "qwen-image-3.0-pro",
  "object": "image.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": true,
    "estimated_time": 30
  },
  "type": "image",
  "usage": {
    "billing_rule": "per_call",
    "credits_reserved": 1,
    "user_group": "default"
  }
}

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid request parameters",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid or expired token",
    "type": "authentication_error"
  }
}

{
  "error": {
    "code": "insufficient_quota",
    "message": "Insufficient quota. Please top up your account.",
    "type": "insufficient_quota"
  }
}

{
  "error": {
    "code": "model_access_denied",
    "message": "Token does not have access to model: qwen-image-3.0-pro",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Too many requests, please try again later",
    "type": "rate_limit_error"
  }
}

{
  "error": {
    "code": "internal_error",
    "message": "Internal server error",
    "type": "api_error"
  }
}

Authorizations

Authorization

string

header

required

##All APIs require Bearer Token authentication##

Get API Key:

Visit API Key Management Page to get your API Key

Add to request header:

Authorization: Bearer YOUR_API_KEY

Body

application/json

model

enum<string>

default:qwen-image-3.0-pro

required

Model name

Available options:

qwen-image-3.0-pro

Example:

"qwen-image-3.0-pro"

prompt

string

required

Prompt describing the image to generate (text-to-image), or how to edit the input image (image editing). Limited to 4500 tokens

Maximum string length: 4500

Example:

"Replace the background of this image"

image_urls

string<uri>[]

Reference image URL list (optional). Not provided or empty array = text-to-image (T2I); provide 1-3 images = image editing (I2I)

Note:

Number of input images supported per request: 0-3 images, more than 3 will return an error
Only public http/https image URLs are supported, base64 / data-url is not supported
Image width and height must both be within the [384-3072] pixel range
Supported file formats: .jpg, .jpeg, .png, .bmp, .webp, .tiff
Image URLs must be directly accessible by the server, or the image URL should directly download when accessed (typically these URLs end with image file extensions, such as .png, .jpg)

Example:

[
  "https://example.com/image1.png",
  "https://example.com/image2.png"
]

integer

default:1

Specifies the number of images to generate, supports any integer value between [1,6]

Note:

Each request will be pre-charged based on the value of n, actual charges are based on the number of images generated

Required range: 1 <= x <= 6

Example:

1

negative_prompt

string

Negative prompt to describe content you don't want to see in the image, used to constrain the output

Note:

Supports Chinese and English, maximum length of 500 characters, each Chinese character/letter counts as one character, excess will be automatically truncated

Maximum string length: 500

Example:

"low resolution, error, worst quality, low quality, mutilated, extra fingers, bad proportions"

size

string

default:auto

Generated image size, default auto:

auto (default): the model automatically selects a suitable output size
Width x Height: such as 1024x1024, 1024x1536, 1536x1024, etc., where width and height both range from [512, 2048] pixels

Note:

Explicitly specifying a size is only available when the number of output images n is 1, otherwise an error will be returned; auto is not subject to this restriction

Example:

"1024x1024"

prompt_extend

boolean

default:false

Whether to enable intelligent prompt rewriting. Default value is false (does not rewrite the user's prompt without permission); only when explicitly set to true will a large model be used to optimize the positive prompt, with noticeable improvement for insufficiently descriptive or simpler prompts

Example:

true

watermark

boolean

default:false

Whether to add "Qwen-Image" watermark to the bottom right corner of the image. Default value is false

Example:

false

seed

integer

Random seed, range [0, 2147483647], using the same seed value can keep generated content relatively stable

Note:

If not provided, the algorithm will automatically use a random seed
Model generation process is probabilistic, even with the same seed, results cannot be guaranteed to be completely identical each time

Required range: 0 <= x <= 2147483647

Example:

12345

callback_url

string<uri>

HTTPS callback address after task completion

Callback Timing:

Triggered when task is completed, failed, or cancelled
Sent after billing confirmation is completed

Security Restrictions:

Only HTTPS protocol is supported
Callback to internal IP addresses is prohibited (127.0.0.1, 10.x.x.x, 172.16-31.x.x, 192.168.x.x, etc.)
URL length must not exceed 2048 characters

Callback Mechanism:

Timeout: 10 seconds
Maximum 3 retries on failure (retries after 1 second/2 seconds/4 seconds)
Callback response body format is consistent with the task query API response format
Callback address returning 2xx status code is considered successful, other status codes will trigger retry

Example:

"https://your-domain.com/webhooks/image-task-completed"

Response

Image task created successfully

created

integer

Task creation timestamp

Example:

1757156493

string

Task ID

Example:

"task-unified-1757156493-imcg5zqt"

model

string

Actual model name used

Example:

"qwen-image-3.0-pro"

object

enum<string>

Specific task type

Available options:

image.generation.task

progress

integer

Task progress percentage (0-100)

Required range: 0 <= x <= 100

Example:

0

status

enum<string>

Task status

Available options:

pending,

processing,

completed,

failed

Example:

"pending"

task_info

object

Asynchronous task information

Show child attributes

type

enum<string>

Task output type

Available options:

text,

image,

audio,

video

Example:

"image"

usage

object

Usage and billing information

Show child attributes

Z Image Turbo Image Generation Qwen Image Edit Plus

Image Series

Video Series

Audio Series

Text Series

Account Management

Task Management

File Management

Authorizations

Body

Response