> ## Documentation Index > Fetch the complete documentation index at: https://evolink.ai/docs/llms.txt > Use this file to discover all available pages before exploring further. # Qwen Image 3.0 > - Qwen (qwen-image-3.0) is the **standard edition** of Qwen image generation and editing 3.0. It supports the same two modes — text-to-image (T2I, no reference image) and image editing (I2I, with 1-3 reference images) — balancing quality and speed - Request parameters, size semantics and response structure are **identical** to [qwen-image-3.0-pro](/en/api-manual/image-series/qwen/qwen-image-3.0-pro); only generation quality and price differ - Asynchronous processing mode, use the returned task ID to [query](/en/api-manual/task-management/get-task-detail) - Generated image links are valid for 24 hours, please save them promptly **Billing:** - Billed as "number of output images × resolution tier"; on the standard edition **`1K` and `2K` cost the same** (unlike Pro, where 2K is more expensive) - If reference images are supplied (I2I), **each reference image is billed once on top**; this charge is independent of `n` and does not scale with the number of output images - Unit price is lower than Pro — prefer this model when optimizing for cost ## OpenAPI ````yaml en/api-manual/image-series/qwen/qwen-image-3.0.json POST /v1/images/generations openapi: 3.1.0 info: title: qwen-image-3.0 Interface description: >- Use the Qwen Image 3.0 standard edition for image generation and editing, with simplified model parameter configuration license: name: MIT version: 1.0.0 servers: - url: https://api.evolink.ai description: Production environment security: - bearerAuth: [] tags: - name: Image Generation description: AI image generation related APIs paths: /v1/images/generations: post: tags: - Image Generation summary: qwen-image-3.0 Interface description: >- - Qwen (qwen-image-3.0) is the **standard edition** of Qwen image generation and editing 3.0. It supports the same two modes — text-to-image (T2I, no reference image) and image editing (I2I, with 1-3 reference images) — balancing quality and speed - Request parameters, size semantics and response structure are **identical** to [qwen-image-3.0-pro](/en/api-manual/image-series/qwen/qwen-image-3.0-pro); only generation quality and price differ - Asynchronous processing mode, use the returned task ID to [query](/en/api-manual/task-management/get-task-detail) - Generated image links are valid for 24 hours, please save them promptly **Billing:** - Billed as "number of output images × resolution tier"; on the standard edition **`1K` and `2K` cost the same** (unlike Pro, where 2K is more expensive) - If reference images are supplied (I2I), **each reference image is billed once on top**; this charge is independent of `n` and does not scale with the number of output images - Unit price is lower than Pro — prefer this model when optimizing for cost operationId: createQwenImage30Generation requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/QwenImageEditRequest' examples: text_to_image: summary: Text-to-Image (T2I, no reference image) value: model: qwen-image-3.0 prompt: >- An orange cat wearing an astronaut helmet, cyberpunk neon background size: '16:9' quality: 2K image_edit: summary: Image Editing (I2I, with 1-3 reference images) value: model: qwen-image-3.0 prompt: Replace the background of this image image_urls: - https://example.com/image1.png 'n': 2 size: '1:1' quality: 2K responses: '200': description: Image task created successfully content: application/json: schema: $ref: '#/components/schemas/ImageGenerationResponse' '400': description: Invalid request parameters content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: invalid_request message: Invalid request parameters type: invalid_request_error '401': description: Unauthenticated, invalid or expired token content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: unauthorized message: Invalid or expired token type: authentication_error '402': description: Insufficient quota, recharge required content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: insufficient_quota message: Insufficient quota. Please top up your account. type: insufficient_quota '403': description: Access denied content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: model_access_denied message: 'Token does not have access to model: qwen-image-3.0' type: invalid_request_error '429': description: Rate limit exceeded content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: rate_limit_exceeded message: Too many requests, please try again later type: rate_limit_error '500': description: Internal server error content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: internal_error message: Internal server error type: api_error components: schemas: QwenImageEditRequest: type: object required: - model - prompt properties: model: type: string description: Model name enum: - qwen-image-3.0 default: qwen-image-3.0 example: qwen-image-3.0 prompt: type: string description: >- Prompt describing the image to generate (text-to-image), or how to edit the input image (image editing). Limited to 4500 tokens example: Replace the background of this image maxLength: 4500 image_urls: type: array description: >- 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`) items: type: string format: uri example: - https://example.com/image1.png - https://example.com/image2.png 'n': type: integer description: >- 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 - The reference image (`image_urls`) charge is **billed once per uploaded image** and does not scale with `n` minimum: 1 maximum: 6 default: 1 example: 1 negative_prompt: type: string description: >- 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 maxLength: 500 example: >- low resolution, error, worst quality, low quality, mutilated, extra fingers, bad proportions size: type: string description: >- Dimensions of the generated image. Three approaches are supported: **Option 1 - Auto (default):** - `auto`: the model automatically selects an appropriate output size based on the prompt (in this case `quality` has no effect) **Option 2 - Aspect-ratio format:** - `1:1`, `2:3`, `3:2`, `3:4`, `4:3`, `4:5`, `5:4`, `9:16`, `16:9`, `21:9`, `9:21` - Used together with the `quality` parameter; the system automatically converts to the pixels corresponding to the chosen ratio and resolution, with no need to specify them manually **Option 3 - Pixel format:** - width×height, e.g. `1024x1024`, `2048x2048`, `2720x1530`, etc. - Total pixel range: `[262144, 4194304]` (i.e. 512×512 to 2048×2048) - Aspect-ratio range: `[1/16, 16]`; a side may exceed 2048px - Both width and height must be greater than `14px` **Note:** - `size` and `n` are independent; when `n>1` you can still specify a size/ratio - When `size` is omitted, it defaults to `auto` default: auto example: '16:9' quality: type: string description: >- Resolution tier, used together with the aspect-ratio format of `size`; defaults to `1K` (has no effect under `auto` or the pixel format). | Ratio | 1K | 2K | |---|---|---| | `1:1` | 1024×1024 | 2048×2048 | | `2:3` | 832×1248 | 1664×2496 | | `3:2` | 1248×832 | 2496×1664 | | `3:4` | 864×1152 | 1770×2360 | | `4:3` | 1152×864 | 2360×1770 | | `4:5` | 896×1120 | 1792×2240 | | `5:4` | 1120×896 | 2240×1792 | | `9:16` | 800×1424 | 1530×2720 | | `16:9` | 1424×800 | 2720×1530 | | `21:9` | 1568×672 | 3122×1338 | | `9:21` | 672×1568 | 1338×3122 | enum: - 1K - 2K default: 1K example: 2K prompt_extend: type: boolean description: >- 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 default: false example: true watermark: type: boolean description: >- Whether to add "Qwen-Image" watermark to the bottom right corner of the image. Default value is `false` default: false example: false seed: type: integer description: >- 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 minimum: 0 maximum: 2147483647 example: 12345 callback_url: type: string description: >- 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 format: uri example: https://your-domain.com/webhooks/image-task-completed ImageGenerationResponse: type: object properties: created: type: integer description: Task creation timestamp example: 1757156493 id: type: string description: Task ID example: task-unified-1757156493-imcg5zqt model: type: string description: Actual model name used example: qwen-image-3.0 object: type: string enum: - image.generation.task description: Specific task type progress: type: integer description: Task progress percentage (0-100) minimum: 0 maximum: 100 example: 0 status: type: string description: Task status enum: - pending - processing - completed - failed example: pending task_info: $ref: '#/components/schemas/TaskInfo' description: Asynchronous task information type: type: string enum: - text - image - audio - video description: Task output type example: image usage: $ref: '#/components/schemas/Usage' description: Usage and billing information ErrorResponse: type: object properties: error: type: object properties: code: type: string description: Error code identifier message: type: string description: Error description type: type: string description: Error type TaskInfo: type: object properties: can_cancel: type: boolean description: Whether the task can be cancelled example: true estimated_time: type: integer description: Estimated completion time (seconds) minimum: 0 example: 30 Usage: type: object description: Usage and billing information properties: billing_rule: type: string description: Billing rule enum: - per_call - per_image - per_token - per_second example: per_image credits_reserved: type: number description: Estimated credits consumed minimum: 0 example: 2.2483 user_group: type: string description: User group category example: default securitySchemes: bearerAuth: type: http scheme: bearer description: >- ##All APIs require Bearer Token authentication## **Get API Key:** Visit [API Key Management Page](https://evolink.ai/dashboard/keys) to get your API Key **Add to request header:** ``` Authorization: Bearer YOUR_API_KEY ``` ````