Microsoft AI: MAI-Image-2.5
Microsoft AI MAI-Image-2.5 membuat gambar dari teks dan melakukan suntingan terarah pada foto atau desain yang diberikan. Model mendukung perubahan objek dan teks, pembersihan artefak, serta revisi yang mempertahankan wajah, dengan keluaran PNG dan hingga lima referensi visual. Kartu modelnya menetapkan konteks 32K dan 1.048.576 piksel keluaran.
Tentang model
Deskripsi ini mencakup kemampuan model. Masukan, keluaran, dan opsi yang tersedia di Ailoot tercantum di bawah untuk metode yang dipilih.
Microsoft AI MAI-Image-2.5 adalah edisi generasi umum dan penyuntingan terkendali dalam keluarga gambar 2.5. Kartu modelnya menjelaskan model difusi menggunakan flow matching, dengan 20 miliar parameter non-embedding, masukan teks dan gambar, serta konteks 32K token. Model menghasilkan keluaran gambar untuk konsep, potret, citra produk, ilustrasi, dan revisi desain yang ada. Pilihan awal yang berguna adalah apakah tugas memerlukan komposisi baru atau perubahan tertentu pada aset yang sudah memuat subjek yang dimaksud.
Untuk generasi, jelaskan subjek utama, gaya visual, cahaya, sudut pandang, dan susunan. Pembuat menyoroti gambar terperinci dan padu, rendering teks, citra produk, serta kepatuhan pada prompt. Brief praktis untuk ilustrasi presentasi dapat menentukan peran subjek, penekanan visual yang dimaksud, dan banyaknya ruang sekeliling. Konsep produk dapat mencakup material, skala, dan lapisan permukaan. Jaga deskripsi padu agar objek berbagi satu adegan dan satu rencana pencahayaan, alih-alih menggabungkan beberapa pengolahan visual tidak selaras.
Penalaran visual edisi ini menyangkut struktur adegan, pencahayaan, skala, dan hubungan ruang. Produsen memberi contoh penambahan objek dengan perspektif serta bayangan sesuai sebagai penggunaan penyuntingan. Untuk suntingan bengkel, tempatkan bangku kecil di samping meja kerja sambil mempertahankan sudut pandang dan cahaya yang ada. Tinjauan harus membandingkan ukuran bangku, tempatnya menyentuh lantai, dan apakah bayangannya mengikuti objek lain. Objek yang meyakinkan secara lokal tetap harus sesuai dengan geometri seluruh gambar sumber.
Suntingan terarah mencakup penghapusan atau penggantian objek, perubahan atribut, inpainting, adaptasi tata letak, pembaruan teks, dan pembersihan seperti pengurangan artefak blur gerak. Berikan gambar sumber dan sebutkan koreksi sekaligus detail yang dipertahankan. Suntingan foto terarah dapat menghapus objek mengganggu dari latar sambil mempertahankan orang, potongan, dan susunan latar depan. Revisi desain dapat memperbarui baris teks pendek sambil mempertahankan komposisi. Bandingkan hasil lengkap dengan sumber, alih-alih hanya menilai bagian yang disunting.
Microsoft juga menekankan konsistensi identitas wajah antarsuntingan, termasuk perubahan pose, ekspresi, atau sudut pandang. Gunakan referensi jelas untuk kemiripan dan tentukan perubahan yang dimaksud dengan cara yang mempertahankan fitur pengenal. Panduan penyuntingan produsen saat ini menerima hingga lima gambar JPEG atau PNG, sehingga referensi berbeda dapat mengenali orang, objek, adegan, atau gaya. Sebutkan peran itu dalam prompt. Dalam revisi potret, periksa wajah maupun pakaian atau latar yang berubah sebelum menganggap gambar selesai.
Kartu model yang tepat membatasi keluaran pada total 1.048.576 piksel, setara dengan persegi 1024×1024, dan mengizinkan satu sisi melebihi 1024 jika total tetap dalam luas itu. Panduan penyajian juga mewajibkan kedua dimensi minimal 768 piksel. Sasaran persegi panjang seperti 1344×768 memiliki 1.032.192 piksel dan memenuhi aturan luas serta dimensi minimum terdokumentasi tersebut. Batas yang berguna adalah hasil kali lebar dan tinggi, sehingga siapkan bentuk tujuan sebelum meminta komposisi lanskap atau potret.
Generasi dan penyuntingan mengembalikan data gambar PNG dalam antarmuka penyajian produsen. Kartu model bawaan melaporkan konteks 32K token, sementara antarmuka itu menentukan konteks prompt maksimum 32.000 token. Angka 4.096 token keluaran terpisah dalam katalog merupakan jatah token, bukan dimensi keluaran. Pertahankan cakupan yang dinyatakan itu ketika mengatur prompt terperinci dan gambar selesai. Aset sumber, fitur yang dipertahankan, suntingan yang diminta, serta ukuran sasaran menjadi catatan revisi yang berguna bersama PNG.
Jangkauan kreatif model meliputi citra fotorealistis dan sinematis, potret, konsep produk atau merek, desain berteks, serta gaya visual lain. Untuk label atau papan, berikan kata-kata tepat dan periksa ejaannya pada ukuran tampilan akhir. Permukaan fotografis yang dapat dikenali tetap dapat memuat detail rekaan, pantulan tidak konsisten, atau huruf tidak akurat. Pemeriksaan praktis mengikuti kebutuhan desain: identitas objek, keterbacaan, hubungan ruang, dan adegan yang dipertahankan semuanya penting. Pisahkan koreksi spesifik dari perubahan yang sudah berhasil.
Dalam keluarga 2.5, Pro menekankan kesetiaan lebih tinggi dan hubungan stabil dalam adegan padat, sementara Flash melayani produksi lebih responsif. Keluarga 2.6 memperkenalkan jatah luas piksel terdokumentasi yang lebih besar, grounding web opsional, dan pemilihan aspek oleh model. 2.5 standar mempertahankan alur generasi dan penyuntingannya sendiri tanpa kendali terbaru itu. Pilih edisi berdasarkan bagian sulit tugas gambar sebenarnya dan tinjau hasil selesai terhadap brief tersebut.
Ailoot Ultra · Gambar POST /v1/images/generations microsoft/mai-image-2.5
microsoft/mai-image-2.5Mulai
Microsoft AI MAI-Image-2.5 membuat gambar dari teks dan melakukan suntingan terarah pada foto atau desain yang diberikan. Model mendukung perubahan objek dan teks, pembersihan artefak, serta revisi yang mempertahankan wajah, dengan keluaran PNG dan hingga lima referensi visual. Kartu modelnya menetapkan konteks 32K dan 1.048.576 piksel keluaran.
- Masukan yang diterima
- Teks · Gambar
- Hasil
- Gambar
Tersedia di Ailoot · masukan & metode
Ailoot Ultra · Gambar POST /v1/images/generations
- Masukan
text,image- Keluaran
image
| Kolom | Jenis | Persyaratan | Nilai & batasan | Bawaan |
|---|---|---|---|---|
Kolommodel | Jenisstring | PersyaratanWajib | Nilai & batasan microsoft/mai-image-2.5 | Bawaan— |
Kolomprompt | Jenisstring | PersyaratanWajib | Nilai & batasan Panjang minimum: 1 | Bawaan— |
Kolomaspect_ratio | Jenisstring | PersyaratanOpsional | Nilai & batasan 1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3, auto | Bawaan— |
Kolomn | Jenisinteger | PersyaratanOpsional | Nilai & batasan Minimum: 1 Maksimum: 1 | Bawaan— |
Kolominput_references | Jenisarray | PersyaratanOpsional | Nilai & batasan Item minimum: 0 Item maksimum: 1 | Bawaan— |
Kolomprovider | Jenisobject | PersyaratanOpsional | Nilai & batasan | Bawaan— |
Parameter metode dan siklus hidup
| Parameter | Kontrak |
|---|---|
Parametercontent_type | Kontrakapplication/json |
Parameterrequired | Kontrakmodel, prompt |
Parametermaterial_types | Kontraktext, image |
Siklus hidup: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · task_id aktual yang dikembalikan atau catatan pustaka media
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Paket
Cara menghitung biaya akhir
Tarif yang ditampilkan memperkirakan biaya sebelum pembuatan. Biaya akhir dihitung dari biaya yang tercatat untuk proses pembuatan awal. Durasi keluaran yang terukur dan kuantitas perkiraan bukanlah kuantitas akhir yang ditagihkan.
Referensi tarif tidak menambah opsi permintaan. Parameter yang didukung tercantum pada metode yang dipilih.
- Mode Fast
- Tidak ditentukan Saat mode fast dipilih
- Mode Flex
- Tidak ditentukan Saat mode flex dipilih
- Upaya penalaran maksimum
- Tidak ditentukan Saat upaya penalaran maksimum menggunakan penyesuaian default
Perkiraan tarif untuk perbandingan
Harga menurut konfigurasi
Cocokkan setiap biaya dengan kondisi yang ditampilkan. Gunakan satu tarif untuk setiap kelompok konfigurasi alternatif.
| Konfigurasi | Jadwal tarif | Jumlah perkiraan | Biaya |
|---|---|---|---|
| KonfigurasiTarif dasar token | Jadwal tarifTarif dasar | Jumlah perkiraan— | Biaya Masukan · Token masukan · Perkiraan hanya untuk perbandingan — / 1K token Keluaran · Token keluaran · Perkiraan hanya untuk perbandingan — / 1K token Masukan · Pembacaan cache · Perkiraan hanya untuk perbandingan — / 1K token Masukan · Penulisan cache · Perkiraan hanya untuk perbandingan — / 1K token Masukan · Penulisan cache, 1 jam · Perkiraan hanya untuk perbandingan — / 1K token |
| KonfigurasiPerkiraan biaya pembuatan | Jadwal tarif— | Jumlah perkiraanestimasi satu kali pembuatan | Biaya Keluaran · Perkiraan biaya pembuatan · Perkiraan hanya untuk perbandingan $0.385024 estimasi sebelum pembuatan Perkiraan ini bukan biaya tambahan maupun tarif tetap untuk proses pembuatan yang telah selesai. |
Ailoot mencadangkan perkiraan dana sebelum permintaan. Setelah hasil diterima, tagihan akhir diselesaikan berdasarkan penggunaan yang terukur. Penyelesaian tagihan streaming menggunakan catatan penggunaan akhir. Cara kerja cadangan dan penyelesaian tagihan →
Contoh permintaan
Ailoot Ultra · Gambar
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
Terima dan simpan hasil
Ailoot Ultra · Gambar
Unduh setiap gambar yang dikembalikan atau simpan konten Base64-nya
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
Pembacaan konten lain
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.
Simpan semua hasil yang selesai
Simpan setiap gambar yang selesai; ambil setiap URL yang dikembalikan atau dekode konten Base64-nya.
Simpan respons dan header secara lengkap, setiap keluaran aktual, identifikator asli yang dikembalikan, dan semua kolom usage. Pulihkan operasi asli tanpa mengirim ulang permintaan pembuatan.
Jika respons asli perlu diperiksa
Simpan X-Client-Request-ID yang dikembalikan untuk rekonsiliasi. Baca hanya nilai task_id/asset_id yang benar-benar dikembalikan atau pustaka media milik Anda; jangan pernah membuat URL tugas dari ID operasi dan jangan pernah mengirim ulang permintaan pembuatan.
Kolom respons
| Kolom | Jenis |
|---|---|
Kolomcreated | Jenis |
Kolomdata[].url | Jenis |
Kolomdata[].b64_json | Jenis |
Kolomusage | Jenis |
Alias
Alias model
Ailoot Ultra microsoft/mai-image-2.5
Alias jalur metode
/v1/images
ID pemanggil terkait
FAQ · Microsoft AI: MAI-Image-2.5
- Input dan hasil apa yang tersedia?
POST /v1/images/generations·microsoft/mai-image-2.5:text,image→image- Kolom apa yang digunakan permintaan?
POST /v1/images/generations·microsoft/mai-image-2.5:model,prompt,aspect_ratio,n,input_references,provider- Batasan apa yang berlaku?
POST /v1/images/generations·microsoft/mai-image-2.5:n.minimum:1;n.maximum:1