Qwen: Qwen Image 3 Pro

Qwen-Image-3.0 Pro là mô hình tạo và chỉnh sửa ảnh hàng đầu của Qwen, dành cho bố cục phức tạp, chi tiết chân thực và văn bản đa ngôn ngữ. Dùng yêu cầu chính xác hoặc một đến ba ảnh tham chiếu để tạo đồ họa, cảnh sản phẩm hoặc bản chỉnh sửa thị giác tập trung.

Ailoot Ultra · Ảnh POST /v1/images/generations qwen/qwen-image-3-pro

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 Pro là mô hình thế hệ thứ ba hàng đầu của Qwen để tạo và chỉnh sửa ảnh. Mô hình kết hợp tạo bố cục phức tạp, bề mặt chân thực chi tiết, chữ đa ngôn ngữ và khả năng bám sát yêu cầu ảnh. Pro và Qwen-Image-3.0 tiêu chuẩn có chung các chế độ tạo và chỉnh sửa được công bố; Pro nhấn mạnh chất lượng ảnh, còn phiên bản tiêu chuẩn cân bằng chất lượng và tốc độ. Kết quả là một sản phẩm ảnh đã kết xuất.

Với đồ họa giàu thông tin, xác định nội dung trước hình thức: tiêu đề, văn bản bổ trợ, số liệu, thứ bậc và quan hệ giữa các phần. Một yêu cầu sản phẩm hữu ích có thể kết hợp đối tượng chính, chi tiết vật liệu cận cảnh và các tính năng có nhãn trên cùng một khung hình. Với minh họa giáo dục, xác định khái niệm, cấu trúc sơ đồ và chú thích chính xác thay vì dựa vào mô hình để tự tạo các dữ kiện nền tảng. Bố cục phức tạp cũng có thể thể hiện nhiều ô hoặc giao diện lồng nhau. Với mức tối đa được khuyến nghị là 4.500 token cho lời nhắc, hãy tập trung vào những gì phải xuất hiện và vị trí của chúng.

Họ 3.0 hỗ trợ thể hiện chữ bản địa trong 12 ngôn ngữ, nhiều phông và hơn 100 phong cách nghệ thuật, cùng các bề mặt tinh tế như tóc, da hoặc vải. Khả năng kết xuất chữ nhỏ được trình diễn tới mức 10 pixel. Điều này hỗ trợ thiết kế hòa chữ với vật liệu thực hoặc kết hợp văn bản với hình ảnh chân thực. Cung cấp từ ngữ, chữ số và ngôn ngữ chính xác, đồng thời mô tả vai trò chữ của mỗi khối. Trang báo hoặc mô phỏng giao diện vẫn là ảnh, vì vậy bố cục chỉnh sửa được hay hành vi tương tác về sau là sản phẩm riêng cần xây dựng từ ảnh đó.

Pro có thể sửa chữ trong ảnh, thêm, xóa hoặc di chuyển thành phần, thay đổi hành động của chủ thể, chuyển phong cách thị giác và tăng chi tiết. Chỉnh sửa nhận một đến ba ảnh đầu vào cùng chỉ dẫn. Thứ tự xác định ảnh 1, ảnh 2 và ảnh 3 trong yêu cầu. Nêu ảnh nào cung cấp danh tính chủ thể, ảnh nào cung cấp đồ vật hay trang phục và ảnh nào cung cấp bối cảnh hoặc tư thế. Bản chỉnh sửa tập trung nêu cả thay đổi mong muốn lẫn đặc điểm cần giữ nguyên, giúp đối chiếu ảnh kết quả với các tham chiếu dễ hơn.

Đầu vào được hỗ trợ là JPG, JPEG, PNG, BMP, TIFF, WebP và GIF; với GIF động chỉ dùng khung đầu tiên. Mỗi ảnh đầu vào có thể tới 10 MB. API cụ thể nhận cạnh từ 1 đến 8.000 pixel và tỷ lệ cạnh dài so với cạnh ngắn không lớn hơn 10:1; khoảng được khuyến nghị là 384–2.048 pixel. Hướng dẫn chỉnh sửa riêng khuyến nghị ảnh tới 3.072 pixel, vì vậy lựa chọn đầu vào nên phục vụ chi tiết cần thiết thay vì được coi là lời hứa rằng mọi độ phân giải đều cải thiện kết quả. Dùng tham chiếu dễ đọc và có khung hình phù hợp cho chữ rất nhỏ hoặc đặc điểm vật liệu.

Đầu ra là PNG. Quy trình của nhà phát triển trả về một đến sáu phương án, mặc định là một, và hỗ trợ tổng diện tích pixel từ 512 × 512 đến 2.048 × 2.048 với tỷ lệ khung hình từ 1:8 đến 8:1. Ngân sách diện tích pixel cho phép một số kích thước không vuông có cạnh dài vượt 2.048 pixel. Khi không chỉ định kích thước, mô hình đề xuất độ phân giải theo yêu cầu. Chọn hình dạng cho vị trí sử dụng thực tế, rồi đối chiếu các phương án được tạo về độ đầy đủ nội dung, chi tiết chủ thể và chữ ở kích thước hiển thị dự kiến.

Viết lại lời nhắc thông minh được bật mặc định. Tăng cường trực tiếp có sẵn cho cả tạo và chỉnh sửa, trong khi tăng cường bằng agent tinh chỉnh lời nhắc văn bản thành ảnh và không thể dùng cho chỉnh sửa ảnh thành ảnh. Chế độ Thinking cũng được bật mặc định và yêu cầu viết lại lời nhắc; tính năng này thêm công việc suy luận và thời gian tạo. Lời nhắc phủ định xác định thành phần không mong muốn, còn seed tùy chọn có thể giúp so sánh các biến thể nhất quán hơn. Yêu cầu khẳng định rõ ràng vẫn cần xác định chủ thể, bố cục và chi tiết cần giữ.

Bước rà soát kết quả thực tế kiểm tra văn bản chính xác, con số, thứ tự đọc, độ trung thành với tham chiếu, các đường biên hoặc bề mặt quan trọng đối với thiết kế. Khi một phần cụ thể cần sửa, giữ bố cục thành công và mô tả thay đổi tập trung. Lưu tất cả ảnh được chọn cùng lời nhắc và tham chiếu, vì vị trí đầu ra của nhà phát triển hết hạn sau 24 giờ. Các chế độ và giới hạn được công bố của Pro thuộc phiên bản 3.0; tính năng mười tham chiếu và độ trong suốt gốc được mô tả cho Qwen 2.1 là khả năng riêng của phiên bản đó.

Ailoot Ultra · Ảnh POST /v1/images/generations qwen/qwen-image-3-pro

qwen/qwen-image-3-pro

Alibaba /qwen/qwen-image-3-pro

Bắt đầu

Đầ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ường`model`	Loại`string`	Yêu cầuBắt buộc	Giá trị & giới hạn qwen/qwen-image-3-pro	Mặc định—
Trường`prompt`	Loại`string`	Yêu cầuBắt buộc	Giá trị & giới hạn Độ dài tối thiểu: 1	Mặc định—
Trường`resolution`	Loại`string`	Yêu cầuKhông bắt buộc	Giá trị & giới hạn 1K, 2K	Mặc định—
Trường`aspect_ratio`	Loại`string`	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ường`n`	Loại`integer`	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ường`input_references`	Loại`array`	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ường`provider`	Loại`object`	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.08 ướ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

curl

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-pro', '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}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}

Lượt đọc nội dung khác

Đọc tài nguyên hiện có thuộc về bạn

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ường`created`	Loại
Trường`data[].url`	Loại
Trường`data[].b64_json`	Loại
Trường`usage`	Loại

Bí danh

Bí danh mô hình

Ailoot Ultra qwen/qwen-image-3-pro

Bí danh đường dẫn phương thức

/v1/images

ID gọi liên quan

qwen/qwen-image-3-pro

FAQ · Qwen: Qwen Image 3 Pro

Có những đầu vào và kết quả nào?: POST /v1/images/generations · qwen/qwen-image-3-pro: text, image → image
Yêu cầu sử dụng những trường nào?: POST /v1/images/generations · qwen/qwen-image-3-pro: 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-pro: n.minimum: 1; n.maximum: 6

Qwen: Qwen Image 3 Pro