Source: https://ailoot.ai/models/sl/microsoft-mai-image-2-5/
Canonical: https://ailoot.ai/models/sl/microsoft-mai-image-2-5/
Language: sl

# Microsoft AI: MAI-Image-2.5

[Markdown](https://ailoot.ai/models/sl/microsoft-mai-image-2-5/index.md) · [JSON](https://ailoot.ai/models/sl/microsoft-mai-image-2-5/facts.json)

## [Microsoft AI: MAI-Image-2.5](https://ailoot.ai/models/sl/microsoft-mai-image-2-5/)

Microsoft AI MAI-Image-2.5 ustvarja slike iz besedila in ciljno ureja priložene fotografije ali zasnove. Podpira spremembe predmetov in besedila, odpravljanje artefaktov in ureditve z ohranitvijo obraza, z izhodom PNG in do petimi vizualnimi referencami. Njegova kartica modela določa kontekst 32K in 1.048.576 izhodnih pikslov.

- [**Ailoot Ultra · Slike** `POST /v1/images/generations` `microsoft/mai-image-2.5`](https://ailoot.ai/models/sl/microsoft-mai-image-2-5/#method-0)

O modelu

Ta opis zajema zmožnosti modela. Vhodi, izhodi in možnosti, ki so na voljo v Ailoot, so spodaj navedeni za izbrano metodo.

Microsoft AI MAI-Image-2.5 je različica slikovne družine 2.5 za splošno ustvarjanje in nadzorovano urejanje. Njena kartica modela opisuje difuzijski model z ujemanjem tokov, z 20 milijardami parametrov zunaj vdelav, besedilnim in slikovnim vhodom ter kontekstom 32K žetonov. Ustvarja slikovni izhod za zasnove, portrete, podobe izdelkov, ilustracije in spremembe obstoječih oblikovanj. Koristna začetna izbira je, ali naloga potrebuje novo kompozicijo ali določeno spremembo gradiva, ki že vsebuje načrtovani motiv.

Pri ustvarjanju opišite glavni motiv, vizualni slog, svetlobo, zorni kot in razporeditev. Proizvajalec poudarja podrobne, skladne slike, izris besedila, podobe izdelkov in upoštevanje poziva. Praktičen opis ilustracije za predstavitev lahko določi vlogo motiva, želeni vizualni poudarek in količino okoliškega prostora. Zasnova izdelka lahko vključuje material, merilo in površinsko obdelavo. Opis ohranite skladen, da predmeti delijo en prizor in en načrt osvetlitve, namesto da združujejo več nezdružljivih vizualnih obdelav.

Vizualno sklepanje v tej različici zadeva strukturo prizora, osvetlitev, merilo in prostorska razmerja. Proizvajalec kot uporabo urejanja navaja dodajanje predmeta z ustrezno perspektivo in sencami. Pri ureditvi delavnice ob delovno mizo postavite majhen stolček ter ohranite obstoječi zorni kot in svetlobo. Pregled naj primerja velikost stolčka, njegov stik s tlemi in skladnost njegove sence s sencami drugih predmetov. Lokalno prepričljiv predmet se mora še vedno prilegati geometriji celotne izvorne slike.

Usmerjene ureditve vključujejo odstranjevanje ali zamenjavo predmetov, spremembe lastnosti, zapolnjevanje območij, prilagoditev postavitve, posodobitve besedila in čiščenje, kot je zmanjšanje artefaktov zameglitve gibanja. Priložite izvorno sliko ter poimenujte popravek in podrobnosti za ohranitev. Ciljna ureditev fotografije lahko iz ozadja odstrani moteč predmet in ohrani osebo, izrez ter razporeditev v ospredju. Oblikovalska sprememba lahko posodobi kratko vrstico besedila in ohrani kompozicijo. Celoten rezultat primerjajte z virom, namesto da ocenjujete samo urejeno območje.

Microsoft poudarja tudi doslednost obrazne identitete med ureditvami, vključno s spremembami drže, izraza ali zornega kota. Za podobnost uporabite jasno referenco in želeno spremembo določite tako, da ohrani prepoznavne značilnosti. Proizvajalčev trenutni vodič za urejanje sprejme do pet slik JPEG ali PNG, tako da lahko različne reference določajo osebo, predmet, prizor ali slog. Te vloge poimenujte v pozivu. Pri spremembi portreta pred obravnavo slike kot končne preverite obraz ter spremenjena oblačila ali ozadje.

Natančna kartica modela izhod omejuje na skupno 1.048.576 pikslov, kar ustreza kvadratu 1024×1024, in dovoljuje, da ena stranica preseže 1024, če skupna vrednost ostane znotraj te površine. Vodič strežnega vmesnika dodatno zahteva, da sta obe meri vsaj 768 pikslov. Pravokotni cilj, kot je 1344×768, vsebuje 1.032.192 pikslov in izpolnjuje ta dokumentirana pravila površine ter najmanjših mer. Uporabna omejitev je zmnožek širine in višine, zato obliko cilja pripravite pred zahtevo za ležečo ali pokončno kompozicijo.

Ustvarjanje in urejanje v proizvajalčevem strežnem vmesniku vrneta slikovne podatke PNG. Izvorna kartica modela navaja kontekst 32K žetonov, ta vmesnik pa določa največji kontekst poziva 32.000 žetonov. Ločena kataloška številka 4.096 izhodnih žetonov je količina žetonov, ne izhodna mera. Pri organizaciji podrobnega poziva in končne slike ohranite te navedene obsege. Izvorna gradiva, ohranjene značilnosti, zahtevane ureditve in ciljna velikost so uporaben zapis spremembe ob datoteki PNG.

Ustvarjalni razpon modela zajema fotorealistične in filmske podobe, portrete, zasnove izdelkov ali blagovnih znamk, oblike z besedilom in druge vizualne sloge. Pri etiketi ali znaku podajte točno besedilo in preverite zapis pri končni velikosti prikaza. Prepoznavna fotografska površina lahko še vedno vsebuje izmišljeno podrobnost, neskladen odsev ali netočen napis. Praktičen pregled sledi zahtevam zasnove: pomembni so identiteta predmeta, berljivost, prostorska razmerja in ohranjen prizor. Konkreten popravek ločite od sprememb, ki so že uspele.

V družini 2.5 Pro poudarja višjo zvestobo in stabilna razmerja v gostih prizorih, Flash pa služi odzivnejši produkciji. Družina 2.6 uvaja večjo dokumentirano omejitev površine pikslov, neobvezno spletno navezavo na podatke in izbiro razmerja, ki jo vodi model. Standardni 2.5 ohranja lasten postopek ustvarjanja in urejanja brez teh poznejših možnosti. Različico izberite glede na zahtevni del dejanske slikovne naloge in končni rezultat preglejte glede na ta opis.

**Ailoot Ultra · Slike** `POST /v1/images/generations` `microsoft/mai-image-2.5`

[`microsoft/mai-image-2.5`](https://ailoot.ai/models/sl/#m=microsoft%2Fmai-image-2.5&route=Ultra&caller=microsoft%2Fmai-image-2.5&fmt=images)

Microsoft AI /`microsoft/mai-image-2.5`

### Začetek

Microsoft AI MAI-Image-2.5 ustvarja slike iz besedila in ciljno ureja priložene fotografije ali zasnove. Podpira spremembe predmetov in besedila, odpravljanje artefaktov in ureditve z ohranitvijo obraza, z izhodom PNG in do petimi vizualnimi referencami. Njegova kartica modela določa kontekst 32K in 1.048.576 izhodnih pikslov.

Dovoljeni vhodi

Besedilo · Slike

Rezultati

Slike

### Na voljo v Ailoot · vhodi in metode

**Ailoot Ultra · Slike** `POST /v1/images/generations`

Vhod

`text`, `image`

Izhod

`image`

| Polje | Vrsta | Zahteva | Vrednosti in omejitve | Privzeto |
| --- | --- | --- | --- | --- |
| Polje`model` | Vrsta`string` | ZahtevaObvezno | Vrednosti in omejitve microsoft/mai-image-2.5 | Privzeto— |
| Polje`prompt` | Vrsta`string` | ZahtevaObvezno | Vrednosti in omejitve Najmanjša dolžina: 1 | Privzeto— |
| Polje`aspect_ratio` | Vrsta`string` | ZahtevaIzbirno | Vrednosti in omejitve 1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3, auto | Privzeto— |
| Polje`n` | Vrsta`integer` | ZahtevaIzbirno | Vrednosti in omejitve Najmanj: 1 Največ: 1 | Privzeto— |
| Polje`input_references` | Vrsta`array` | ZahtevaIzbirno | Vrednosti in omejitve Najmanjše število elementov: 0 Največ elementov: 1 | Privzeto— |
| Polje`provider` | Vrsta`object` | ZahtevaIzbirno | Vrednosti in omejitve | Privzeto— |

Parametri in življenjski cikel metode

| Parameter | Specifikacija |
| --- | --- |
| Parameter`content_type` | Specifikacijaapplication/json |
| Parameter`required` | Specifikacijamodel, prompt |
| Parameter`material_types` | Specifikacijatext, image |

Življenjski cikel: `synchronous_result_then_owned_library`

`GET /v1/media/tasks/{task_id}` · Dejansko vrnjeni task\_id ali zapis v medijski knjižnici

`GET /v1/media/assets/{asset_id}/content`

`GET /v1/media/assets`

`GET /v1/media/assets/{asset_id}`

### Cenik

##### Kako se izračuna končni strošek

Prikazane cene so namenjene oceni stroškov pred generiranjem. Končni znesek se izračuna na podlagi stroška, zabeleženega za izvirno generiranje. Izmerjeno trajanje izhoda in napovedane količine niso končna obračunska količina.

Tarifni podatki ne dodajajo možnosti zahteve. Podprti parametri so navedeni pri izbrani metodi.

Hitri način

Ni navedeno Ko je izbran hitri način

Način flex

Ni navedeno Ko je izbran način flex

Najvišja raven razmišljanja

Ni navedeno Ko najvišja raven razmišljanja uporablja privzeto prilagoditev (default)

#### Ocenjene cene za primerjavo

#### Cene po nastavitvah

Vsak strošek povežite s prikazanimi pogoji. Za vsak nabor alternativnih nastavitev uporabite eno ceno.

| Nastavitev | Cenovna lestvica | Predvidena količina | Strošek |
| --- | --- | --- | --- |
| NastavitevOsnovne cene žetonov | Cenovna lestvicaOsnovna cena | Predvidena količina— | Strošek Vhod · Vhodni žetoni · Ocena samo za primerjavo **—** / 1K žetonov Izhod · Izhodni žetoni · Ocena samo za primerjavo **—** / 1K žetonov Vhod · Branje predpomnilnika · Ocena samo za primerjavo **—** / 1K žetonov Vhod · Zapis v predpomnilnik · Ocena samo za primerjavo **—** / 1K žetonov Vhod · Zapis v predpomnilnik, 1 ura · Ocena samo za primerjavo **—** / 1K žetonov |
| NastavitevOcenjeni strošek ustvarjanja | Cenovna lestvica— | Predvidena količinaocena za eno generiranje | Strošek Izhod · Ocenjeni stroški ustvarjanja · Ocena samo za primerjavo **$0.385024** ocena pred ustvarjanjem Ta ocena ni dodatno plačilo ali fiksna cena za dokončano generiranje. |

Ailoot pred zahtevo rezervira ocenjeni znesek. Po rezultatu obračuna končni strošek na podlagi izmerjene porabe. Obračun pretakanja uporablja končni zapis porabe. [Kako delujeta rezervacija in obračun →](https://ailoot.ai/docs/sl/billing/reserve/)

### Primeri zahtev

#### Ailoot Ultra · Slike

curl

```bash
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', '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
```

### Prejmi in shrani rezultate

#### Ailoot Ultra · Slike

Prenesite vsako vrnjeno sliko ali shranite njeno vsebino Base64

- `GET /v1/media/tasks/{task_id}`
- `GET /v1/media/assets/{asset_id}/content`
- `GET /v1/media/assets`
- `GET /v1/media/assets/{asset_id}`

Branje druge vsebine

Preberi obstoječa gradiva, ki vam pripadajo

```bash
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.
```

##### Ohrani vse dokončane rezultate

Shranite vsako dokončano sliko; pridobite vsebino z vsake vrnjene URL ali dekodirajte njeno vsebino Base64.

Shranite celoten odgovor in glave, vse dejanske izhode, izvirne vrnjene identifikatorje in vsa polja s podatki o porabi. Pridobite podatke izvirne operacije brez ponovnega pošiljanja zahteve za ustvarjanje.

##### Če je treba preveriti izvirni odgovor

Shranite vrnjeni X-Client-Request-ID za uskladitev evidenc. Berite samo dejansko vrnjene vrednosti task\_id/asset\_id ali svojo medijsko knjižnico; iz ID operacije nikoli ne sestavite URL opravila in zahteve za ustvarjanje nikoli ne pošljite znova.

Polja odgovora

| Polje | Vrsta |
| --- | --- |
| Polje`created` | Vrsta |
| Polje`data[].url` | Vrsta |
| Polje`data[].b64_json` | Vrsta |
| Polje`usage` | Vrsta |

### Druga imena

#### Druga imena modelov

**Ailoot Ultra** [`microsoft/mai-image-2.5`](https://ailoot.ai/models/sl/#m=microsoft%2Fmai-image-2.5&route=Ultra&caller=microsoft%2Fmai-image-2.5&fmt=images)

#### Druga imena poti metod

`/v1/images`

#### Povezani ID-ji za klic

[`microsoft/mai-image-2.5`](https://ailoot.ai/models/sl/#m=microsoft%2Fmai-image-2.5&route=Ultra&caller=microsoft%2Fmai-image-2.5&fmt=images)

FAQ · Microsoft AI: MAI-Image-2.5

Kateri vhodi in rezultati so na voljo?

`POST /v1/images/generations` · `microsoft/mai-image-2.5`: `text`, `image` → `image`

Katera polja uporablja zahteva?

`POST /v1/images/generations` · `microsoft/mai-image-2.5`: `model`, `prompt`, `aspect_ratio`, `n`, `input_references`, `provider`

Katere omejitve veljajo?

`POST /v1/images/generations` · `microsoft/mai-image-2.5`: `n.minimum`: `1`; `n.maximum`: `1`

Ailoot povežite s Claude Code, OpenCode, Hermes ali svojo aplikacijo.

## Podjetje in njegov portfelj projektov

Podjetje in njegov portfelj projektov: milijoni strank; mesečna prodaja v milijardah.

## Žetone kupujte s popustom.

Naročniški popust za redno delo. Promocijske kode prinesejo do 50% popusta na nakup žetonov.

Naročnina

Za redne zahteve izberite paket s popustom.

Promocijska koda do 50%

Kodo vnesite ob nakupu. Cena se preračuna po veljavni akciji.

Poraba v zgodovini

Za vsako zahtevo se shranijo model, žetoni in znesek.

[Izberite naročnino](https://ailoot.ai/docs/sl/billing/subscriptions/) · [Oglejte si cene modelov](https://ailoot.ai/models/sl/)

## API povežite z izdelkom, ki ga prodajate.

SaaS, aplikacije in boti po ponudbi in licenčni pogodbi Ailoot. Za nadaljnjo prodajo zaprosite za preprodajno licenco.

Komercialna aplikacija

Ustvarjanje besedila, slik, videa in zvoka vključite v plačljive funkcije svoje storitve.

Licenca za preprodajalca

Pošljite opis projekta in shemo dostopa. Zahtevajte pisne pogoje uporabe in nadaljnje prodaje.

Dokumenti na strani

Ponudba, licenčna pogodba in politika obdelave podatkov so dostopne pred povezavo.

[Zaprosite za preprodajno licenco](mailto:support@ailoot.ai) · [Ponudba in licenčna pogodba](https://ailoot.ai/legal/offer?lang=sl)

## Ailoot · Podjetje in njegov portfelj projektov





Ailoot temelji na pridobljenih operativnih izkušnjah, široki bazi strank, stabilni storitvi in stalnem spremljanju KPI.





Podjetje in njegov portfelj projektov: milijoni strank; mesečna prodaja v milijardah.





Ailoot te operativne izkušnje uporablja za dostop prek API do funkcij umetne inteligence v izdelkih strank, agentih, aplikacijah in avtomatizacijah.
