Qwen-Image 3.0 API

Generate or edit one image through GoEnhance with the qwen-image-3 model. Use a prompt alone for text-to-image, or add one to three reference URLs for image editing. GoEnhance provides independent API access; it is not an official Alibaba API or an Alibaba affiliate.
Create an API Key
Abstract studio scene representing Qwen-Image 3.0 API generation

Build Generation and Editing Into One Workflow

One Endpoint, Two Modes

POST to /api/v1/images/generations with model: qwen-image-3. Supply only a prompt for text-to-image, or include one to three accessible reference-image URLs for editing. Every request returns one image.
Glass art objects in a single studio scene suggesting image generation and editing

Asynchronous Results by Design

A successful submission returns an img_uuid. Persist it, poll GET /api/v1/jobs/detail, or provide a public HTTPS callback URL to receive processing, success, and failed status changes.
Unbranded data corridor with a continuous light trail representing async delivery
Validate the documented fields before submitting a generation or edit task.

Qwen-Image 3.0 API Parameters

Model ID

Set model to the exact value qwen-image-3.

Prompt

Provide 1–2000 characters describing the desired image or edit.

Aspect Ratio

Use auto or a documented ratio from 1:1 through 1:8 and 8:1.

Output Tier

Choose 1K or 2K; the documented default is 2K.

Reference Images

Optionally provide one to three image URLs, each under 10 MB, for editing.

Prompt Controls

Optionally set a negative prompt, seed, and direct or agent prompt extension mode.
Pricing is based on the output plus any reference-image surcharge.

Qwen-Image 3.0 API Pricing

Output Price

Each 1K or 2K output costs 1.75 tokens, equal to $0.035 per generated image.

Reference Surcharge

Each reference image adds 0.19 tokens, equal to $0.0039 per reference image.

Task Accounting

A request with two references costs 2.13 tokens: 1.75 + (2 × 0.19).

Integrate the Qwen-Image 3.0 API

1

Create the Request

Send your API credential in the Authorization header, then POST a JSON body with model and prompt. Add ratio, image size, or reference URLs only when needed.
2

Persist the Task ID

Check for code: 0 and store the returned img_uuid. Treat insufficient-token and authentication responses as failures rather than image results.
3

Resolve Completion

Poll the job-detail endpoint or use a public HTTPS callback. Accept the asset only after the task reaches success; handle failed status explicitly.
Create an API Key
Add image generation and controlled edits to production workflows without building a model-serving stack.

Developer Use Cases

Product Visuals

Create campaign-ready product concepts from structured prompts.

Creative Variations

Generate fresh visual directions for ads, posts, and landing pages.

Reference-Guided Edits

Transform one to three supplied references while preserving prompt intent.

Localized Campaigns

Produce market-specific visual concepts from localized creative briefs.

Asset Pipelines

Queue asynchronous generation jobs inside automated content workflows.

Design Prototyping

Explore composition, material, and color ideas before final production.
Answers to common pricing, input, and integration questions.

Qwen-Image 3.0 API FAQ

What is the Qwen-Image 3.0 API endpoint?

Send POST requests to https://api.goenhance.ai/api/v1/images/generations with model: qwen-image-3.

How much does the Qwen-Image 3.0 API cost?

The documented output price is 1.75 tokens, or $0.035, for either 1K or 2K. Each reference image adds 0.19 tokens, or $0.0039.

Can the API edit existing images?

Yes. Add image_list with one to three accessible image URLs, each under 10 MB. Omit the field for pure text-to-image generation.

Which aspect ratios are supported?

The API supports auto, 1:1, 16:9, 9:16, 4:3, 3:4, 2:3, 3:2, 1:2, 2:1, 1:4, 4:1, 1:8, and 8:1. The 1:8 and 8:1 outputs are limited to the 1K tier.

How do callbacks work?

Provide a publicly accessible HTTPS callback URL. GoEnhance posts processing, success, and failed changes using the job-detail response shape. Non-200 callbacks are retried up to three times with a three-second timeout per attempt.

Is this an official Alibaba API?

No. Qwen is associated with Alibaba, while this endpoint is independently provided by GoEnhance. It does not imply Alibaba partnership or endorsement. For an Alibaba-operated service, consult Alibaba Cloud documentation.

Start Building With Qwen-Image 3.0