Microsoft AI: MAI-Image-2.5 Pro

Microsoft AI MAI-Image-2.5 Pro tạo và chỉnh sửa ảnh chi tiết cho hình ảnh chủ đạo, bố cục sản phẩm và chữ chính xác trong ảnh. Phiên bản Pro nhấn mạnh vật thể, nhân vật, chất liệu và quan hệ không gian nhất quán trong cảnh dày đặc, dùng văn bản cùng tham chiếu thị giác để tạo ảnh PNG.

Ailoot Ultra · Ảnh POST /v1/images/generations microsoft/mai-image-2.5-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.

Microsoft AI MAI-Image-2.5 Pro là phiên bản chú trọng độ trung thực trong dòng hình ảnh 2.5. Mô hình tạo ảnh từ bản yêu cầu ngôn ngữ tự nhiên và thực hiện chỉnh sửa có định hướng trên tài nguyên có sẵn. Microsoft xác định hình ảnh chủ đạo, chỉnh sửa chi tiết và chữ chính xác trong ảnh là các ứng dụng chính, còn bảng so sánh mô hình nhấn mạnh tính nhất quán của vật thể, nhân vật, chất liệu và quan hệ không gian trong bố cục phức tạp. Tài nguyên cuối cùng là ảnh cho quy trình thiết kế hoặc sản xuất, như ảnh sản phẩm chủ chốt hoặc cảnh biên tập được sắp xếp kỹ.

Khi tạo ảnh, mô tả bố cục qua các quan hệ thay vì danh sách vật thể không liên quan. Xác định chủ thể chính, tỷ lệ so với vật xung quanh, chất liệu và hướng sáng. Suy luận thị giác được công bố của phiên bản Pro hữu ích khi những quan hệ này quyết định cảnh dày đặc có đáng tin hay không. Với bố cục sản phẩm, đặt bình gốm, ly trong suốt và khăn gấp trên bàn gỗ, với phản chiếu nhất quán và một nguồn sáng cửa sổ. Kiểm tra điểm tiếp xúc, bóng và đặc tính chất liệu nhìn thấy trong ảnh kết quả.

Với công việc sản phẩm và nhân vật, cung cấp danh tính thị giác phải được giữ qua chỉnh sửa. Microsoft mô tả tính nhất quán vật thể qua cảnh phức tạp và tính nhất quán nhân vật qua góc nhìn cùng khoảnh khắc là thế mạnh của Pro. Nêu đặc điểm nhận diện vật hoặc người và khía cạnh của cảnh cần thay đổi. Ví dụ, giữ dáng áo khoác và chi tiết khoá cài khi đưa nhân vật sang nền khác. Việc kiểm tra hữu ích đối chiếu những chi tiết được giữ đó với tham chiếu nguồn; kết quả hấp dẫn về thị giác tự nó chưa chứng minh khớp chính xác.

Giao diện chỉnh sửa ảnh của nhà sản xuất nhận tối đa năm tham chiếu JPEG hoặc PNG. Tách vai trò của chúng trong bản yêu cầu: sản phẩm, người, bối cảnh hoặc cách thể hiện thị giác. Tác vụ chỉnh sửa gồm xoá và thay vật thể, đổi thuộc tính, vẽ bù vùng ảnh, điều chỉnh bố cục, cập nhật chữ và làm sạch lỗi. Với sửa cục bộ, mô tả đích cần sửa và yếu tố xung quanh cần giữ. Với sắp xếp lại đáng kể hơn, giải thích cách bố cục cần hoạt động sau thay đổi để mô hình có mục tiêu không gian thống nhất.

Kết xuất chữ đặc biệt phù hợp với bố cục chủ đạo hoặc ý tưởng bao bì. Cung cấp cụm từ chính xác, vị trí và quan hệ với vật thể hoặc hình ảnh. Giữ tên lặp lại và nội dung nhãn nhất quán giữa bản yêu cầu và tham chiếu. Kiểm tra từng ký tự được kết xuất ở kích thước hiển thị dự định và đối chiếu với nội dung cung cấp. Lần sửa sau có thể tập trung vào nội dung hoặc vị trí chữ trong khi giữ bố cục sản phẩm đã đạt. Sau đó có thể đưa đầu ra PNG vào bố cục đã xác định yêu cầu kiểu chữ và cắt ảnh cuối cùng.

Hướng dẫn ảnh hiện hành của Microsoft áp dụng diện tích đầu ra tối đa 1,048,576 pixel cho các mô hình 2.5, tương đương 1024×1024. Cả hai chiều phải ít nhất 768 pixel trong giao diện đó, và cho phép cạnh dài hơn khi tổng diện tích vẫn trong giới hạn. Điều này cho phép bố cục chữ nhật như 1344×768, tổng 1,032,192 pixel. Ràng buộc diện tích này khác mức tối đa 1024 cho mỗi cạnh. Chuẩn bị hình dạng đích cho bố cục thay vì kỳ vọng nhãn tỷ lệ khung hình chung xác định đúng vùng cắt.

Hướng dẫn phục vụ mô hình quy định ngữ cảnh câu lệnh tối đa 32,000 token và trả dữ liệu ảnh PNG cho cả tạo và chỉnh sửa. Trang danh mục Pro cụ thể liệt kê riêng cửa sổ ngữ cảnh 131.072K và 4,096 token đầu ra. Đây là các lượng token được công bố trong phạm vi danh mục hoặc phục vụ mô hình riêng; việc chuẩn bị yêu cầu ảnh thực tế tuân theo giới hạn câu lệnh và điểm ảnh của dịch vụ. Lưu ảnh, tham chiếu nguồn và bản yêu cầu thành một hồ sơ sửa. Kiểm tra chính kết quả hình ảnh về các ràng buộc danh tính, chất liệu và hình học chi tiết khiến bạn chọn Pro.

Chọn phiên bản theo bố cục. MAI-Image-2.5 tiêu chuẩn bao quát tạo ảnh thông thường và chỉnh sửa cục bộ; Pro bổ sung trọng tâm của dòng về độ trung thực và quan hệ nhất quán trong cảnh dày đặc về thị giác. Dòng 2.6 tăng giới hạn diện tích đầu ra được công bố và bổ sung tuỳ chọn dùng web làm căn cứ cùng tự chọn tỷ lệ. Các tuỳ chọn về sau đó dành riêng cho 2.6 và không định nghĩa quy trình của phiên bản Pro này. Chọn Pro khi phần khó của bản yêu cầu liên quan đến danh tính vật thể ổn định, diện mạo chất liệu hoặc cấu trúc không gian trong ảnh chi tiết.

Kiểm tra cả thay đổi yêu cầu và nội dung được giữ. Bàn tay cầm vật thể, điểm giao nhau, chữ nhỏ, độ giống khuôn mặt và phản chiếu là những nơi hữu ích để xem trong bố cục phức tạp. Ảnh có vẻ hợp lý vẫn có thể chứa dấu đánh dấu gây hiểu sai hoặc quan hệ vật lý không đúng. Nêu lần sửa tiếp theo cụ thể và giữ phần bản yêu cầu đã tạo đúng bố cục. Điều này hỗ trợ chuỗi sửa thiết kế có kiểm soát thay vì liên tục xác định lại toàn bộ cảnh.

Ailoot Ultra · Ảnh POST /v1/images/generations microsoft/mai-image-2.5-pro

microsoft/mai-image-2.5-pro

Microsoft AI /microsoft/mai-image-2.5-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 microsoft/mai-image-2.5-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`aspect_ratio`	Loại`string`	Yêu cầuKhông bắt buộc	Giá trị & giới hạn 1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3, auto	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: 1	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: 1	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	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—	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ì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	Phí Đầu ra · Chi phí tạo ước tính · Ước tính chỉ để so sánh $0.884736 ướ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': 'microsoft/mai-image-2.5-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 microsoft/mai-image-2.5-pro

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

/v1/images

ID gọi liên quan

microsoft/mai-image-2.5-pro

FAQ · Microsoft AI: MAI-Image-2.5 Pro

Có những đầu vào và kết quả nào?: POST /v1/images/generations · microsoft/mai-image-2.5-pro: text, image → image
Yêu cầu sử dụng những trường nào?: POST /v1/images/generations · microsoft/mai-image-2.5-pro: model, prompt, aspect_ratio, n, input_references, provider
Áp dụng những giới hạn nào?: POST /v1/images/generations · microsoft/mai-image-2.5-pro: n.minimum: 1; n.maximum: 1

Microsoft AI: MAI-Image-2.5 Pro