Felo API PlatformFelo API Platform
Kembali ke model

Microsoft AI: MAI-Image-2.7 API

MAI-Image-2.7 menghasilkan dan mengedit gambar realistis dengan kontrol presisi, konsistensi visual, serta rendering teks yang lebih baik.

MAI-Image-2.7 dari Microsoft AI menerima input teks dan gambar, lalu menghasilkan output gambar. Model berbasis difusi ini dapat membuat gambar dari prompt teks atau mengubah gambar yang sudah ada melalui transformasi gambar-ke-gambar, sambil mempertahankan komposisi dan tata letak.

Model ini mendukung penghapusan, penggantian, dan perubahan atribut objek, termasuk inpainting, pembaruan teks, serta penghilangan artefak motion blur. Model mempertahankan konsistensi visual selama pengeditan berulang dan mampu merender teks pada label, poster, kemasan, serta papan tanda.

MAI-Image-2.7 cocok untuk pembuatan kreatif dan desain, penataan ulang adegan, perubahan pencahayaan atau suasana, pemulihan aset, penghapusan latar belakang produk, serta pembuatan logo, ikon, ilustrasi, aset merek, dan desain komersial. Model ini tersedia sebagai public preview di Microsoft Foundry dan juga melalui fal, Genspark, OpenRouter, serta Vercel.

Diperbarui:

ID MODEL

mai-image-2.7
Konteks
4.096K
Output maks
1.024K
Masukan
text / image
Keluaran
image

Sorotan

  • Pengeditan presisi
  • Konsistensi visual kuat
  • Rendering teks lebih baik
  • Output fotorealistis
  • Mendukung inpainting

Penyedia

1 penyedia

Bandingkan harga API antarpenyedia. Pilih penyedia untuk melihat semua biaya dan ketentuan.

Penyedia · Detail harga
Ketersediaan

Tolok ukur

  • AA-Image-Editing v2.1

    Skor Elo berdasarkan5,478 suara; peringkat1 per2026-11-16.

    1215
  • Artificial Analysis scene and style

    Skor Elo lebih tinggi daripada model berikutnya.

    24
  • Artificial Analysis live-action film

    Peringkat1.

    1
  • Artificial Analysis consumer

    Peringkat1.

    1
  • Artificial Analysis frontier editing

    Peringkat1.

    1

Skor sesuai publikasi penyedia model.

Mulai cepat

Kirim tugas gambar, periksa status, lalu simpan gambar. Contoh menggunakan curl dan pustaka standar Python 3.

POST https://openapi.felo.ai/api/v1/images/generations

1Siapkan kunci API

Buat kunci dari akun Felo API Platform Anda dan tetapkan sebagai variabel lingkungan.

export FELO_API_KEY="YOUR_API_KEY"

2Kirim permintaan pertama

Nilai opsional berbeda per model dan tidak ditetapkan di sini. Periksa di Playground. Kolom sejajar dengan model dan prompt, tanpa pembungkus input.

curl --fail-with-body --max-time 60 "https://openapi.felo.ai/api/v1/images/generations" \
  -H "Authorization: Bearer $FELO_API_KEY" \
  -H "Content-Type: application/json" \
  -o created.json \
  -d '{
  "prompt": "A studio product photo of a ceramic coffee cup on warm linen, soft morning light",
  "model": "mai-image-2.7"
}'

3Polling tugas

Pengiriman mengembalikan task_id. Periksa setiap 3 detik saat queued atau running; berhenti saat succeeded, failed, atau interrupted. Tunggu maksimal 30 menit. Simpan created.json untuk melanjutkan pemeriksaan tanpa mengirim ulang.

python3 - <<'PY'
import json, os, time
from pathlib import Path
from urllib.parse import quote
from urllib.request import Request, urlopen

task = json.loads(Path("created.json").read_text())
task_id = task["task_id"]
url = "https://openapi.felo.ai/api/v1/images/generations/" + quote(task_id, safe="")
headers = {"Authorization": "Bearer " + os.environ["FELO_API_KEY"]}
deadline = time.monotonic() + 1800

while task["status"] in ("queued", "running"):
    if time.monotonic() >= deadline:
        raise TimeoutError(f"Keep task_id={task_id} to resume polling")
    time.sleep(3)
    with urlopen(Request(url, headers=headers), timeout=60) as response:
        task = json.load(response)
    if task.get("task_id") != task_id or task.get("kind") != "image":
        raise ValueError("Unexpected task response")
    print(task["status"])

if task["status"] != "succeeded":
    raise RuntimeError(task.get("error") or task["status"])
if not task.get("outputs"):
    raise ValueError("Task succeeded without image outputs")
Path("task.json").write_text(json.dumps(task))
print("Saved task.json")
PY

4Unduh output

Setelah berhasil, simpan outputs dari task.json. Mendukung URL HTTPS, objek URL, dan b64_json. Segera unduh URL bertanda tangan; unduhan gambar tidak memerlukan kunci API.

python3 - <<'PY'
import base64, json
from pathlib import Path
from urllib.request import urlopen

task = json.loads(Path("task.json").read_text())
if task.get("status") != "succeeded" or not task.get("outputs"):
    raise ValueError("No completed image outputs")
extensions = {"image/png": ".png", "image/jpeg": ".jpg", "image/webp": ".webp", "image/gif": ".gif", "image/avif": ".avif"}

for index, output in enumerate(task["outputs"], 1):
    item = output if isinstance(output, dict) else {}
    url = output if isinstance(output, str) else item.get("url") or item.get("unsigned_url")
    mime = item.get("media_type") or "image/png"
    if url and url.startswith("https://"):
        with urlopen(url, timeout=60) as response:
            data = response.read()
            mime = response.headers.get_content_type()
    elif url and url.startswith("data:image/") and ";base64," in url:
        header, encoded = url.split(",", 1)
        mime = header[5:].split(";", 1)[0]
        data = base64.b64decode(encoded, validate=True)
    elif item.get("b64_json"):
        data = base64.b64decode(item["b64_json"], validate=True)
    else:
        raise ValueError("Unrecognized image output")
    path = Path(f"image-{index}" + extensions.get(mime, ".bin"))
    path.write_bytes(data)
    print(path)
PY
input_references

Untuk mengedit gambar, ganti URL contoh dengan URL gambar HTTPS atau data URL gambar base64 Anda. Kirim sekali, lalu ikuti langkah pemeriksaan dan penyimpanan yang sama.

curl --fail-with-body --max-time 60 "https://openapi.felo.ai/api/v1/images/generations" \
  -H "Authorization: Bearer $FELO_API_KEY" \
  -H "Content-Type: application/json" \
  -o created.json \
  -d '{
  "prompt": "Keep the product and framing. Replace the background with a sunlit marble countertop.",
  "model": "mai-image-2.7",
  "input_references": [
    {
      "type": "image_url",
      "image_url": {
        "url": "https://example.com/product.png"
      }
    }
  ]
}'

Parameter yang didukung

  • n
  • background
  • max_tokens
  • temperature
  • aspect_ratio
  • input_references
  • max_completion_tokens

Ingin referensi lengkap?

Referensi API →

Pertanyaan umum

Mengenal Microsoft AI: MAI-Image-2.7?

MAI-Image-2.7 dari Microsoft AI menerima input teks dan gambar, lalu menghasilkan output gambar. Model berbasis difusi ini dapat membuat gambar dari prompt teks atau mengubah gambar yang sudah ada melalui transformasi gambar-ke-gambar, sambil mempertahankan komposisi dan tata letak. Model ini mendukung penghapusan, penggantian, dan perubahan atribut objek, termasuk inpainting, pembaruan teks, serta penghilangan artefak motion blur. Model mempertahankan konsistensi visual selama pengeditan berulang dan mampu merender teks pada label, poster, kemasan, serta papan tanda. MAI-Image-2.7 cocok untuk pembuatan kreatif dan desain, penataan ulang adegan, perubahan pencahayaan atau suasana, pemulihan aset, penghapusan latar belakang produk, serta pembuatan logo, ikon, ilustrasi, aset merek, dan desain komersial. Model ini tersedia sebagai public preview di Microsoft Foundry dan juga melalui fal, Genspark, OpenRouter, serta Vercel.

Bagaimana penggunaan ditagih?

Tagihan Anda bergantung pada penyedia yang digunakan, tarifnya, dan penggunaan Anda. Masukan yang lebih panjang atau ketentuan lain dapat memiliki harga berbeda. Ditagih berdasarkan biaya pembuatan sebenarnya. Lihat tagihan Anda untuk jumlah akhir.

Input dan output apa yang didukung?

Model mendukung input teks, input gambar, dan output gambar.

Apa saja kemampuan pengeditannya?

Model dapat menghapus, mengganti, dan mengubah atribut objek sambil mempertahankan komposisi dan tata letak. Model juga mendukung inpainting, pembaruan teks, serta penghilangan artefak motion blur.

Untuk tugas apa model ini cocok?

Model cocok untuk pembuatan kreatif, desain, restorasi aset, gambar produk, aset merek, ilustrasi, logo, ikon, dan perubahan suasana atau pencahayaan.

Bagaimana perbedaannya dari MAI-Image-2.6?

MAI-Image-2.7 mengalami peningkatan pada seluruh10 use cases yang dievaluasi dan seluruh7 tindakan pengeditan dibandingkan dengan MAI-Image-2.6.

Model terkait