Microsoft AI: MAI-Image-2.7 Flash API
Microsoft AI: MAI-Image-2.7 Flash, hızlı ve kontrollü görsel üretim ve düzenleme için geliştirilmiş difüzyon tabanlı modeldir.
Microsoft AI: MAI-Image-2.7 Flash, metin girdilerinden görsel üreten ve görseller üzerinde hassas, kontrollü düzenlemeler yapan difüzyon tabanlı bir modeldir. Metin ve görsel girdileri kabul eder; çıktıyı her zaman PNG biçiminde, base64 kodlu JSON nesnesi olarak döndürür. Bağlam uzunluğu32,000 tokens’tır.
Model; yüksek hacimli taslak üretimi, hızlı yinelemeli yaratıcı iş akışları ve etkileşimli araçlar için uygundur. Ürün fotoğraflarındaki nesneleri değiştirebilir, şeffaf arka plan oluşturabilir, nesnelerin renk veya malzemesini tüm sahneyi yeniden üretmeden değiştirebilir. Mağaza görselleri, tabelalar ve pazarlama materyallerinde doğru metin oluşturmayı da destekler.
En fazla5 stil veya konu referans görseliyle yönlendirmeli varlık üretimi yapılabilir. Referans görseller JPEG veya PNG olmalı ve görsel düzenlemede5 görselle sınırlıdır. Hız karşılığında bir miktar doğruluk kaybını kabul eden model, metin akıl yürütme, araç kullanımı veya web araması sunmaz; görsel üretim ve düzenlemeyle sınırlıdır.
Güncellendi:
MODEL ID
mai-image-2.7-flash- Bağlam
- 4.096K
- Maks. çıktı
- 1.024K
- Giriş
- text / image
- Çıkış
- image
Öne çıkanlar
- Hızlı görsel üretimi
- Kontrollü görsel düzenleme
- En fazla5 referans
- PNG JSON çıktısı
- Etkileşimli iş akışları
Sağlayıcılar
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.
| Kullanılabilirlik | |
|---|---|
Geçmiş istatistikler canlı durum kontrolü değildir. Eksik veri kesinti anlamına gelmez.
Kıyaslamalar
- 7
Artificial Analysis liderlik tablosu — görsel düzenleme
Sıralama:7
- 11
Artificial Analysis liderlik tablosu — metinden görsel üretimi
Sıralama:11
- 3
Artificial Analysis — sahne ve stil düzenleme
Sıralama:3
- 4
Artificial Analysis — geliştirme ve restorasyon
Sıralama:4
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-flash"
}'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")
PY4Çı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)
PYinput_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-flash",
"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 Flash?
Microsoft AI: MAI-Image-2.7 Flash, metin girdilerinden görsel üreten ve görseller üzerinde hassas, kontrollü düzenlemeler yapan difüzyon tabanlı bir modeldir. Metin ve görsel girdileri kabul eder; çıktıyı her zaman PNG biçiminde, base64 kodlu JSON nesnesi olarak döndürür. Bağlam uzunluğu32,000 tokens’tır. Model; yüksek hacimli taslak üretimi, hızlı yinelemeli yaratıcı iş akışları ve etkileşimli araçlar için uygundur. Ürün fotoğraflarındaki nesneleri değiştirebilir, şeffaf arka plan oluşturabilir, nesnelerin renk veya malzemesini tüm sahneyi yeniden üretmeden değiştirebilir. Mağaza görselleri, tabelalar ve pazarlama materyallerinde doğru metin oluşturmayı da destekler. En fazla5 stil veya konu referans görseliyle yönlendirmeli varlık üretimi yapılabilir. Referans görseller JPEG veya PNG olmalı ve görsel düzenlemede5 görselle sınırlıdır. Hız karşılığında bir miktar doğruluk kaybını kabul eden model, metin akıl yürütme, araç kullanımı veya web araması sunmaz; görsel üretim ve düzenlemeyle sınırlıdır.
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.
Hangi girdileri destekler?
Metin ve görsel girdilerini destekler. Görsel düzenlemede referans görseller JPEG veya PNG olmalıdır.
Bağlam ve çıktı sınırı nedir?
Bağlam uzunluğu32,000 tokens’tır. Çıktı her zaman PNG biçiminde, base64 kodlu JSON nesnesi olarak döndürülür.
Hangi görevler için uygundur?
Yüksek hacimli görsel üretimi, ürün fotoğrafı temizleme, nesne değiştirme, tasarım yineleme ve referans yönlendirmeli varlık üretimi için uygundur.
Kaç referans görseli kullanılabilir?
Stil veya konu yönlendirmesi için en fazla5 referans görseli kullanılabilir.
Modelin temel sınırlaması nedir?
Görsel üretim ve düzenlemeyle sınırlıdır; metin akıl yürütme, araç kullanımı ve web araması içermez. Hız için bir miktar doğruluktan ödün verir.