Microsoft AI: MAI-Image-2.5

Microsoft AI MAI-Image-2.5 tạo ảnh từ văn bản và chỉnh sửa có mục tiêu trên ảnh chụp hoặc thiết kế được cung cấp. Mô hình hỗ trợ thay vật thể và chữ, làm sạch lỗi và chỉnh sửa giữ khuôn mặt, với đầu ra PNG và tối đa năm tham chiếu thị giác. Thẻ mô hình quy định ngữ cảnh 32K và 1,048,576 pixel đầu ra.

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

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 là phiên bản tạo ảnh thông thường và chỉnh sửa có kiểm soát trong dòng hình ảnh 2.5. Thẻ mô hình mô tả mô hình khuếch tán dùng flow matching, có 20 tỷ tham số không tính embedding, đầu vào văn bản và ảnh, cùng ngữ cảnh 32K token. Mô hình tạo đầu ra hình ảnh cho ý tưởng, chân dung, ảnh sản phẩm, minh hoạ và sửa thiết kế có sẵn. Lựa chọn khởi đầu hữu ích là tác vụ cần bố cục mới hay thay đổi cụ thể đối với tài nguyên đã có chủ thể mong muốn.

Khi tạo ảnh, mô tả chủ thể chính, phong cách thị giác, ánh sáng, góc nhìn và cách sắp xếp. Nhà sản xuất nhấn mạnh ảnh chi tiết, thống nhất, kết xuất chữ, ảnh sản phẩm và bám sát câu lệnh. Bản yêu cầu thực tế cho minh hoạ thuyết trình có thể nêu vai trò chủ thể, trọng tâm thị giác dự định và lượng không gian xung quanh. Ý tưởng sản phẩm có thể gồm chất liệu, tỷ lệ và bề mặt hoàn thiện. Giữ mô tả thống nhất để vật thể cùng thuộc một cảnh và một kế hoạch ánh sáng, thay vì kết hợp nhiều cách thể hiện không tương thích.

Suy luận thị giác trong phiên bản này liên quan đến cấu trúc cảnh, ánh sáng, tỷ lệ và quan hệ không gian. Nhà sản xuất đưa ví dụ thêm vật thể với phối cảnh và bóng phù hợp như một ứng dụng chỉnh sửa. Với chỉnh sửa xưởng làm việc, đặt ghế đẩu nhỏ cạnh bàn thợ trong khi giữ góc nhìn và ánh sáng hiện có. Việc kiểm tra cần đối chiếu kích thước ghế, nơi chạm sàn và bóng có theo các vật khác hay không. Vật thể thuyết phục ở vùng cục bộ vẫn cần phù hợp hình học toàn ảnh nguồn.

Chỉnh sửa có định hướng gồm xoá hoặc 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 như giảm lỗi nhoè chuyển động. Cung cấp ảnh nguồn và nêu cả phần cần sửa lẫn chi tiết cần giữ. Một chỉnh sửa ảnh có trọng tâm có thể xoá vật gây phân tâm ở nền trong khi giữ người, vùng cắt và sắp xếp tiền cảnh. Lần sửa thiết kế có thể cập nhật dòng chữ ngắn nhưng giữ bố cục. Đối chiếu toàn bộ kết quả với nguồn thay vì chỉ đánh giá vùng đã sửa.

Microsoft cũng nhấn mạnh tính nhất quán danh tính khuôn mặt qua chỉnh sửa, gồm đổi tư thế, biểu cảm hoặc góc nhìn. Dùng tham chiếu rõ để giữ độ giống và chỉ định thay đổi dự định theo cách bảo toàn đặc điểm nhận diện. Hướng dẫn chỉnh sửa hiện hành của nhà sản xuất nhận tối đa năm ảnh JPEG hoặc PNG, cho phép các tham chiếu khác nhau xác định người, vật thể, cảnh hoặc phong cách. Nêu các vai trò đó trong câu lệnh. Khi sửa chân dung, kiểm tra khuôn mặt cũng như quần áo hoặc nền đã đổi trước khi coi ảnh hoàn thiện.

Thẻ mô hình cụ thể giới hạn đầu ra ở tổng 1,048,576 pixel, tương đương hình vuông 1024×1024, và cho phép một cạnh vượt 1024 nếu tổng vẫn trong diện tích đó. Hướng dẫn phục vụ mô hình còn yêu cầu cả hai chiều ít nhất 768 pixel. Đích chữ nhật như 1344×768 có 1,032,192 pixel và đáp ứng quy tắc diện tích cùng kích thước tối thiểu được công bố đó. Giới hạn hữu ích là tích chiều rộng và chiều cao, nên chuẩn bị hình dạng nơi sử dụng trước khi yêu cầu bố cục ngang hoặc dọc.

Tạo và chỉnh sửa trả dữ liệu ảnh PNG trong giao diện phục vụ mô hình của nhà sản xuất. Thẻ mô hình gốc báo ngữ cảnh 32K token, còn giao diện đó quy định ngữ cảnh câu lệnh tối đa 32,000 token. Con số 4,096 token đầu ra riêng trong danh mục là hạn mức token, không phải kích thước đầu ra. Giữ đúng các phạm vi công bố đó khi tổ chức câu lệnh chi tiết và ảnh hoàn chỉnh. Tài nguyên nguồn, đặc điểm được giữ, chỉnh sửa yêu cầu và kích thước đích tạo thành hồ sơ sửa hữu ích cùng PNG.

Phạm vi sáng tạo của mô hình trải từ hình ảnh chân thực như ảnh chụp và điện ảnh, chân dung, ý tưởng sản phẩm hoặc thương hiệu, thiết kế có chữ đến phong cách thị giác khác. Với nhãn hoặc biển, cung cấp nội dung chính xác và kiểm tra chính tả ở kích thước hiển thị cuối cùng. Bề mặt nhiếp ảnh dễ nhận biết vẫn có thể chứa chi tiết bịa ra, phản chiếu không nhất quán hoặc chữ không chính xác. Kiểm tra thực tế theo yêu cầu thiết kế: danh tính vật thể, độ dễ đọc, quan hệ không gian và cảnh được giữ đều quan trọng. Tách sửa chữa cụ thể khỏi những thay đổi đã đạt.

Trong dòng 2.5, Pro nhấn mạnh độ trung thực cao hơn và quan hệ ổn định trong cảnh dày đặc, còn Flash phục vụ sản xuất phản hồi nhanh hơn. Dòng 2.6 đưa vào hạn mức diện tích điểm ảnh lớn hơn được công bố, tuỳ chọn dùng web làm căn cứ và chọn tỷ lệ do mô hình quyết định. 2.5 tiêu chuẩn giữ quy trình tạo và chỉnh sửa riêng, không có các tuỳ chọn về sau đó. Chọn phiên bản theo phần khó của tác vụ ảnh thực tế và kiểm tra kết quả hoàn chỉnh theo bản yêu cầu đó.

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

microsoft/mai-image-2.5

Microsoft AI /microsoft/mai-image-2.5

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	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.385024 ướ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', '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

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

/v1/images

ID gọi liên quan

microsoft/mai-image-2.5

FAQ · Microsoft AI: MAI-Image-2.5

Có những đầu vào và kết quả nào?: POST /v1/images/generations · microsoft/mai-image-2.5: 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: 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: n.minimum: 1; n.maximum: 1

Microsoft AI: MAI-Image-2.5