Felo API PlatformFelo API Platform
Modellere dön

Microsoft AI: MAI-Image-2.7 API

MAI-Image-2.7, metin ve görsellerden tutarlı, fotogerçekçi görüntüler üreten gelişmiş bir görsel modeldir.

Microsoft AI tarafından geliştirilen MAI-Image-2.7, metin girdilerinden difüzyon tabanlı görüntüler oluşturur ve mevcut görselleri görselden görsele dönüştürme yöntemiyle düzenler. Nesneleri kaldırabilir, değiştirebilir veya özelliklerini güncelleyebilir; kompozisyonu ve yerleşimi koruyarak renk, ışık, atmosfer ve sahne stilinde ayrıntılı değişiklikler yapabilir. Metin, etiket, poster, ambalaj ve tabela gibi yüzeylerde doğru biçimde işlenebilir.

Model; fotogerçekçi görseller, yüksek doğruluklu portreler, ürün görselleri, marka varlıkları, ticari tasarımlar, logolar, ikonlar ve illüstrasyonlar üretmek için uygundur. Mevcut varlıkları geri yükleme ve iyileştirme, ürün görsellerinden arka plan kaldırma, ürünleri yeni ortamlara taşıma, ışıklandırmayı veya ruh hâlini değiştirme gibi görevleri destekler. Yinelenen düzenlemeler sırasında görsel tutarlılığı korur ve genel görüntüyü kaybetmeden ayrıntılı değişiklikler yapar.

MAI-Image-2.7, MAI-Image-2.6 ile karşılaştırıldığında değerlendirilen10 kullanım alanının tamamında ve7 düzenleme eyleminin tamamında iyileştirme sunar. Model, Microsoft Foundry içinde herkese açık önizleme olarak kullanılabilir; ayrıca fal, Genspark, OpenRouter ve Vercel üzerinden sunulur.

Güncellendi:

MODEL ID

mai-image-2.7
Bağlam
4.096K
Maks. çıktı
1.024K
Giriş
text / image
Çıkış
image

Öne çıkanlar

  • Fotogerçekçi görüntüler
  • Tutarlı görsel düzenleme
  • Gelişmiş metin işleme
  • Kompozisyonu koruyan değişiklikler
  • Ayrıntılı ürün tasarımları

Sağlayıcılar

1 sağlayıcı

Sağlayıcılar arasındaki API fiyatlarını karşılaştırın. Tüm ücretleri ve koşulları görmek için bir sağlayıcı seçin.

Sağlayıcı · Fiyat ayrıntıları
Kullanılabilirlik

Kıyaslamalar

  • AA-Image-Editing v2.1

    Elo puanı;5,478 oyla2026-11-16 tarihinde1. sırada.

    1215
  • Artificial Analysis scene and style

    Elo değeri, sonraki modelden daha yüksek.

    24
  • Artificial Analysis live-action film

    Sıralamada1. sırada.

    1.
  • Artificial Analysis consumer

    Sıralamada1. sırada.

    1.
  • Artificial Analysis frontier editing

    Sıralamada1. sırada.

    1.

Puanlar model sağlayıcısının yayımladığı şekildedir.

Hızlı başlangıç

Görsel görevini gönderin, durumunu sorgulayın ve görselleri kaydedin. Örnekler curl ve Python 3 standart kitaplığını kullanır.

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

1API anahtarınızı alın

Felo API Platform hesabınızdan bir anahtar oluşturun ve ortam değişkeni olarak ayarlayın.

export FELO_API_KEY="YOUR_API_KEY"

2İlk isteğinizi yapın

İsteğe bağlı değerler modele göre değişir ve burada ayarlanmaz. Playground’da doğrulayın. Alanlar input içinde değil, model ve prompt ile aynı düzeydedir.

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"
}'

3Görevi yokla

Gönderim task_id döndürür. queued veya running durumunda 3 saniyede bir sorgulayın; succeeded, failed veya interrupted durumunda durun. En fazla 30 dakika bekleyin. Yeniden göndermeden sorgulamayı sürdürmek için created.json dosyasını saklayın.

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

4Çıktıyı indir

Başarıdan sonra task.json içindeki outputs verilerini kaydedin. HTTPS URL, URL nesnesi ve b64_json desteklenir. İmzalı URL’leri gecikmeden indirin; görsel indirmek API anahtarı gerektirmez.

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

Düzenleme için örnek URL’yi kendi HTTPS görsel URL’niz veya base64 görsel data URL’nizle değiştirin. Bir kez gönderip aynı sorgulama ve kaydetme adımlarını izleyin.

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"
      }
    }
  ]
}'

Desteklenen parametreler

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

Tam referansı mı tercih edersiniz?

API referansı →

Sık sorulan sorular

Model tanıtımı: Microsoft AI: MAI-Image-2.7?

Microsoft AI tarafından geliştirilen MAI-Image-2.7, metin girdilerinden difüzyon tabanlı görüntüler oluşturur ve mevcut görselleri görselden görsele dönüştürme yöntemiyle düzenler. Nesneleri kaldırabilir, değiştirebilir veya özelliklerini güncelleyebilir; kompozisyonu ve yerleşimi koruyarak renk, ışık, atmosfer ve sahne stilinde ayrıntılı değişiklikler yapabilir. Metin, etiket, poster, ambalaj ve tabela gibi yüzeylerde doğru biçimde işlenebilir. Model; fotogerçekçi görseller, yüksek doğruluklu portreler, ürün görselleri, marka varlıkları, ticari tasarımlar, logolar, ikonlar ve illüstrasyonlar üretmek için uygundur. Mevcut varlıkları geri yükleme ve iyileştirme, ürün görsellerinden arka plan kaldırma, ürünleri yeni ortamlara taşıma, ışıklandırmayı veya ruh hâlini değiştirme gibi görevleri destekler. Yinelenen düzenlemeler sırasında görsel tutarlılığı korur ve genel görüntüyü kaybetmeden ayrıntılı değişiklikler yapar. MAI-Image-2.7, MAI-Image-2.6 ile karşılaştırıldığında değerlendirilen10 kullanım alanının tamamında ve7 düzenleme eyleminin tamamında iyileştirme sunar. Model, Microsoft Foundry içinde herkese açık önizleme olarak kullanılabilir; ayrıca fal, Genspark, OpenRouter ve Vercel üzerinden sunulur.

Kullanım nasıl faturalandırılır?

Faturanız kullandığınız sağlayıcıya, fiyatlarına ve kullanımınıza bağlıdır. Daha uzun girişler veya başka koşullar farklı fiyatlara tabi olabilir. Gerçek üretim maliyetine göre faturalandırılır. Kesin tutar için faturanızı kontrol edin.

MAI-Image-2.7 hangi girdileri destekler?

Metin girdisi ve görsel girdisi destekler; çıktı olarak görsel üretir.

Model hangi görsel düzenlemeleri yapabilir?

Nesneleri kaldırabilir, değiştirebilir veya nesne özelliklerini güncelleyebilir. Ayrıca iç boyama, metin güncelleme ve hareket bulanıklığı kusurlarını giderme işlemleri yapabilir.

Hangi görevler için uygundur?

Yaratıcı üretim, tasarım, sahne yeniden stillendirme, ürün görselleri, marka varlıkları, logolar, ikonlar ve mevcut varlıkları iyileştirme için uygundur.

Görsel düzenlemelerde tutarlılığı korur mu?

Evet. Yinelenen düzenlemeler sırasında görsel tutarlılığı korur ve kompozisyon ile yerleşimi muhafaza eder.

MAI-Image-2.6 ile farkı nedir?

MAI-Image-2.7, değerlendirilen10 kullanım alanının tamamında ve7 düzenleme eyleminin tamamında MAI-Image-2.6'ya kıyasla iyileştirilmiştir.

İlgili modeller