TL;DR
Qwen Image 3.0 hợp nhất tạo ảnh từ văn bản và chỉnh sửa có hướng dẫn tham chiếu dưới hai biến thể Standard (qwen-image-3.0) và Pro (qwen-image-3.0-pro). Bắt đầu với một prompt văn bản, chọn kích thước đầu ra, gửi yêu cầu tạo ảnh và lưu kết quả ngay. Với chỉnh sửa, đính kèm từ một đến ba ảnh tham chiếu cùng hướng dẫn bảo lưu rõ ràng. Trên CometAPI, hãy xác minh route thực tế và schema yêu cầu tương thích trước khi triển khai các lệnh mẫu.
Key Takeaways
- Qwen Image 3.0 API hỗ trợ tạo ảnh từ văn bản và chỉnh sửa có hướng dẫn tham chiếu qua các biến thể Standard (qwen-image-3.0) và Pro (qwen-image-3.0-pro); định dạng đầu ra gốc là PNG.
- Truy cập Qwen Image 3.0 API có sẵn qua CometAPI. Nhà phát triển có thể lấy API key, xác minh endpoint được hỗ trợ và tích hợp tạo ảnh vào ứng dụng của mình。
- Giá Qwen Image 3.0 API bắt đầu từ $0.024/yêu cầu trên CometAPI, so với mức của Alibaba Cloud Singapore bắt đầu từ $0.030 cho mỗi ảnh đầu ra Standard và $0.040 cho mỗi ảnh đầu ra Pro 1K.
- Chỉnh sửa ảnh Qwen Image 3.0 hỗ trợ tối đa ba ảnh tham chiếu qua API gốc của Alibaba Cloud, trong khi tạo ảnh hỗ trợ từ một đến sáu ảnh đầu ra mỗi yêu cầu.
- Tích hợp Qwen Image 3.0 API yêu cầu nhà phát triển xác minh các tham số theo nhà cung cấp, xác thực, đơn vị tính phí và URL ảnh tạm thời trước khi triển khai quy trình sản xuất.
What Is the Qwen Image 3.0 API?
Qwen Image 3.0 API biến hướng dẫn văn bản thành hình ảnh và có thể biến đổi ảnh chụp hoặc tài sản thiết kế được cung cấp. Các tình huống hỗ trợ gồm poster đa ngôn ngữ, ảnh thương mại điện tử, mockup chiến dịch, thay nền và chỉnh sửa ảnh ghép.
Qwen Image 3.0 Standard (qwen-image-3.0) là nền tảng tập trung chi phí cho tạo ảnh từ văn bản và chỉnh sửa có hướng dẫn tham chiếu. Ưu tiên cho các quy trình khối lượng lớn như biến thể nền cho thương mại điện tử, bản nháp hình ảnh mạng xã hội và khám phá ý tưởng chiến dịch. Ví dụ, dùng Standard để tạo vài phương án nền cho sản phẩm, sau đó xem xét độ trung thực sản phẩm và chọn phiên bản đáng để tinh chỉnh.
Qwen Image 3.0 Pro (qwen-image-3.0-pro) hỗ trợ tạo và chỉnh sửa có hướng dẫn tham chiếu, với tầng đầu ra gốc 2K có giá cao hơn. Đánh giá cho các sản phẩm đòi hỏi chất lượng như ảnh hero chiến dịch, bố cục sản phẩm chi tiết và poster quảng bá. Ví dụ, thử nghiệm concept đã rút gọn bằng Pro khi chi tiết tinh vi hoặc bố cục quan trọng, và so sánh kết quả chấp nhận được với Standard trước khi chi thêm ngân sách.
Cách lựa chọn: Bắt đầu với Standard cho bản nháp và biến thể nhạy cảm chi phí. Thử Pro trên cùng đề bài cho tài sản cuối đòi hỏi cao; chọn khi cải thiện đo được xứng đáng với chi phí bổ sung. Cả hai danh mục đều không thay thế cho việc kiểm thử theo ứng dụng về typography, độ trung thực sản phẩm, số lượng đối tượng hay độ chính xác bố cục.
| Specification | Qwen Image 3.0 | Qwen Image 3.0 Pro |
|---|---|---|
| Model ID | qwen-image-3.0 | qwen-image-3.0-pro |
| Generation / editing | Cả hai | Cả hai |
| Reference images for editing | 1–3 | 1–3 |
| Generated images per request | 1–6 | 1–6 |
| Output format | PNG | PNG |
| Output pixel area | 512²–2048² | 512²–2048² |
| Recommended prompt length | 4,500 tokens | 4,500 tokens |
| Primary selection rationale | Hiệu suất chi phí | Đánh giá đầu ra cao cấp |
What Parameters Does Qwen Image 3.0 API Support?
Dùng các tham số này với giao diện tương thích OpenAI gốc của Alibaba Cloud. Chỉ thêm tùy chọn theo nhà cung cấp vào yêu cầu CometAPI khi route đã chọn có tài liệu.
Áp dụng cho cả hai biến thể: qwen-image-3.0 (Standard) và qwen-image-3.0-pro (Pro) hỗ trợ cùng các tham số dưới đây trên giao diện tương thích OpenAI gốc của Alibaba Cloud. Chọn biến thể bằng trường model; các điều khiển tạo và chỉnh sửa được chia sẻ. Điều này không ngụ ý chất lượng đầu ra hay giá giống hệt nhau, cũng không đảm bảo mọi route của CometAPI đều lộ tất cả tham số gốc.
| Parameter | Type / example | Purpose |
|---|---|---|
| model | qwen-image-3.0 | Chọn Standard hoặc Pro |
| prompt | string | Hướng dẫn và nội dung |
| image | URL / base64 string or array | 1–3 tham chiếu cho chỉnh sửa; bỏ qua khi tạo mới |
| size | 1024x1024 | Kích thước đầu ra; auto khi được hỗ trợ |
| n | integer 1–6 | Số ảnh đầu ra mỗi lần gọi |
| negative_prompt | string | Mô tả những gì cần tránh |
| prompt_extend | boolean | Bật viết lại prompt |
| prompt_extend_mode | direct / agent | Chế độ agent chỉ áp dụng cho T2I |
| enable_thinking | boolean | Điều khiển suy luận, phụ thuộc thiết lập tăng cường |
| watermark | boolean | Hình mờ tùy chọn |
| seed | integer | Hỗ trợ tái lập |
Với yêu cầu gốc, tỷ lệ khung hình đầu ra phải nằm giữa 1:8 và 8:1. Ảnh tham chiếu tối đa 10 MB, mỗi cạnh từ 1 đến 8.000 pixel và tỷ lệ cạnh dài nhất/cạnh ngắn nhất không vượt quá 10:1. Dùng data URI cho đầu vào Base64. Thinking yêu cầu prompt_extend=true; tăng cường agent chỉ hỗ trợ text-to-image.
Một yêu cầu ảnh tương thích đặt các trường tạo ảnh ở cấp cao nhất của JSON và định dạng kích thước như 1024x1024. DashScope gốc dùng input/parameters lồng nhau và thường ghi kích thước là 1024*1024. Sao chép yêu cầu giữa các endpoint này mà không chuyển đổi có thể thất bại.
How Do You Call Qwen Image 3.0 API with CometAPI?
Hướng dẫn này giả định Python 3, terminal tương thích Bash, tài khoản CometAPI có quyền truy cập model và số dư đủ. Yêu cầu đầu tiên chỉ dùng các trường model và prompt như trong ví dụ nhà cung cấp. Tài liệu được kiểm tra vào ngày 16 tháng 10, 2026; các ví dụ này chưa được chạy trên tài khoản trả phí.
Create credentials
Tạo API key phía máy chủ trong bảng điều khiển CometAPI của bạn. Không bao giờ nhúng nó vào client web hay di động.
export COMETAPI_KEY="your_api_key"python -m pip install requests
Submit a minimal generation request
Nhà phát triển có thể truy cập Qwen Image 3.0 API trên CometAPI bằng route tạo ảnh đã được ghi tài liệu. Bắt đầu với yêu cầu tối thiểu dưới đây trước khi thêm các tham số tùy chọn.
curl --fail-with-body https://api.cometapi.com/v1/images/generations \ -H "Authorization: Bearer $COMETAPI_KEY" \ -H "Content-Type: application/json" \ -d '{"model":"qwen-image-3.0","prompt":"Premium skincare bottle on a stone pedestal, gentle studio lighting"}'
Save every returned image
Lưu script sau với tên generate.py và chạy python generate.py. Script gửi yêu cầu, xử lý kết quả ảnh dạng URL hoặc Base64, và ghi từng ảnh cục bộ. Nếu phản hồi chứa thông tin tác vụ thay vì mảng data, script sẽ dừng thay vì đoán endpoint polling; dùng hợp đồng bất đồng bộ theo tài khoản để lấy kết quả hoàn tất.
import base64import osfrom pathlib import Pathimport requestsresponse = requests.post( "https://api.cometapi.com/v1/images/generations", headers={"Authorization": f"Bearer {os.environ['COMETAPI_KEY']}"}, json={"model": "qwen-image-3.0", "prompt": "A sunny bookstore cafe, editorial photograph"}, timeout=(15, 600),)response.raise_for_status()result = response.json()images = result.get("data")if not isinstance(images, list) or not images: raise RuntimeError(f"No synchronous images; inspect task/error fields: {list(result)}")for index, item in enumerate(images, 1): if item.get("url"): download = requests.get(item["url"], timeout=(15, 120)) download.raise_for_status() content = download.content elif item.get("b64_json"): content = base64.b64decode(item["b64_json"], validate=True) else: raise RuntimeError(f"Image {index} has no URL or Base64 payload") path = Path(f"qwen_image_{index}.png") path.write_bytes(content) print(f"Saved {path}")
Chạy thành công sẽ tạo các tệp ảnh cục bộ. Mở chúng để xác nhận có thể đọc được và khớp cảnh đã yêu cầu. Lưu ID yêu cầu và các trường usage trong nhật ký máy chủ nhưng không ghi log thông tin xác thực.
How Do You Generate Multiple Images with Qwen Image 3.0?
Trên giao diện gốc của Alibaba Cloud, đặt n từ hai đến sáu cho các biến thể sáng tạo. Với CometAPI, chỉ bật n sau khi xác nhận hỗ trợ trên route đã chọn. Xác thực từng tài sản trả về riêng biệt; tăng n không đảm bảo mọi kết quả đều vượt qua kiểm duyệt hạ lưu.
Bạn có thể tạo tối đa 6 ảnh trong một yêu cầu với Qwen Image 3.0 bằng cách đặt tham số n. Hoạt động với cả qwen-image-3.0 và qwen-image-3.0-pro, cho tạo ảnh từ văn bản và chỉnh sửa ảnh. Mặc định là một ảnh.
Có hai cách chính: dùng giao diện đồ họa nếu nền tảng của bạn có tùy chọn này, hoặc gọi API trực tiếp.
Generate multiple images using the API
- Mở tài liệu API.
- Lấy API key từ bảng điều khiển QwenCloud/ CometAPI.
- Chọn
qwen-image-3.0hoặcqwen-image-3.0-pro. - Đặt
nthành số ảnh bạn muốn, từ1đến6. - Gửi prompt của bạn và lưu các ảnh trả về.
Ví dụ, đặt "n": 4 để yêu cầu bốn biến thể của cùng một prompt.
Python example
Dưới đây là ví dụ sẵn sàng điều chỉnh bằng API tương thích OpenAI.
from openai import OpenAIimport requestsclient = OpenAI( api_key="YOUR_QWEN_API_KEY", base_url="https://maas.qwencloudapi.com/compatible-mode/v1")
result = client.images.generate( model="qwen-image-3.0-pro",
prompt=( "A cozy Japanese cafe on a rainy evening, " "warm glowing lights, cinematic photography, " "rich details, realistic reflections" ),
n=4,
size="1024x1024")# Save each generated image
for i, item in enumerate(result.data, start=1): response = requests.get(item.url) response.raise_for_status() with open(f"qwen_image_{i}.png", "wb")
as f:
f.write(response.content)print("Finished generating images!")
Cài đặt các gói cần thiết trước:
pip install openai requests
API trả về một URL ảnh cho mỗi kết quả. URL ảnh được tạo là tạm thời, vì vậy hãy tải xuống ảnh ngay.
Important settings
| Parameter | What it does |
|---|---|
| n=4 | Tạo bốn ảnh đầu ra |
| model="qwen-image-3.0-pro" | Chọn model Pro |
| size="1024x1024" | Yêu cầu ảnh vuông |
| seed=12345 | Giúp kết quả dễ tái lập hơn |
| negative_prompt | Loại trừ các yếu tố hình ảnh không mong muốn |
Số lượng ảnh tối đa là sáu mỗi yêu cầu. Lưu ý rằng yêu cầu nhiều ảnh hơn sẽ tăng chi phí tạo.
Một khác biệt quan trọng: n=4 yêu cầu bốn biến thể của một prompt. Nếu bạn muốn bốn prompt khác nhau, hãy tạo các yêu cầu riêng hoặc tự động lặp qua danh sách prompt của bạn.
How Do You Edit Images with Qwen Image 3.0?
Một lần chỉnh sửa kết hợp từ một đến ba ảnh tham chiếu với hướng dẫn. Hãy giải thích cả biến đổi mong muốn và những gì không được thay đổi—ví dụ nhãn sản phẩm, màu sắc, góc máy hoặc hình học bao bì.
Ví dụ tiếp theo dùng thông tin xác thực Alibaba Cloud và trường hình ảnh JSON cho chỉnh sửa. Tạo khóa Model Studio theo vùng, lấy workspace ID của bạn và cấu hình endpoint tương ứng. Không thay thế CometAPI key vào yêu cầu này.
export DASHSCOPE_API_KEY="your_model_studio_key"export ALIBABA_WORKSPACE_ID="your_workspace_id"export ALIBABA_IMAGE_ENDPOINT="https://${ALIBABA_WORKSPACE_ID}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1/images/generations"
Ảnh tham chiếu dưới đây lấy trực tiếp từ ví dụ API chính thức. Đây là ảnh đầu vào, không phải ảnh được tạo từ bài viết này.
import os, requests
endpoint = os.environ["ALIBABA_IMAGE_ENDPOINT"]
# documented regional .../images/generations endpoint
payload = {
"model": "qwen-image-3.0",
"prompt": "Change the outfit to a charcoal business suit in a cafe. Preserve the face and hairstyle.",
"image": ["https://alidocs.oss-cn-zhangjiakou.aliyuncs.com/res/yBRq1ZPYEaXdyOdv/img/33a80a19-7ac7-4c64-b0fa-7d685b7046a0.png"],
"size": "1024x1024",
"n": 1}
r = requests.post(endpoint, headers={
"Authorization": f"Bearer {os.environ['DASHSCOPE_API_KEY']}"}, json=payload, timeout=(15, 600))
r.raise_for_status()
print(r.json())
Endpoint tương thích gốc dùng JSON trên /images/generations, không dùng multipart upload trên /images/edits. Không hỗ trợ mask hoặc streaming. Đọc mảng data được trả về và lưu từng URL bằng vòng lặp tải xuống giống như ở trên.
Với hai ảnh tham chiếu, hãy đưa hai URL vào mảng image và chỉ định vai trò của chúng trong prompt (ví dụ: sản phẩm từ ảnh một, bối cảnh phòng từ ảnh hai). Dòng Qwen Image 3.0 chấp nhận không quá ba ảnh tham chiếu; dùng model khác hoặc quy trình tiền xử lý cho tập nguồn lớn hơn.
How Much Does Qwen Image 3.0 API Cost?
Giá Qwen Image 3.0 API thay đổi theo biến thể model, độ phân giải đầu ra và nhà cung cấp. Bảng dưới đây bổ sung so sánh của Alibaba Cloud Singapore với mức giá CometAPI trong bảng giá đính kèm của người đánh giá. Tệp đính kèm liệt kê giá đầu ra tính bằng USD mỗi ảnh và mức giảm 20% cho cả bốn tổ hợp model/độ phân giải. Các mức này chưa được tái xác thực độc lập so với hóa đơn tài khoản trực tiếp; hãy xác nhận bảng giá áp dụng trước khi dùng sản xuất.
| Pricing item | Alibaba Cloud Standard | Alibaba Cloud Pro | CometAPI |
|---|---|---|---|
| Input reference image | $0.003/image | $0.003/image | $0.0024/image for Standard and Pro |
| Successful 1K output | $0.030/image | $0.040/image | Standard: $0.0240/image; Pro: $0.0320/image |
| Successful 2K output | $0.030/image | $0.075/image | Standard: $0.0240/image; Pro: $0.0600/image |
| 100 successful 1K outputs | $3.00 | $4.00 | Standard: $2.40; Pro: $3.20 for 100 output images* |
| 1,000 successful 2K outputs | $30.00 | $75.00 | Standard: $24.00; Pro: $60.00 for 1,000 output images* |
| Billing unit | Input/output image | Input/output image | Per billable input reference image and successful output image, according to the supplied pricing table |
| CometAPI output-price discount | 20% at 1K and 2K | 20% at 1K and 2K | Input and output rates are 80% of the corresponding official image prices in the supplied table |
*Các ví dụ về sản lượng ở trên chỉ tính ảnh đầu ra: 100 ảnh Standard 1K có giá $2.40 và 100 ảnh Pro 1K có giá $3.20; 1.000 ảnh Standard 2K có giá $24.00 và 1.000 ảnh Pro 2K có giá $60.00. Với chỉnh sửa, cộng thêm $0.0024 cho mỗi ảnh tham chiếu đầu vào được tính phí. Quy định về job thất bại, thuế và điều chỉnh theo tài khoản không được bao gồm.
Dựa trên mức giá ảnh đầu vào và đầu ra được cung cấp, ước tính chi phí ảnh cho bất kỳ nhà cung cấp nào như sau:
Tổng chi phí = (số ảnh tham chiếu tính phí × giá ảnh đầu vào) + (số đầu ra thành công × giá ảnh đầu ra).
Với một job tính phí cho hai ảnh tham chiếu đầu vào và ba ảnh đầu ra Standard 1K thành công, phí ảnh của Alibaba Cloud là (2 × $0.0030) + (3 × $0.0300) = $0.0960. Phí ảnh tương ứng trên CometAPI là (2 × $0.0024) + (3 × $0.0240) = $0.0768, dựa trên các mức cung cấp.
CometAPI tính $0.0024 mỗi ảnh tham chiếu đầu vào cho cả hai biến thể. Giá đầu ra là $0.0240 mỗi ảnh Standard ở 1K hoặc 2K, $0.0320 mỗi ảnh Pro ở 1K và $0.0600 mỗi ảnh Pro ở 2K. Bảng cung cấp liệt kê mỗi mức đầu vào và đầu ra thấp hơn 20% so với mức chính thức tương ứng. Với cùng số lượng ảnh tính phí, các khoản phí ảnh này do đó thấp hơn 20%; phí bổ sung hoặc điều khoản tài khoản có thể thay đổi hóa đơn cuối cùng.
Đối với ngân sách sản xuất, hãy xác minh biến thể đã chọn, độ phân giải ảnh, phí ảnh tham chiếu, số lượng đầu ra mỗi yêu cầu và các chiết khấu áp dụng cho tài khoản trước khi ước tính tổng chi phí sử dụng.
How Do You Handle Qwen Image 3.0 API Errors?
| Symptom | Likely cause | Action |
|---|---|---|
| 401/403 | Key không hợp lệ hoặc sai khu vực | Kiểm tra thông tin xác thực, quyền và vị trí triển khai |
| 400 invalid image | Sai số lượng/loại ảnh tham chiếu | Dùng 1–3 ảnh, URL/base64 hợp lệ, định dạng hỗ trợ |
| 400 invalid size | Diện tích/tỷ lệ khung hình hoặc dấu tách không hỗ trợ | Chuẩn hóa kích thước cho endpoint |
| Unexpected JSON | Sai endpoint hoặc hợp đồng phản hồi | Ghi log các trường phản hồi và điều chỉnh bộ phân tích |
| Expired image URL | Ảnh không được lưu trước khi hết hạn | Tải xuống và lưu ngay khi tạo |
| Unexpected bill | Ảnh tham chiếu hoặc tầng đầu ra chưa được tính | Dùng các trường usage ảnh và bảng giá hiện hành |
| Inconsistent brand text | Hạn chế của mô hình sinh | Dùng cổng duyệt hoặc chèn chữ hậu kỳ |
FAQ
Tôi có nên thử lại yêu cầu Qwen Image 3.0 sau khi timeout?
Timeout phía client không chứng minh rằng quá trình tạo đã dừng. Lưu bất kỳ ID yêu cầu hoặc tác vụ nào, kiểm tra lịch sử job của nhà cung cấp hoặc API trạng thái được ghi tài liệu, và xác định xem đầu ra đã tồn tại chưa trước khi gửi lại. Retry mù có thể tạo job trùng và phát sinh chi phí. Dùng retry có giới hạn cho lỗi thoáng qua và tuân thủ hướng dẫn idempotency của nhà cung cấp khi có.
Tôi có thể dùng ảnh tham chiếu cục bộ với Qwen Image 3.0 như thế nào?
Với giao diện tương thích gốc, đọc tệp dưới dạng byte, mã hóa Base64 và thêm tiền tố data URI như data:image/png;base64,. Đặt chuỗi đầy đủ đó vào trường image. Đầu vào Base64 vẫn phải đáp ứng giới hạn kích thước và kích thước ảnh; đường dẫn hệ thống tệp cục bộ không phải là URL dịch vụ có thể tải.
Tôi truyền các tùy chọn riêng của Qwen qua một OpenAI SDK như thế nào?
Giữ các trường ảnh chuẩn trong các tham số SDK thông thường và đặt các trường mở rộng Model Studio, như image và prompt_extend, vào extra_body. Yêu cầu HTTP thuần đặt các trường này trực tiếp ở cấp cao nhất JSON. Hướng dẫn này áp dụng cho giao diện tương thích gốc; hãy kiểm tra route CometAPI đã chọn trước khi chuyển tiếp các tùy chọn theo nhà cung cấp.
Tôi nên làm gì khi Qwen Image 3.0 trả về ít ảnh hơn yêu cầu?
Trước hết lưu các đầu ra thành công và ghi nhận số lượng thực tế. Với tính phí gốc của Alibaba Cloud, phí đầu ra dựa trên các ảnh tạo thành công. Nếu cần thêm tài sản, chỉ yêu cầu số lượng thiếu sau khi kiểm tra phản hồi và bản ghi usage; việc tính phí trên CometAPI cần đối chiếu theo điều khoản tài khoản riêng.
Conclusion
Qwen Image 3.0 là lựa chọn thực tế cho các đội cần tạo ảnh và chỉnh sửa theo tham chiếu trong cùng một họ model. Dùng Standard làm nền tảng tiết kiệm chi phí, thử Pro cho các tác vụ 2K hoặc sáng tạo đòi hỏi cao, và đo chi phí đầu ra được chấp nhận thay vì đánh giá theo giá mỗi yêu cầu. Bắt đầu với lệnh tạo tối thiểu, lưu trữ đầu ra, sau đó thêm chỉnh sửa hoặc nhiều đầu ra qua hợp đồng nhà cung cấp thích hợp. Giữ riêng thông tin xác thực và schema yêu cầu, xử lý lỗi rõ ràng, và đối soát usage ảnh với bảng giá đã chọn.