Alibaba Qwen Image 3.0 Text To Image API Documentation

Alibaba Qwen Image 3.0 Text To Image API Documentation

Playground

Qwen Image 3.0 Text to Image is a high-quality image generation model that creates high-quality images from text prompts, with advanced prompt understanding, strong visual quality, and up to 2K output for creative and production workflows. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.

Features

Qwen Image 3.0 generates high-quality images from text prompts with strong prompt adherence, detailed rendering, and flexible output sizing. It supports simple resolution tiers, common aspect ratios, prompt expansion, and seed control for reproducible image generation workflows.

Why Choose This?

• High-quality image generation
  Create polished images from natural-language prompts.

• Strong prompt adherence
  Follow detailed prompts for subjects, composition, style, lighting, and visual details.

• Flexible output sizing
  Choose 1k or 2k resolution and select the aspect ratio that matches your target layout.

• Prompt expansion support
  Enable intelligent prompt expansion to enrich the prompt before generation.

• Seed control
  Use a fixed seed for reproducible results, or -1 for random generation.

Parameters

How to Use

1. Write your prompt — Describe the subject, composition, lighting, style, mood, and key visual details.
2. Choose resolution optional — Use 1k for standard generation or 2k when higher-resolution output is needed.
3. Choose aspect ratio optional — Select the layout that matches your target format.
4. Set prompt expansion optional — Keep prompt expansion enabled for richer prompt interpretation, or disable it for stricter prompt control.
5. Set seed optional — Use a fixed seed when you need reproducible results.
6. Submit — Generate the image and retrieve the output URL.

Pricing

Best Use Cases

• Production image generation — Create high-quality visuals for creative and commercial workflows.
• Detailed character art and portraits — Generate characters, faces, outfits, poses, and visual details from text prompts.
• Fashion and beauty visuals — Create editorial-style imagery, product looks, accessories, and styling concepts.
• Marketing assets — Generate campaign visuals, social graphics, thumbnails, and promotional images.
• Creative concept development — Explore visual ideas, scenes, styles, and compositions quickly.

Pro Tips

• Use detailed prompts with subject, composition, lighting, style, mood, and background details.
• Use 1k for fast iteration and 2k when final image detail matters.
• Keep enable_prompt_expansion enabled when you want richer prompt interpretation.
• Disable prompt expansion when you need stricter control over the exact prompt.
• Use a fixed seed when comparing prompt variations or reproducing similar outputs.
• Match the aspect ratio to the final use case, such as square, portrait, or landscape layouts.

Related Models

• Qwen Image 3.0 Text-to-Image — Generate images from text prompts.
• Qwen Image 3.0 Edit — Edit images with natural-language instructions.

## Authentication

For authentication details, please refer to the [Authentication Guide](/api-authentication).

## API Endpoints

### Submit Task & Query Result

<ApiTabs submitUrl={model.submitUrl} resultUrl={model.resultUrl} payload={model.defaultValues} />

## Parameters

### Task Submission Parameters

#### Request Parameters

<RequestParams params={model.params} />

#### Response Parameters

<SubmitResponse />

#### Result Request Parameters

| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| id | string | Yes | - | Task ID |

#### Result Response Parameters

| Parameter | Type | Description |
|-----------|------|-------------|
| code | integer | HTTP status code (e.g., 200 for success) |
| message | string | Status message (e.g., "success") |
| data | object | The prediction data object containing all details |
| data.id | string | Unique identifier for the prediction |
| data.model | string | Model ID used for the prediction |
| data.outputs | array&lt;string \| object&gt; | Array of generated outputs (empty when status is not completed). Items are usually URL strings, but may be text strings or structured result objects, depending on the model. |
| data.urls | object | Object containing related API endpoints |
| data.urls.get | string | URL to poll for the prediction result |
| data.status | string | Status: `created`, `processing`, `completed`, or `failed` |
| data.created_at | string | ISO timestamp of when the request was created |
| data.error | string | Error message (empty if no error occurred) |
| data.timings | object | Object containing timing details |
| data.timings.inference | integer | Inference time in milliseconds |