Felo API PlatformFelo API Platform
Modellere dön

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

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

  • Artificial Analysis liderlik tablosu — görsel düzenleme

    Sıralama:7

    7
  • Artificial Analysis liderlik tablosu — metinden görsel üretimi

    Sıralama:11

    11
  • Artificial Analysis — sahne ve stil düzenleme

    Sıralama:3

    3
  • Artificial Analysis — geliştirme ve restorasyon

    Sıralama:4

    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")
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-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.

İlgili modeller