Qwen: Qwen Image 3
Qwen-Image-3.0 kết hợp tạo và chỉnh sửa hình ảnh cho bố cục giàu thông tin, cảnh nhiều chi tiết và chữ đa ngôn ngữ. Phiên bản tiêu chuẩn cân bằng chất lượng với tốc độ, nhận mô tả bằng văn bản hoặc tối đa ba hình ảnh kèm chỉ dẫn chỉnh sửa.
Về mô hình
Mô tả này trình bày khả năng của mô hình. Đầu vào, đầu ra và tùy chọn có trên Ailoot được liệt kê bên dưới cho phương thức đã chọn.
Qwen-Image-3.0 là mô hình hình ảnh thế hệ thứ ba của Qwen, kết hợp tạo ảnh từ văn bản và chỉnh sửa dựa trên ảnh tham chiếu trong cùng một mô hình. Phiên bản tiêu chuẩn cân bằng chất lượng hình ảnh với tốc độ phản hồi, còn Qwen-Image-3.0 Pro là phiên bản cao cấp cùng dòng, ưu tiên chất lượng. Một yêu cầu tạo ra hình ảnh: áp phích, hình giải thích có minh họa, cảnh sản phẩm, bảng phân cảnh hoặc ảnh đã chỉnh sửa, thay vì tài liệu có thể biên tập hay giao diện đang hoạt động.
Khả năng xử lý nội dung phong phú phù hợp với một khung hình có nhiều phần liên quan hoặc bố cục thị giác lồng nhau. Chuẩn bị tiêu đề, câu chữ chính xác, thứ bậc thông tin và mối quan hệ giữa các ô trước khi bổ sung chi tiết phong cách. Với hình so sánh sản phẩm, một mô tả hữu ích cần nêu góc nhìn chính của sản phẩm, thuộc tính cần gắn nhãn và thứ tự đọc các ô thông tin bổ trợ. Với bảng phân cảnh, hãy mô tả riêng chủ thể, hành động và chú thích của từng ô. Độ dài prompt tối đa được khuyến nghị là 4.500 token; dành phần đó cho nội dung và bố cục mà hình ảnh thực sự cần.
Mô hình hỗ trợ kết cấu chi tiết, chữ nhỏ được trình diễn ở kích thước 10 pixel và khả năng kết xuất trực tiếp bằng 12 ngôn ngữ với nhiều phông chữ, phong cách nghệ thuật. Những khả năng này có thể kết hợp vật thể chân thực với đồ họa giàu thông tin thay vì buộc phải chọn giữa ảnh chụp và bố cục có nhiều chữ. Cung cấp chính xác từ ngữ, chữ số cần thể hiện, ngôn ngữ dự kiến và vị trí của chúng. Xem giao diện được tạo như một bản mô phỏng trực quan: nút, biểu đồ và nhãn trong ảnh không thực hiện chức năng của ứng dụng.
Chỉnh sửa có thể thay đổi chữ, thêm hoặc xóa vật thể, di chuyển thành phần, điều chỉnh hành động của chủ thể, chuyển phong cách hoặc làm rõ chi tiết của ảnh bị hỏng. Cung cấp từ một đến ba ảnh và một chỉ dẫn chỉnh sửa rõ ràng. Số thứ tự ảnh theo đúng thứ tự được cung cấp, vì vậy hãy chỉ rõ ảnh nào cung cấp chủ thể, ảnh nào cung cấp trang phục hoặc vật thể và ảnh nào cung cấp bối cảnh. Với cảnh sản phẩm, yêu cầu đặt vật thể từ ảnh 1 vào môi trường của ảnh 2, đồng thời giữ những đặc điểm nhận diện sản phẩm. Nêu rõ cả thay đổi lẫn yêu cầu giữ nguyên.
Quy trình đầu vào hình ảnh này chấp nhận JPG, JPEG, PNG, BMP, TIFF, WebP và GIF; với GIF động, chỉ khung hình đầu tiên được xử lý. Mỗi ảnh có thể có dung lượng tối đa 10 MB. API hiện tại chấp nhận kích thước từ 1 đến 8.000 pixel, với tỷ lệ cạnh dài trên cạnh ngắn không quá 10:1, và khuyến nghị 384–2.048 pixel để có kết quả tốt. Chọn ảnh đầu vào thể hiện rõ các chi tiết cần chuyển hoặc chỉnh sửa. Ảnh tham chiếu bị cắt quá sát có thể che mất cấu trúc xung quanh cần thiết để đặt vật thể một cách tự nhiên.
Đầu ra là PNG, từ một đến sáu ảnh cho mỗi yêu cầu và mặc định là một ảnh. Diện tích đầu ra tính theo pixel nằm trong khoảng 512 × 512 đến 2.048 × 2.048, với tỷ lệ khung hình từ 1:8 đến 8:1; đây là giới hạn diện tích, không phải quy tắc rằng mọi cạnh đều phải dài tối đa 2.048 pixel. Nếu không cung cấp kích thước, mô hình đề xuất độ phân giải dựa trên prompt. Chọn bố cục ngang, vuông hoặc dọc theo mục đích sử dụng, rồi kiểm tra ảnh trả về ở kích thước thực tế đó để đánh giá nhãn nhỏ và chi tiết tinh tại nơi chúng sẽ xuất hiện.
Viết lại prompt được bật mặc định trong quy trình của nhà sản xuất. Chế độ cải thiện trực tiếp dùng được cho cả tạo và chỉnh sửa ảnh; cải thiện bằng tác tử là chế độ viết lại phức tạp hơn, chỉ dành cho tạo ảnh từ văn bản và bị từ chối khi chỉnh sửa ảnh từ ảnh. Chế độ suy nghĩ được bật mặc định, yêu cầu bật viết lại prompt và làm tăng thời gian tạo ảnh. Prompt phủ định có thể mô tả thành phần không mong muốn, còn giá trị seed cố định giúp so sánh các biến thể. Nêu rõ những yếu tố cần loại trừ và yêu cầu giữ nguyên chính xác thay vì mong đợi seed khiến các mô tả thay đổi vẫn trả về ảnh giống hệt nhau.
Để có sản phẩm cuối hữu ích, hãy kiểm tra chữ được kết xuất, đơn vị, thứ tự các ô và chi tiết nhận diện chủ thể, rồi sửa đúng phần chưa đạt mô tả. Phản hồi có nhiều ảnh cung cấp các phương án để so sánh; giữ từng ảnh trả về gắn với prompt và ảnh tham chiếu đã tạo ra nó. Địa chỉ ảnh của nhà sản xuất hết hạn sau 24 giờ, vì vậy hãy lưu tệp ảnh thực tế khi kết quả trở thành một phần của dự án. Phiên bản tiêu chuẩn 3.0 vẫn khác Pro và các mô hình Qwen 2.1 vốn có số lượng ảnh tham chiếu và tính năng trong suốt riêng.
Ailoot Ultra · Ảnh POST /v1/images/generations qwen/qwen-image-3
qwen/qwen-image-3Bắt đầu
Qwen-Image-3.0 kết hợp tạo và chỉnh sửa hình ảnh cho bố cục giàu thông tin, cảnh nhiều chi tiết và chữ đa ngôn ngữ. Phiên bản tiêu chuẩn cân bằng chất lượng với tốc độ, nhận mô tả bằng văn bản hoặc tối đa ba hình ảnh kèm chỉ dẫn chỉnh sửa.
- Đầu vào được chấp nhận
- Văn bản · Ảnh
- Kết quả
- Ảnh
Có trên Ailoot · đầu vào & phương thức
Ailoot Ultra · Ảnh POST /v1/images/generations
- Đầu vào
text,image- Đầu ra
image
| Trường | Loại | Yêu cầu | Giá trị & giới hạn | Mặc định |
|---|---|---|---|---|
Trườngmodel | Loạistring | Yêu cầuBắt buộc | Giá trị & giới hạn qwen/qwen-image-3 | Mặc định— |
Trườngprompt | Loạistring | Yêu cầuBắt buộc | Giá trị & giới hạn Độ dài tối thiểu: 1 | Mặc định— |
Trườngresolution | Loạistring | Yêu cầuKhông bắt buộc | Giá trị & giới hạn 1K, 2K | Mặc định— |
Trườngaspect_ratio | Loạistring | Yêu cầuKhông bắt buộc | Giá trị & giới hạn 1:1, 1:2, 1:4, 2:1, 2:3, 3:2, 3:4, 4:1, 4:3, 4:5, 5:4, 9:16, 16:9 | Mặc định— |
Trườngn | Loạiinteger | Yêu cầuKhông bắt buộc | Giá trị & giới hạn Tối thiểu: 1 Tối đa: 6 | Mặc định— |
Trườnginput_references | Loạiarray | Yêu cầuKhông bắt buộc | Giá trị & giới hạn Số mục tối thiểu: 0 Số mục tối đa: 4 | Mặc định— |
Trườngprovider | Loạiobject | Yêu cầuKhông bắt buộc | Giá trị & giới hạn | Mặc định— |
Tham số phương thức và vòng đời
| Tham số | Hợp đồng |
|---|---|
Tham sốcontent_type | Hợp đồngapplication/json |
Tham sốrequired | Hợp đồngmodel, prompt |
Tham sốmaterial_types | Hợp đồngtext, image |
Vòng đời: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · Giá trị task_id thực tế đã trả về hoặc bản ghi trong thư viện nội dung đa phương tiện
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Bảng giá
Cách tính phí cuối cùng
Các đơn giá hiển thị dùng để ước tính chi phí trước khi tạo. Khoản phí cuối cùng được tính dựa trên chi phí ghi nhận cho lượt tạo gốc. Thời lượng đầu ra đo được và số lượng dự kiến không phải là số lượng cuối cùng dùng để tính phí.
Thông tin biểu giá không bổ sung tùy chọn yêu cầu. Các tham số được hỗ trợ nằm trong phương thức đã chọn.
- Chế độ nhanh
- Chưa chỉ định Khi chọn chế độ nhanh
- Chế độ Flex
- Chưa chỉ định Khi chọn chế độ flex
- Mức độ suy luận tối đa
- Chưa chỉ định Khi áp dụng mức điều chỉnh mặc định (default) cho mức độ suy luận tối đa
Mức phí ước tính để so sánh
Giá theo cấu hình
Đối chiếu từng khoản phí với điều kiện hiển thị. Dùng một mức phí cho mỗi nhóm cấu hình thay thế.
| Cấu hình | Biểu mức phí | Số lượng dự báo | Đơn vị tính phí | Phí |
|---|---|---|---|---|
| Cấu hìnhGiá cơ sở cho token | Biểu mức phíMức phí cơ bản | Số lượng dự báo— | Đơn vị tính phí— | Phí Đầu vào · Token đầu vào · Ước tính chỉ để so sánh — / 1K token Đầu ra · Token đầu ra · Ước tính chỉ để so sánh — / 1K token Đầu vào · Đọc bộ nhớ đệm · Ước tính chỉ để so sánh — / 1K token Đầu vào · Ghi bộ nhớ đệm · Ước tính chỉ để so sánh — / 1K token Đầu vào · Ghi bộ nhớ đệm, 1 giờ · Ước tính chỉ để so sánh — / 1K token |
| Cấu hìnhảnh đầu vào | Biểu mức phí— | Số lượng dự báo— | Đơn vị tính phímỗi ảnh đầu vào | Phí Đầu vào · ảnh đầu vào · Ước tính chỉ để so sánh $0.006 mỗi ảnh đầu vào |
| Cấu hìnhChi phí tạo ước tính | Biểu mức phí— | Số lượng dự báoước tính cho một lần tạo | Đơn vị tính phí— | Phí Đầu ra · Chi phí tạo ước tính · Ước tính chỉ để so sánh $0.06 ước tính trước khi tạo Ước tính này không phải là khoản phí bổ sung hay mức giá cố định cho lượt tạo đã hoàn tất. |
Ailoot tạm giữ một khoản ước tính trước yêu cầu. Sau khi có kết quả, phí cuối cùng được quyết toán theo mức sử dụng đo được. Việc quyết toán khi truyền luồng dùng bản ghi mức sử dụng cuối cùng. Cách hoạt động của cơ chế tạm giữ và quyết toán →
Ví dụ yêu cầu
Ailoot Ultra · Ảnh
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p={'model': 'qwen/qwen-image-3', 'prompt': 'a red panda astronaut floating in space, studio lighting'}
Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import base64, json, os, subprocess
from pathlib import Path
from urllib.parse import urlsplit, urljoin
def save_images(items):
if not items: raise SystemExit("No completed images; retain the full response")
for index, item in enumerate(items):
encoded=item.get("b64_json")
uri=item.get("url", "")
if not encoded and uri.startswith("data:image/"):
header, separator, encoded=uri.partition(",")
if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")
if encoded:
raw=base64.b64decode(encoded,validate=True)
elif uri:
uri=urljoin("https://api.ailoot.ai",uri)
parsed=urlsplit(uri)
if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:
raise SystemExit("Invalid returned image URL")
owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")
args=["curl","--fail-with-body","--silent","--show-error",uri]
if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]
temporary=Path(f"image-{index}.bin")
subprocess.run(args+["-o",str(temporary)],check=True)
raw=temporary.read_bytes()
temporary.unlink()
else: raise SystemExit("Image has neither bytes nor URL")
if not raw: raise SystemExit("Empty image result")
ext="png" if raw.startswith(b"\x89PNG") else "jpg" if raw.startswith(b"\xff\xd8") else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "svg" if raw.lstrip().startswith((b"<svg",b"<?xml")) else "bin"
Path(f"image-{index}.{ext}").write_bytes(raw)
print("Every returned image saved; complete response metadata retained")
save_images(json.loads(Path("result.json").read_text())["data"])
PY_RESULT
Nhận và lưu kết quả
Ailoot Ultra · Ảnh
Tải xuống từng ảnh trả về hoặc lưu nội dung Base64 của ảnh
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
Lượt đọc nội dung khác
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/media/assets \
-H "Authorization: Bearer $AILOOT_API_KEY" -o owned-assets.json
# Preserve every returned asset and follow its exact signed content URL. Do not construct a signed token.
Lưu tất cả kết quả đã hoàn tất
Lưu mọi ảnh đã hoàn tất; truy xuất từng URL trả về hoặc giải mã nội dung Base64 của ảnh.
Giữ lại toàn bộ phản hồi và các header, mọi đầu ra thực tế, các định danh gốc đã trả về và mọi trường usage. Khôi phục thao tác gốc mà không gửi lại yêu cầu tạo.
Nếu cần kiểm tra phản hồi gốc
Giữ lại X-Client-Request-ID đã trả về để đối soát. Chỉ truy xuất theo các giá trị task_id/asset_id thực tế đã trả về hoặc từ thư viện nội dung đa phương tiện thuộc quyền sở hữu của bạn; tuyệt đối không tạo URL tác vụ từ ID thao tác và không gửi lại yêu cầu tạo.
Trường phản hồi
| Trường | Loại |
|---|---|
Trườngcreated | Loại |
Trườngdata[].url | Loại |
Trườngdata[].b64_json | Loại |
Trườngusage | Loại |
Bí danh
Bí danh mô hình
Ailoot Ultra qwen/qwen-image-3
Bí danh đường dẫn phương thức
/v1/images
ID gọi liên quan
FAQ · Qwen: Qwen Image 3
- Có những đầu vào và kết quả nào?
POST /v1/images/generations·qwen/qwen-image-3:text,image→image- Yêu cầu sử dụng những trường nào?
POST /v1/images/generations·qwen/qwen-image-3:model,prompt,resolution,aspect_ratio,n,input_references,provider- Áp dụng những giới hạn nào?
POST /v1/images/generations·qwen/qwen-image-3:n.minimum:1;n.maximum:6