Nasazení a používání modelů imagí MAI v Microsoft Foundry (Preview)

Obrazové modely MAI jsou řadou obrazových modelů vyvinutých společností Microsoft AI, které nabízejí špičkové generování obrázků z textu a u některých modelů také úpravy obrázků na základě jiných obrázků. Tyto modely jsou nabízeny jako součást Microsoft Foundry Models prodaného Azure a poskytují zabezpečený přístup na podnikové úrovni prostřednictvím Microsoft Foundry.

V tomto článku se naučíte:

  • Nasazení modelů imagí MAI v Microsoft Foundry
  • Ověřování pomocí Microsoft Entra ID nebo klíčů rozhraní API
  • Generování imagí pomocí rozhraní API pro generování imagí MAI
  • Spuštění úprav obrázku pomocí rozhraní API pro úpravy obrázků MAI

Předpoklady

  • Předplatné Azure s platným způsobem platby. Pokud nemáte předplatné Azure, vytvořte si placený účet Azure.
  • Přístup k Microsoft Foundry s příslušnými oprávněními pro vytváření a správu prostředků.
  • Projekt Microsoft Foundry. Modely imagí MAI jsou k dispozici pro globální standardní nasazení v oblastech USA – středozápad, USA – východ, USA – západ, Západní Evropa, Švédsko – střed, Indie – jih a Spojené arabské emiráty – sever.
  • Role přispěvatele služby Cognitive Services na prostředku Azure AI Foundry pro nasazení modelů. Další informace najdete v tématu Role RBAC v Azure.

Modely obrázků MAI na první pohled

Modely obrázků MAI v Microsoft Foundry zahrnují:

Název modelu Verze modelu Typ
MAI-Image-2.5-Pro (Preview) 2026-06-19 Generování textu na obrázek
Úpravy obrázku na základě obrázku
MAI-Image-2.5-Flash (Preview) 2026-06-02 Generování textu na obrázek
Úpravy obrázku na základě obrázku
MAI-Image-2.5 (Preview) 2026-06-02 Generování textu na obrázek
Úpravy obrázku na základě obrázku
MAI-Image-2e (Preview) 2026-04-09 Generování textu na obrázek
MAI-Image-2 (Preview) 2026-02-20 Generování textu na obrázek

Další informace o jednotlivých modelech najdete v tématu Funkce modelu obrázků MAI.

Nasaďte obrazové modely MAI

Pokud chcete nasadit model image MAI, postupujte podle pokynů v Deploy Microsoft Foundry Models na portálu Foundry.

Případně můžete model nasadit pomocí Azure CLI. Následující kód ukazuje nasazení MAI-Image-2.5. Chcete-li nasadit jiný model, nahraďte název modelu a verzi v řádcích --model-name MAI-Image-2.5 a --model-version 2026-06-02 hodnotami pro požadovaný model.

Nahraďte <ACCOUNT_NAME>, <RESOURCE_GROUP> a <DEPLOYMENT_NAME> svými hodnotami.

az cognitiveservices account deployment create \
  --name <ACCOUNT_NAME> \
  --resource-group <RESOURCE_GROUP> \
  --deployment-name <DEPLOYMENT_NAME> \
  --model-name "MAI-Image-2.5" \
  --model-format Microsoft \
  --model-version 2026-06-02 \
  --sku-name GlobalStandard \
  --sku-capacity 1

Referenční informace:az cognitiveservices account deployment create

Pokud chcete vypsat všechna dostupná nasazení na vašem prostředku:

az cognitiveservices account deployment list \ 
  --resource-group <RESOURCE_GROUP> \ 
  --name <ACCOUNT_NAME> \ 
  -o table

Referenční informace:az cognitiveservices account deployment list

Po nasazení použijte dětské hřiště Foundry k interaktivnímu otestování modelu.

Spustit generování obrázku z textu

Modely obrázků MAI můžou generovat vysoce kvalitní obrázky z výzev přirozeného jazyka, které uživatelům umožňují překládat textové popisy do vizuálně koherentních výstupů vhodných pro širokou škálu kreativních a designových případů použití.

Následující příklad ukazuje, jak vygenerovat obrázek z textového zadání pomocí modelu MAI pro generování obrázků s rozhraním API MAI pro generování obrázků.

Použijte ověřování pomocí klíče API

  1. Nainstalujte knihovnu requests :

    pip install requests

  2. Nastavení proměnných prostředí:

    export AZURE_ENDPOINT="https://<resource-name>.services.ai.azure.com"
export AZURE_API_KEY="<your-api-key>"
export DEPLOYMENT_NAME="<your-deployment-name>"

  3. Spusťte následující kód:

    import os
import base64
import requests

endpoint = os.environ["AZURE_ENDPOINT"]
api_key = os.environ["AZURE_API_KEY"]
deployment_name = os.environ["DEPLOYMENT_NAME"]

width = 1024
height = 1024

url = f"{endpoint}/mai/v1/images/generations"

payload = {
    "model": deployment_name,
    "prompt": "A photorealistic concept art poster of a university at sunset, cinematic lighting",
    "width": width,
    "height": height
}

response = requests.post(
    url,
    headers={
        "Content-Type": "application/json",
        "api-key": api_key,
    },
    json=payload,
)
response.raise_for_status()

result = response.json()
print(result)

image_data = [
    output
    for output in result.get("data", [])
    if "b64_json" in output
]

if image_data:
    image_base64 = image_data[0]["b64_json"]
    output_path = "output.png"
    with open(output_path, "wb") as f:
        f.write(base64.b64decode(image_base64))
    print(f"Image saved to {output_path}")
else:
    print("Unexpected response format:", result)

    Očekávaný výstup: Odpověď JSON obsahující vygenerovaná data obrázku ve formátu base64 Obrázek se dekóduje a uloží jako output.png v aktuálním adresáři.

Použijte ověřování Microsoft Entra ID

Pokud chcete místo klíče rozhraní API použít Microsoft Entra ID, nahraďte hlavičku api-key nosným tokenem získaným pomocí DefaultAzureCredential:

  1. Nainstalujte knihovnu identit Azure:

    pip install azure-identity

  2. Aktualizujte hlavičky požadavku v ověřovacím kódu klíče rozhraní API:

    from azure.identity import DefaultAzureCredential, get_bearer_token_provider

token_provider = get_bearer_token_provider(
    DefaultAzureCredential(), "https://cognitiveservices.azure.com/.default"
)
token = token_provider()

headers = {
    "Content-Type": "application/json",
    "Authorization": f"Bearer {token}",
}

    Reference:DefaultAzureCredential

Spusťte úpravu obrázku podle obrázku

Některé obrazové modely MAI podporují přesné a kontrolovatelné úpravy existujících obrázků, včetně odstraňování objektů, jejich nahrazování, změn atributů, doplnění chybějících částí obrazu, úprav textu a čištění artefaktů při zachování kompozice a rozvržení. Seznam modelů podporujících úpravy obrázku na základě obrázku najdete v článku Modely obrázků MAI v kostce.

Následující příklad ukazuje, jak provést úpravu obrázku na obrázek pomocí modelu obrázku MAI s rozhraním API pro úpravy obrázků MAI.

Note

Pro požadavky na úpravy z obrázku na obrázek se používá multipart form-data.

Použijte ověřování pomocí klíče API

  1. Nainstalujte knihovnu requests :

    pip install requests

  2. Nastavení proměnných prostředí:

    export AZURE_ENDPOINT="https://<resource-name>.services.ai.azure.com"
export AZURE_API_KEY="<your-api-key>"
export DEPLOYMENT_NAME="<your-deployment-name>"

  3. Spusťte následující kód:

    import os
import base64
import requests

endpoint = os.environ["AZURE_ENDPOINT"]
api_key = os.environ["AZURE_API_KEY"]
deployment_name = os.environ["DEPLOYMENT_NAME"]

width = 1024
height = 1024

url = f"{endpoint}/mai/v1/images/edits"

# Replace the file name and type.
reference_image = <path_to_your_image.png>
image_type = "image/png" # or "image/jpeg" based on format of your image. 

files = [
    ("image", (reference_image, open(reference_image, "rb"), image_type))
]

payload={
    "model": deployment_name,
    "prompt": "Turn this image into a clean futuristic product shot with studio lighting",
}

response = requests.post(
    url,
    headers={
        "api-key": api_key,
    },
    data=payload,
    files=files
)

response.raise_for_status()

result = response.json()
print(result)


image_data = [
    output
    for output in result.get("data", [])
    if "b64_json" in output
]

if image_data:
    image_base64 = image_data[0]["b64_json"]
    output_path = "output.png"
    with open(output_path, "wb") as f:
        f.write(base64.b64decode(image_base64))
    print(f"Image saved to {output_path}")
else:
    print("Unexpected response format:", result)

    Očekávaný výstup: Odpověď JSON obsahující upravená data obrázku ve formátu base64 Obrázek se dekóduje a uloží jako output.png v aktuálním adresáři.

Pokud chcete místo klíče rozhraní API použít Microsoft Entra ID, upravte tento kód, jak je popsáno v předchozí části: Používat ověřování Microsoft Entra ID.

Možnosti modelu obrázků MAI

Foundry podporuje použití modelů MAI-Image-2.5-Pro (Preview), MAI-Image-2.5-Flash (Preview), MAI-Image-2.5 (Preview), MAI-Image-2 (Preview) a MAI-Image-2e (Preview). Každý z těchto modelů je vhodný pro následující klíčové případy použití:

  • Generování textu na obrázek: Generovat vysoce kvalitní obrázky z výzev přirozeného jazyka, které uživatelům umožňují překládat textové popisy do vizuálně koherentních výstupů vhodných pro širokou škálu kreativních a designových případů použití.
  • Fotorealistická syntéza obrázků: Dokáže generovat realistický obraz s konzistentní vizuální strukturou, takže je vhodný pro scénáře vizualizace konceptu a vytváření obsahu.
  • Produkt, branding a komerční design: Vhodné pro obrázky produktů, marketingové vizuály, prvky značky a kreativní pracovní postupy v komerční sféře.

MAI-Image-2.5-Pro (Preview), MAI-Image-2.5-Flash (Preview) a MAI-Image-2.5 (Preview) v těchto klíčových případech použití dále excelují:

  • Úpravy obrazu na základě obrazu: Podpora přesných a řízených úprav existujících obrázků, včetně odstraňování objektů, jejich nahrazování, změn atributů, doplnění chybějících částí obrazu, úprav textu a čištění artefaktů při zachování kompozice a rozvržení.
  • Vysoce věrné portréty: Vygenerujte výrazné, přirozeně vypadající portréty s přesnou strukturou obličeje, osvětlením a texturou.
  • Přesné vykreslování textu: Vylepšené vykreslování textu ve vygenerovaných obrázcích, včetně popisků, plakátů, balení a označení
  • Vizuální uvažování: Uvažuje v souvislostech mezi objekty, strukturou scény, osvětlením, měřítkem a prostorovým uspořádáním, aby vytvářel konzistentní výstupy i z nejednoznačných zadání.

Další podrobnosti o schopnostech modelu najdete v tématu Schopnosti modelů Microsoftu v Foundry Models prodávané prostřednictvím Azure.

MAI-Image-2.5-Pro (Preview)

MAI-Image-2.5-Pro (Preview) je model pro úpravy textu na obrázek a model pro úpravy obrázků na obrázek navržený tak, aby vytvářel vysoce kvalitní a vizuálně bohaté obrázky z výzev přirozeného jazyka a prováděl přesné a ovladatelné úpravy existujících obrázků. Používá difúzní generativní přístup k progresivnímu zpřesnění obrázků, což umožňuje silné zarovnání mezi vstupním textem a vygenerovaným výstupem. Model vyniká zachováním konzistence a realismu napříč složitými složeními:

  • Konzistence objektů napříč složitými scénami: Objekty uchovávají stejnou identitu, materiály, proporce, označení a orientaci v celé vizuálně zhuštěné skladbě.
  • Konzistence znaků napříč zobrazeními a momenty: Osoba nebo postava zůstává rozpoznatelně stejná napříč pozicemi, úhly kamery, výrazy, oděvy a světelnými podmínkami.
  • Přesnost materiálu a fyzické vlastnosti: Materiály vypadají a chovají se odlišně na základě jejich reálných vlastností, včetně odrazu, průsvitnosti, váhy, textury a deformace.
  • Prostorové a geometrické důvody: Objekty jsou koherentně umístěny v trojrozměrném prostoru s důvěryhodným měřítkem, perspektivou, okluzí a strukturálními vztahy.

MAI-Image-2.5-Flash (Preview)

MAI-Image-2.5-Flash (Preview) je model pro úpravy textu na obrázek a model pro úpravy obrázků na obrázek navržený tak, aby vytvořil vysoce kvalitní vizuálně bohaté obrázky z výzev přirozeného jazyka a aby na existujících obrázcích prováděl přesné a ovladatelné úpravy. Používá difúzní generativní přístup k progresivnímu zpřesnění obrázků, což umožňuje silné zarovnání mezi vstupním textem a vygenerovaným výstupem. Model je optimalizovaný pro vytváření různorodých a koherentních obrázků napříč širokou škálou kreativních a designových scénářů, takže je vhodný pro úlohy, jako je vizualizace konceptu, generování kreativního obsahu, úpravy obrázků a návrh výroby.

MAI-Image-2.5 (Preview)

MAI-Image-2.5 (Preview) je model pro úpravy textu na obrázek a úpravu obrázků na obrázek navržený tak, aby vytvářel vysoce kvalitní vizuálně bohaté obrázky z výzev přirozeného jazyka a prováděl přesné a ovladatelné úpravy existujících obrázků. Používá difúzní generativní přístup k progresivnímu zpřesnění obrázků, což umožňuje silné zarovnání mezi vstupním textem a vygenerovaným výstupem. Model vyniká přesnými a chirurgickými úpravami s konzistencí – umožňuje uživatelům a vývojářům provádět cílené úpravy objektů, přizpůsobovat rozložení, aktualizovat text, vyčistit artefakty, jako je rozostření pohybu, a zachovat vizuální konzistenci napříč iteracemi.

MAI-Image-2e (Preview)

MAI-Image-2e (Preview) poskytuje vysoce kvalitní generování obrázků, stejně jako MAI-Image-2, ale až 22% rychlejší a čtyřikrát efektivnější než MAI-Image-2, takže je inteligentní volbou pro vývojáře, kteří vytvářejí ve velkém měřítku. MAI-Image-2e je nejvhodnější pro scénáře s velkým objemem a rychlým obratem, například produktové snímky ve velkém množství, marketingové varianty, značková aktiva nebo jakýkoli pracovní postup, kde jsou klíčové efektivita a náklady na obrázek.

MAI-Image-2 (Preview)

MAI-Image-2 (Preview) je model generování textu na obrázek navržený tak, aby vytvářel vysoce kvalitní a vizuálně bohaté obrázky z výzev přirozeného jazyka. Používá difúzní generativní přístup k progresivnímu zpřesnění obrázků, což umožňuje silné zarovnání mezi vstupním textem a vygenerovaným výstupem. Model je optimalizovaný tak, aby vytvářel různorodé a koherentní obrázky v široké škále kreativních a designových scénářů, takže je vhodný pro úlohy, jako je vizualizace konceptu, generování kreativního obsahu a pracovní postupy návrhu obrázků.

Další podrobnosti o schopnostech modelu najdete v tématu Schopnosti modelů Microsoftu v Foundry Models prodávané prostřednictvím Azure.

Koncové body rozhraní API

Po nasazení modelu MAI pro obrázky použijte rozhraní API MAI pro generování obrázků ke generování obrázků a rozhraní API MAI pro úpravy obrázků pro úpravy obrázků na základě jiných obrázků.

  • Koncový bod rozhraní API pro generování obrázků: Koncový bod spravovaný společností Microsoft, který přijímá textový příkaz a vrací obrázek ve formátu PNG. Koncový bod rozhraní API má následující formulář:

    https://<resource-name>.services.ai.azure.com/mai/v1/images/generations

  • Image upravuje koncový bod rozhraní API: Koncový bod spravovaný Microsoft, který přijímá obrázek JPEG nebo PNG a vrací obrázek PNG. Koncový bod rozhraní API má následující formulář:

    https://<resource-name>.services.ai.azure.com/mai/v1/images/edits

K ověření potřebujete koncový bod prostředku a token ID Microsoftu Entra nebo klíč rozhraní API. Tyto hodnoty najdete v části Klíče a koncový bod vašeho prostředku na webu Azure Portal nebo na stránce s podrobnostmi o nasazení na portálu Foundry.

Parametry požadavku

Následující tabulka uvádí parametry požadavku pro rozhraní API pro image:

Parameter API Typ Description
model Oboje řetězec Název nasazení, který jste přiřadili při nasazení modelu.
prompt Oboje řetězec Textová výzva, která popisuje obrázek k vygenerování nebo úpravám, které chcete vytvořit.
Maximální délka kontextu: 32 000 tokenů.
image Úpravy obrázků řetězec Cesta k obrázku, který chcete upravit. Obrázek se předává jako data formuláře s více částmi. Musí být ve formátu JPEG nebo PNG.
width Generace obrázků integer Šířka výstupního obrázku v pixelech
Minimálně: 768. Součin width × height nesmí překročit 1 048 576.
height Generace obrázků integer Výška výstupního obrázku v pixelech
Minimálně: 768. Součin width × height nesmí překročit 1 048 576.

Note

Výstupní formát je vždy PNG. Maximální celkový počet pixelů je 1 048 576 (ekvivalent 1024×1024). Obě width a height musí mít alespoň 768 pixelů. Obě rozměry můžou překročit 1024, pokud celkový počet pixelů zůstane v rámci limitu.

Kvóty a omezení rozhraní API

Modely imagí MAI mají následující omezení rychlosti měřená v požadavcích za minutu (RPM). Dostupná úroveň závisí na konfiguraci předplatného a nasazení.

Typ nasazení Tier MAI-Image-2.5-Pro
(RPM)		 MAI-Image-2.5-Flash
(RPM)		 MAI-Image-2.5
(RPM)		 MAI-Image-2e
(RPM)		 MAI-Image-2
(RPM)
Global Standard 0
(Zdarma)		 0 0 0 0 0
Global Standard 1 2 2 2 18 9
Global Standard 2 4 4 4 30 15
Global Standard 3 6 6 6 60 30
Global Standard 4 8 8 8 90 45
Global Standard 5 10 10 10 120 60
Global Standard 6 12 12 12 180 90

Pokud chcete požádat o navýšení kvóty, odešlete formulář žádosti o navýšení kvóty. Žádosti se zpracovávají v pořadí, v jakém jsou přijaty, a priorita přechází na zákazníky, kteří aktivně používají své stávající přidělení kvót.

Troubleshoot

Při řešení běžných chyb při práci s modely imagí MAI použijte následující tabulku:

Error Příčina Opravit
401 Unauthorized Neplatný klíč rozhraní API nebo token s vypršenou platností Znovu vygenerujte klíč na portálu Azure. Při ověřování pomocí Entra ID se ujistěte, že obor tokenu je https://cognitiveservices.azure.com/.default.
404 Not Found Nesprávný název nasazení nebo adresa URL koncového bodu V části Nasazení ověřte název nasazení a koncový bod na portálu Foundry.
400 Bad Request width nebo height nižší než minimální nebo celkový počet pixelů překračuje maximum Ujistěte se, že width a height jsou oba alespoň 768 a že width × height ≤ 1 048 576.
429 Too Many Requests Překročení limitu rychlosti Počkejte a zkuste to znovu nebo požádejte o navýšení kvóty.

Zodpovědné úvahy o AI

Při používání modelů obrázků MAI ve Foundry zvažte tyto zodpovědné postupy umělé inteligence:

  • Mějte na paměti známá omezení: Navzdory technickým omezením rizik, jako jsou filtrování dat a klasifikátory obsahu použité na úrovni systému, můžou modely generování obrázků vytvářet škodlivé nebo neočekávané obsahy na základě uživatelských požadavků. Mezi běžné rizikové oblasti patří násilné nebo krvavé obsah, sexuální obsah nebo nahota, znázornění veřejných osobností a replikace ochranné známky nebo jiného chráněného materiálu.
  • Konfigurovat bezpečnost obsahu: Zavedte další opatření vhodná pro váš konkrétní případ použití, protože žádný generativní model není imunní vůči adversárním podnětům.
  • Dodržování platných podmínek: Zajistěte, aby vaše používání generovaných obrázků odpovídalo podmínkám služeb společnosti Microsoft a platným zákonům o autorských právech a duševním vlastnictví.
  • Buďte transparentní: Uveďte, že je obsah generován umělou inteligencí při sdílení nebo publikování obrázků.
  • Vyhněte se škodlivému obsahu: Nevygenerujte obsah, který by mohl být škodlivý, zavádějící nebo v rozporu s ochranou osobních údajů.

Související obsah

  • Last updated on