Microsoft AI: MAI-Image-2.5 Pro
Microsoft AI MAI-Image-2.5 Pro genererer og redigerer detaljerte bilder for hovedillustrasjoner, produktkomposisjoner og presis tekst i bildet. Pro-utgaven legger vekt på konsistente objekter, karakterer, materialer og romlige forhold i tette scener og bruker tekst og visuelle referanser til å produsere et PNG-bilde.
Om modellen
Denne beskrivelsen dekker modellens funksjoner. Tilgjengelige inndata, utdata og alternativer i Ailoot er oppført nedenfor for den valgte metoden.
Microsoft AI MAI-Image-2.5 Pro er den detaljtro utgaven i bildeserien 2.5. Den genererer bilder fra beskrivelser i naturlig språk og utfører målrettede redigeringer av eksisterende materiale. Microsoft angir hovedbilder, detaljert redigering og presis tekst i bildet som sentrale bruksområder, og modellsammenligningen fremhever konsistens i objekter, karakterer, materialer og romlige forhold i komplekse komposisjoner. Sluttresultatet er et bilde for en design- eller produksjonsarbeidsflyt, som et viktig produktbilde eller en nøye arrangert redaksjonell scene.
For generering beskriver du komposisjonen gjennom sammenhenger fremfor en liste over urelaterte objekter. Angi hovedmotivet, størrelsen i forhold til gjenstander i nærheten, materialene som inngår og lysretningen. Pro-utgavens dokumenterte visuelle resonnering er nyttig der disse sammenhengene avgjør om en tett scene er troverdig. For en produktkomposisjon kan du plassere en keramikkmugge, klare glass og en brettet duk på et trebord, med konsistente refleksjoner og ett vinduslys. Vurder kontaktpunktene, skyggene og de synlige materialegenskapene i resultatbildet.
For produkt- og karakterarbeid sender du inn den visuelle identiteten som må overleve redigeringen. Microsoft beskriver objektkonsistens gjennom komplekse scener og karakterkonsistens på tvers av synsvinkler og øyeblikk som Pro-styrker. Angi hvilke trekk som identifiserer varen eller personen, og hvilket aspekt ved scenen som skal endres. Behold for eksempel en jakkes silhuett og lukkedetaljer mens karakteren plasseres mot en annen bakgrunn. En nyttig gjennomgang sammenligner disse bevarte detaljene med kildereferansen; et visuelt tiltalende resultat er ikke i seg selv bevis på nøyaktig samsvar.
Produsentens bilderedigeringsgrensesnitt godtar opptil fem JPEG- eller PNG-referanser. Skill rollene i beskrivelsen: produktet, personen, omgivelsene eller det visuelle uttrykket. Redigeringsoppgaver omfatter fjerning og utskifting av objekter, egenskapsendringer, utfylling av bildeområder, layouttilpasning, tekstoppdateringer og fjerning av artefakter. For en lokal redigering beskriver du målet og elementene rundt som skal bevares. For en mer omfattende omorganisering forklarer du hvordan komposisjonen skal fungere etter endringen, slik at modellen har et sammenhengende romlig mål.
Tekstgjengivelse er særlig relevant for en hovedkomposisjon eller et emballasjekonsept. Oppgi den nøyaktige frasen, plasseringen og forholdet til objektet eller bildet. Hold gjentatte navn og etikettekst konsistente mellom beskrivelsen og referansene. Undersøk hvert gjengitt tegn i den tiltenkte visningsstørrelsen, og sammenlign det med den innsendte ordlyden. En senere redigering kan rette seg mot ordlyden eller plasseringen samtidig som den vellykkede produktkomposisjonen beholdes. PNG-resultatet kan deretter innarbeides i layouten der de endelige kravene til typografi og utsnitt er kjent.
Den nåværende Microsoft-bildeveiledningen bruker et maksimalt utdataareal på 1 048 576 piksler for 2.5-modellene, tilsvarende 1024×1024. Begge dimensjoner må være minst 768 piksler i dette grensesnittet, og en lengre side er tillatt når det samlede arealet holder seg innenfor grensen. Dette tillater rektangulære komposisjoner som 1344×768, som totalt er 1 032 192 piksler. Denne arealbegrensningen er noe annet enn maksimalt 1024 på hver side. Klargjør målformatet for komposisjonen, fremfor å forvente at en generell sideforholdsbetegnelse bestemmer utsnittet riktig.
Veiledningen for drift angir en maksimal promptkontekst på 32 000 token og returnerer PNG-bildedata for både generering og redigering. Den spesifikke Pro-katalogsiden oppgir separat et kontekstvindu på 131.072K og 4 096 utdata-token. Dette er publiserte tokenmengder med egne katalog- eller driftsvirkeområder; den praktiske klargjøringen av bildeforespørsler følger prompt- og pikselgrensene i drift. Behold bildet, kildereferansene og beskrivelsen som ett revisjonsgrunnlag. Kontroller selve det visuelle resultatet for de detaljerte kravene til identitet, materiale og geometri som begrunnet valget av Pro.
Versjonsvalget bør følge komposisjonen. Standardutgaven MAI-Image-2.5 dekker generell generering og lokale redigeringer; Pro legger til seriens vektlegging av detaljtrohet og konsistente sammenhenger i visuelt tette scener. 2.6-familien øker den dokumenterte grensen for utdataareal og legger til valgfri nettforankring og automatisk valg av sideforhold. Disse senere kontrollene gjelder spesifikt for 2.6 og definerer ikke arbeidsflyten i denne Pro-utgaven. Velg Pro når den vanskelige delen av beskrivelsen gjelder stabil objektidentitet, materialutseende eller romlig struktur i et detaljert bilde.
Vurder både den ønskede endringen og innholdet som skal beholdes. Hender som holder objekter, skjæringspunkter, liten skrift, ansiktslikhet og refleksjoner er nyttige steder å undersøke i en kompleks komposisjon. Et plausibelt bilde kan fortsatt inneholde villedende merking eller et feil fysisk forhold. Gjør neste korrigering konkret, og bevar delene av beskrivelsen som ga ønsket layout. Dette støtter en kontrollert rekke designrevisjoner fremfor gjentatt omdefinering av hele scenen.
Ailoot Ultra · Bilder 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 detaljerte bilder for hovedillustrasjoner, produktkomposisjoner og presis tekst i bildet. Pro-utgaven legger vekt på konsistente objekter, karakterer, materialer og romlige forhold i tette scener og bruker tekst og visuelle referanser til å produsere et PNG-bilde.
- Godkjente inndata
- Tekst · Bilder
- Resultater
- Bilder
Tilgjengelig i Ailoot · inndata & metoder
Ailoot Ultra · Bilder POST /v1/images/generations
- Inndatatyper
text,image- Utdatatyper
image
| Felt | Type | Krav | Verdier & grenser | Standard |
|---|---|---|---|---|
Feltmodel | Typestring | KravPåkrevd | Verdier & grenser microsoft/mai-image-2.5-pro | Standard— |
Feltprompt | Typestring | KravPåkrevd | Verdier & grenser Minste lengde: 1 | Standard— |
Feltaspect_ratio | Typestring | KravValgfritt | Verdier & grenser 1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3, auto | Standard— |
Feltn | Typeinteger | KravValgfritt | Verdier & grenser Minimum: 1 Maksimum: 1 | Standard— |
Feltinput_references | Typearray | KravValgfritt | Verdier & grenser Minste antall elementer: 0 Maksimalt antall elementer: 1 | Standard— |
Feltprovider | Typeobject | KravValgfritt | Verdier & grenser | Standard— |
Metodeparametere og livssyklus
| Parameter | Avtale |
|---|---|
Parametercontent_type | Avtaleapplication/json |
Parameterrequired | Avtalemodel, prompt |
Parametermaterial_types | Avtaletext, image |
Livssyklus: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · faktisk returnert task_id eller oppføring i mediebiblioteket
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Priser
Slik beregnes det endelige beløpet
De viste satsene anslår kostnaden før generering. Det endelige beløpet beregnes ut fra kostnaden som er registrert for den opprinnelige genereringen. Målt varighet på utdataene og anslåtte mengder er ikke den endelige fakturerbare mengden.
Tariffopplysninger legger ikke til forespørselsvalg. Støttede parametere står ved den valgte metoden.
- Hurtigmodus
- Ikke angitt Når hurtigmodus er valgt
- Flex-modus
- Ikke angitt Når flex-modus er valgt
- Maksimal resonneringsinnsats
- Ikke angitt Når justeringen «default» brukes for maksimal resonneringsinnsats
Estimerte satser for sammenligning
Priser etter konfigurasjon
Knytt hver kostnad til de viste vilkårene. Bruk én sats for hvert sett med alternative konfigurasjoner.
| Konfigurasjon | Prisplan | Forventet mengde | Kostnad |
|---|---|---|---|
| KonfigurasjonGrunnpriser for tokener | PrisplanGrunnsats | Forventet mengde— | Kostnad Inndata · Inngående tokener · Estimat kun for sammenligning — / 1K tokener Utdata · Utgående tokener · Estimat kun for sammenligning — / 1K tokener Inndata · Lesing fra hurtigbuffer · Estimat kun for sammenligning — / 1K tokener Inndata · Skriving til hurtigbuffer · Estimat kun for sammenligning — / 1K tokener Inndata · Skriving til hurtigbuffer, 1 time · Estimat kun for sammenligning — / 1K tokener |
| KonfigurasjonAnslått genereringskostnad | Prisplan— | Forventet mengdeestimat for én generering | Kostnad Utdata · Anslått genereringskostnad · Estimat kun for sammenligning $0.884736 estimat før generering Dette anslaget er verken en tilleggsavgift eller en fast sats for den fullførte genereringen. |
Ailoot reserverer et estimert beløp før en forespørsel. Etter resultatet gjøres det endelige beløpet opp basert på målt forbruk. Oppgjør for strømming bruker den endelige forbruksposten. Slik fungerer reservasjon og oppgjør →
Eksempelforespørsler
Ailoot Ultra · Bilder
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
Motta og lagre resultater
Ailoot Ultra · Bilder
Last ned hvert returnerte bilde eller lagre Base64-innholdet
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
Andre innholdslesinger
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 ferdige resultater
Lagre hvert ferdige bilde; hent hver returnerte URL eller dekod Base64-innholdet.
Bevar hele svaret og svarhodene, alle faktiske utdata, de opprinnelige returnerte identifikatorene og alle bruksfeltene. Hent den opprinnelige operasjonen igjen uten å sende opprettelsesforespørselen på nytt.
Hvis det opprinnelige svaret må kontrolleres
Bevar returnert X-Client-Request-ID for avstemming. Les bare faktisk returnerte task_id/asset_id-verdier eller egne oppføringer i mediebiblioteket; bygg aldri en oppgave-URL fra operasjons-ID-en, og send aldri opprettelsesforespørselen på nytt.
Svarfelter
| Felt | Type |
|---|---|
Feltcreated | Type |
Feltdata[].url | Type |
Feltdata[].b64_json | Type |
Feltusage | Type |
Aliaser
Modellaliaser
Ailoot Ultra microsoft/mai-image-2.5-pro
Aliaser for metodestier
/v1/images
Tilknyttede anroper-ID-er
FAQ · Microsoft AI: MAI-Image-2.5 Pro
- Hvilke inndata og resultater er tilgjengelige?
POST /v1/images/generations·microsoft/mai-image-2.5-pro:text,image→image- Hvilke felt bruker forespørselen?
POST /v1/images/generations·microsoft/mai-image-2.5-pro:model,prompt,aspect_ratio,n,input_references,provider- Hvilke grenser gjelder?
POST /v1/images/generations·microsoft/mai-image-2.5-pro:n.minimum:1;n.maximum:1