Microsoft AI: MAI-Image-2.5 Pro
Microsoft AI MAI-Image-2.5 Pro genererer og redigerer detaljerede billeder til hovedbilleder, produktkompositioner og præcis tekst inde i billedet. Pro-udgaven lægger vægt på konsistente genstande, figurer, materialer og rumlige relationer i tætte scener og bruger tekst og visuelle referencer til at skabe et PNG-billede.
Om modellen
Denne beskrivelse dækker modellens funktioner. Tilgængelige input, output og indstillinger i Ailoot står nedenfor for den valgte metode.
Microsoft AI MAI-Image-2.5 Pro er den udgave inden for 2.5-billedserien, der fokuserer på gengivelsestrofasthed. Den genererer billeder fra beskrivelser i naturligt sprog og udfører målrettede redigeringer af eksisterende materiale. Microsoft angiver hovedbilleder, detaljeret redigering og præcis tekst inde i billedet som centrale anvendelser, og modelsammenligningen fremhæver konsistens i genstande, figurer, materialer og rumlige relationer i komplekse kompositioner. Det endelige resultat er et billede til en design- eller produktionsarbejdsgang, såsom et centralt produktbillede eller en omhyggeligt arrangeret redaktionel scene.
Til generering skal du beskrive kompositionen gennem relationer frem for en liste af uafhængige genstande. Identificér hovedmotivet, dets størrelse i forhold til nærliggende genstande, de involverede materialer og lysets retning. Pro-udgavens dokumenterede visuelle ræsonnement er nyttigt, hvor disse relationer afgør, om en tæt scene er troværdig. Til en produktkomposition kan du placere en keramisk kande, klare glas og et foldet klæde på et træbord med konsistente refleksioner og lys fra ét vindue. Gennemgå berøringspunkter, skygger og synlige materialeegenskaber i det resulterende billede.
Ved arbejde med produkter og figurer skal du medsende den visuelle identitet, der skal overleve redigeringen. Microsoft beskriver genstandskonsistens på tværs af komplekse scener og figurkonsistens på tværs af synsvinkler og øjeblikke som styrker ved Pro. Angiv, hvilke træk der identificerer genstanden eller personen, og hvilket aspekt af scenen der skal ændres. Bevar for eksempel en jakkes silhuet og lukningsdetaljer, mens figuren placeres i en anden baggrund. En nyttig gennemgang sammenligner disse bevarede detaljer med kildereferencen; et visuelt attraktivt resultat er ikke i sig selv bevis for et præcist match.
Producentens billedredigeringsgrænseflade accepterer op til fem JPEG- eller PNG-referencer. Adskil deres roller i beskrivelsen: produktet, personen, miljøet eller den visuelle behandling. Redigeringsopgaver omfatter fjernelse og udskiftning af genstande, ændring af egenskaber, inpainting, layouttilpasning, tekstopdateringer og oprydning i artefakter. Ved en lokal redigering skal du beskrive målet og de omgivende elementer, der skal bevares. Ved en større omarrangering skal du forklare, hvordan kompositionen skal fungere efter ændringen, så modellen har et sammenhængende rumligt mål.
Tekstgengivelse er særlig relevant i en hovedkomposition eller et emballagekoncept. Angiv den præcise formulering, dens position og dens forhold til genstanden eller billedet. Hold tilbagevendende navne og etikettekst konsekvente mellem beskrivelsen og referencerne. Undersøg hvert gengivet tegn i den tilsigtede visningsstørrelse, og sammenlign det med den medsendte ordlyd. En senere redigering kan fokusere på ordlyd eller placering og samtidig bevare den vellykkede produktkomposition. PNG-outputtet kan derefter indgå i det layout, hvis endelige typografi- og beskæringskrav er kendte.
Den aktuelle Microsoft-billedvejledning anvender et maksimalt outputareal på 1.048.576 pixels for 2.5-modellerne, svarende til 1024×1024. Begge dimensioner skal være mindst 768 pixels i denne grænseflade, og en længere side er tilladt, når det samlede areal holder sig inden for grænsen. Det muliggør rektangulære kompositioner såsom 1344×768, der giver 1.032.192 pixels. Denne arealbegrænsning er forskellig fra højst 1024 på hver side. Forbered målformen til kompositionen frem for at forvente, at en generisk billedformatbetegnelse fastlægger beskæringen korrekt.
Driftsvejledningen angiver en maksimal promptkontekst på 32.000 tokens og returnerer PNG-billeddata til både generering og redigering. Den konkrete Pro-katalogside angiver separat et kontekstvindue på 131.072K og 4.096 outputtokens. Det er offentliggjorte tokenmængder med hvert deres katalog- eller driftsmæssige anvendelsesområde; den praktiske forberedelse af billedanmodningen følger driftens prompt- og pixelgrænser. Gem billedet, kildereferencerne og beskrivelsen som ét revisionsgrundlag. Kontrollér selve det visuelle resultat for de detaljerede krav til identitet, materiale og geometri, som begrundede valget af Pro.
Versionsvalget bør følge kompositionen. Standardudgaven MAI-Image-2.5 dækker generel generering og lokale redigeringer; Pro tilføjer seriens vægt på gengivelsestrofasthed og konsistente relationer i visuelt tætte scener. 2.6-familien hæver den dokumenterede outputarealgrænse og tilføjer valgfri webbaseret kildeforankring og automatisk formatvalg. Disse senere kontroller er specifikke for 2.6 og definerer ikke denne Pro-udgaves arbejdsgang. Vælg Pro, når den vanskelige del af beskrivelsen handler om stabil genstandsidentitet, materialers udseende eller rumlig struktur i et detaljeret billede.
Gennemgå både den ønskede ændring og det bevarede indhold. Hænder, der holder genstande, krydsninger, lille skrift, ansigtslighed og refleksioner er nyttige steder at undersøge i en kompleks komposition. Et plausibelt billede kan stadig indeholde vildledende mærkning eller en forkert fysisk relation. Gør den næste rettelse konkret, og bevar de dele af beskrivelsen, der gav det ønskede layout. Det understøtter en kontrolleret række designrevisioner frem for gentagne gange at omdefinere hele scenen.
Ailoot Ultra · Billeder POST /v1/images/generations microsoft/mai-image-2.5-pro
microsoft/mai-image-2.5-proStart
Microsoft AI MAI-Image-2.5 Pro genererer og redigerer detaljerede billeder til hovedbilleder, produktkompositioner og præcis tekst inde i billedet. Pro-udgaven lægger vægt på konsistente genstande, figurer, materialer og rumlige relationer i tætte scener og bruger tekst og visuelle referencer til at skabe et PNG-billede.
- Accepterede input
- Tekst · Billeder
- Resultater
- Billeder
Tilgængelig i Ailoot · input og metoder
Ailoot Ultra · Billeder POST /v1/images/generations
- Inputtyper
text,image- Outputtyper
image
| Felt | Type | Krav | Værdier og grænser | Standard |
|---|---|---|---|---|
Feltmodel | Typestring | KravPåkrævet | Værdier og grænser microsoft/mai-image-2.5-pro | Standard— |
Feltprompt | Typestring | KravPåkrævet | Værdier og grænser Minimumslængde: 1 | Standard— |
Feltaspect_ratio | Typestring | KravValgfrit | Værdier og grænser 1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3, auto | Standard— |
Feltn | Typeinteger | KravValgfrit | Værdier og grænser Minimum: 1 Maksimum: 1 | Standard— |
Feltinput_references | Typearray | KravValgfrit | Værdier og grænser Minimumsantal elementer: 0 Maksimalt antal elementer: 1 | Standard— |
Feltprovider | Typeobject | KravValgfrit | Værdier og grænser | Standard— |
Metodeparametre og livscyklus
| Parameter | Kontrakt |
|---|---|
Parametercontent_type | Kontraktapplication/json |
Parameterrequired | Kontraktmodel, prompt |
Parametermaterial_types | Kontrakttext, image |
Livscyklus: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · det faktisk returnerede task_id eller posten i mediebiblioteket
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Priser
Sådan beregnes det endelige beløb
De viste satser bruges til at anslå omkostningen før genereringen. Det endelige beløb beregnes ud fra den registrerede omkostning for den oprindelige generering. Den målte varighed af outputtet og de anslåede mængder er ikke den endelige fakturerbare mængde.
Tarifoplysninger tilføjer ikke anmodningsmuligheder. Understøttede parametre står ved den valgte metode.
- Hurtig tilstand
- Ikke angivet Når hurtig tilstand er valgt
- flex-tilstand
- Ikke angivet Når flex-tilstanden er valgt
- Maksimal ræsonneringsindsats
- Ikke angivet Når default-justeringen anvendes ved maksimal ræsonneringsindsats
Estimerede takster til sammenligning
Priser efter konfiguration
Knyt hver omkostning til de viste betingelser. Brug én takst for hver gruppe af alternative konfigurationer.
| Konfiguration | Takstplan | Forventet mængde | Beløb |
|---|---|---|---|
| KonfigurationGrundpriser for tokens | TakstplanGrundtakst | Forventet mængde— | Beløb Input · Inputtokens · Estimat kun til sammenligning — / 1K tokens Output · Outputtokens · Estimat kun til sammenligning — / 1K tokens Input · Cachelæsning · Estimat kun til sammenligning — / 1K tokens Input · Cacheskrivning · Estimat kun til sammenligning — / 1K tokens Input · Cacheskrivning, 1 time · Estimat kun til sammenligning — / 1K tokens |
| KonfigurationAnslået genereringsomkostning | Takstplan— | Forventet mængdeestimat for én generering | Beløb Output · Anslået genereringsomkostning · Estimat kun til sammenligning $0.884736 estimat før generering Dette estimat er hverken et ekstra gebyr eller en fast pris for den færdige generering. |
Ailoot reserverer et estimeret beløb før en anmodning. Efter resultatet afregnes det endelige beløb ud fra det målte forbrug. Ved streaming bruges den endelige forbrugsregistrering til afregningen. Sådan fungerer reservation og afregning →
Eksempelanmodninger
Ailoot Ultra · Billeder
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p={'model': 'microsoft/mai-image-2.5-pro', 'prompt': 'a red panda astronaut floating in space, studio lighting'}
Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/images/generations \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import base64, json, os, subprocess
from pathlib import Path
from urllib.parse import urlsplit, urljoin
def save_images(items):
if not items: raise SystemExit("No completed images; retain the full response")
for index, item in enumerate(items):
encoded=item.get("b64_json")
uri=item.get("url", "")
if not encoded and uri.startswith("data:image/"):
header, separator, encoded=uri.partition(",")
if not separator or ";base64" not in header: raise SystemExit("Unsupported image data URI")
if encoded:
raw=base64.b64decode(encoded,validate=True)
elif uri:
uri=urljoin("https://api.ailoot.ai",uri)
parsed=urlsplit(uri)
if parsed.scheme!="https" or not parsed.netloc or parsed.username or parsed.password:
raise SystemExit("Invalid returned image URL")
owned=parsed.netloc=="api.ailoot.ai" and parsed.path.startswith("/v1/media/assets/") and parsed.path.endswith("/content")
args=["curl","--fail-with-body","--silent","--show-error",uri]
if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]
temporary=Path(f"image-{index}.bin")
subprocess.run(args+["-o",str(temporary)],check=True)
raw=temporary.read_bytes()
temporary.unlink()
else: raise SystemExit("Image has neither bytes nor URL")
if not raw: raise SystemExit("Empty image result")
ext="png" if raw.startswith(b"\x89PNG") else "jpg" if raw.startswith(b"\xff\xd8") else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "svg" if raw.lstrip().startswith((b"<svg",b"<?xml")) else "bin"
Path(f"image-{index}.{ext}").write_bytes(raw)
print("Every returned image saved; complete response metadata retained")
save_images(json.loads(Path("result.json").read_text())["data"])
PY_RESULT
Hent og gem resultater
Ailoot Ultra · Billeder
Hent hvert returneret billede, eller gem dets Base64-indhold
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
Læsning af andet indhold
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/media/assets \
-H "Authorization: Bearer $AILOOT_API_KEY" -o owned-assets.json
# Preserve every returned asset and follow its exact signed content URL. Do not construct a signed token.
Behold alle færdige resultater
Gem hvert færdigt billede; hent hver returneret URL eller afkod dets Base64-indhold.
Gem hele svaret og alle headere, alle faktisk returnerede output, de oprindeligt returnerede identifikatorer og alle felter med forbrugsdata. Gendan den oprindelige operation uden at sende oprettelsesanmodningen igen.
Hvis det oprindelige svar skal kontrolleres
Gem det returnerede X-Client-Request-ID til afstemning. Brug kun faktisk returnerede task_id/asset_id-værdier eller dit eget mediebibliotek til læseanmodninger; opbyg aldrig en opgave-URL ud fra operations-ID’et, og send aldrig oprettelsesanmodningen igen.
Svarfelter
| Felt | Type |
|---|---|
Feltcreated | Type |
Feltdata[].url | Type |
Feltdata[].b64_json | Type |
Feltusage | Type |
Aliaser
Modelaliaser
Ailoot Ultra microsoft/mai-image-2.5-pro
Aliaser for metodestier
/v1/images
Relaterede kalder-ID’er
FAQ · Microsoft AI: MAI-Image-2.5 Pro
- Hvilke input og resultater er tilgængelige?
POST /v1/images/generations·microsoft/mai-image-2.5-pro:text,image→image- Hvilke felter bruger anmodningen?
POST /v1/images/generations·microsoft/mai-image-2.5-pro:model,prompt,aspect_ratio,n,input_references,provider- Hvilke grænser gælder?
POST /v1/images/generations·microsoft/mai-image-2.5-pro:n.minimum:1;n.maximum:1