Microsoft AI: MAI-Image-2.5 Pro

Microsoft AI MAI-Image-2.5 Pro יוצר ועורך תמונות מפורטות לחזות ראשית, לקומפוזיציות מוצר ולטקסט מדויק בתוך התמונה. מהדורת Pro מדגישה עקביות של עצמים, דמויות, חומרים ויחסים מרחביים בסצנות עמוסות, ומשתמשת בטקסט ובייחוסים חזותיים להפקת תמונת PNG.

Ailoot Ultra · תמונות POST /v1/images/generations microsoft/mai-image-2.5-pro

על המודל

התיאור הזה מציג את יכולות המודל. הקלט, הפלט והאפשרויות הזמינים ב-Ailoot מפורטים בהמשך לפי השיטה שנבחרה.

Microsoft AI MAI-Image-2.5 Pro הוא המהדורה הממוקדת בנאמנות חזותית בתוך סדרת התמונות 2.5. הוא יוצר תמונות מבריפים בשפה טבעית ומבצע עריכות מונחות בנכסים קיימים. Microsoft מזהה תמונות ראשיות, עריכה מפורטת וטקסט מדויק בתוך התמונה כשימושים מרכזיים, והשוואת המודלים שלה מדגישה עקביות של עצמים, דמויות, חומרים ויחסים מרחביים בקומפוזיציות מורכבות. התוצר הסופי הוא תמונה לתהליך עיצוב או הפקה, כגון תמונת מוצר מרכזית או סצנה מערכתית מסודרת בקפידה.

ליצירה, תארו את הקומפוזיציה באמצעות יחסים במקום רשימת עצמים שאינם קשורים. הגדירו את הנושא המרכזי, את קנה המידה שלו ביחס לפריטים סמוכים, את החומרים המעורבים ואת כיוון התאורה. ההסקה החזותית המתועדת של מהדורת Pro שימושית כשהיחסים האלה קובעים אם סצנה עמוסה אמינה. לקומפוזיציית מוצר, הניחו כד קרמיקה, כוסות שקופות ובד מקופל על שולחן עץ, עם השתקפויות עקביות ואור מחלון יחיד. בדקו בתמונה שנוצרה את המגעים, הצללים ותכונות החומרים הגלויות.

לעבודת מוצר ודמות, ספקו את הזהות החזותית שחייבת לשרוד את העריכה. Microsoft מתארת עקביות עצמים לאורך סצנות מורכבות ועקביות דמויות בין מבטים ורגעים כחוזקות של Pro. ציינו אילו מאפיינים מזהים את הפריט או האדם ואיזה היבט של הסצנה צריך להשתנות. למשל, שמרו על קווי המתאר ועל פרטי הסגירה של ז'קט תוך הצבת הדמות ברקע אחר. הבדיקה השימושית משווה את הפרטים שנשמרו לייחוס המקור; תוצאה חזותית מושכת אינה כשלעצמה ראיה להתאמה מדויקת.

ממשק עריכת התמונות של היצרן מקבל עד חמישה ייחוסים בפורמט JPEG או PNG. הפרידו בין תפקידיהם בבריף: המוצר, האדם, הסביבה או הטיפול החזותי. משימות העריכה כוללות הסרת עצמים והחלפתם, שינויי מאפיינים, מילוי אזורים בתמונה, התאמת פריסה, עדכוני טקסט וניקוי פגמים. לעריכה מקומית, תארו את היעד ואת הרכיבים שסביבו שיש לשמור. לסידור מחדש משמעותי יותר, הסבירו כיצד הקומפוזיציה צריכה לפעול לאחר השינוי כדי שיהיה למודל יעד מרחבי מגובש.

רינדור טקסט רלוונטי במיוחד לקומפוזיציה ראשית או לקונספט אריזה. ספקו את הביטוי המדויק, את מיקומו ואת הקשר שלו לעצם או לתמונה. שמרו על עקביות של שמות חוזרים וטקסט תוויות בין הבריף לייחוסים. בדקו כל תו שנוצר בגודל התצוגה המיועד והשוו אותו לניסוח שסופק. עריכה מאוחרת יכולה להתמקד בניסוח או במיקום תוך שמירה על קומפוזיציית המוצר שהצליחה. לאחר מכן אפשר לשלב את פלט ה־PNG בפריסה שדרישות הטיפוגרפיה והחיתוך הסופיות שלה ידועות.

מדריך התמונות הנוכחי של Microsoft מחיל על מודלי 2.5 שטח פלט מרבי של 1,048,576 פיקסלים, השקול ל־1024×1024. שני הממדים חייבים להיות לפחות 768 פיקסלים בממשק הזה, וצלע ארוכה יותר מותרת כאשר השטח הכולל נשאר בתוך המגבלה. הדבר מאפשר קומפוזיציות מלבניות כגון 1344×768, הכוללות 1,032,192 פיקסלים. מגבלת השטח הזו שונה ממקסימום של 1024 בכל צלע. הכינו את צורת היעד לקומפוזיציה במקום לצפות שתווית כללית של יחס ממדים תקבע נכון את החיתוך.

מדריך ההגשה מגדיר הקשר הנחיה מרבי של 32,000 טוקנים ומחזיר נתוני תמונת PNG הן ביצירה והן בעריכה. עמוד הקטלוג המדויק של Pro מציין בנפרד חלון הקשר של 131.072K ו־4,096 טוקני פלט. אלה כמויות טוקנים שפורסמו, עם תחום התייחסות משלהן בקטלוג או בהגשה; הכנת בקשת התמונה בפועל עוקבת אחר מגבלות ההנחיה והפיקסלים של ההגשה. שמרו את התמונה, ייחוסי המקור והבריף כרשומת תיקון אחת. בדקו בתוצאה החזותית עצמה את אילוצי הזהות, החומר והגאומטריה המפורטים שהניעו את הבחירה ב־Pro.

בחירת הגרסה צריכה להתאים לקומפוזיציה. MAI-Image-2.5 הרגיל מכסה יצירה כללית ועריכות מקומיות; Pro מוסיף את דגש הסדרה על נאמנות ועל יחסים עקביים בסצנות עמוסות חזותית. משפחת 2.6 מעלה את מגבלת שטח הפלט המתועדת ומוסיפה עיגון אופציונלי במידע מהרשת ובחירת יחס אוטומטית. הבקרות המאוחרות האלה ייחודיות ל־2.6 ואינן מגדירות את תהליך העבודה של מהדורת Pro הזו. בחרו ב־Pro כאשר החלק הקשה בבריף נוגע לזהות עצמים יציבה, למראה החומר או למבנה המרחבי בתוך תמונה מפורטת.

בדקו גם את השינוי שהתבקש וגם את התוכן שנשמר. ידיים המחזיקות עצמים, הצטלבויות, אותיות קטנות, דמיון בפנים והשתקפויות הם מקומות מועילים לבדיקה בקומפוזיציה מורכבת. גם תמונה סבירה יכולה להכיל סימון מטעה או יחס פיזי שגוי. הגדירו תיקון ממוקד להמשך ושמרו את חלקי הבריף שהפיקו את הפריסה הרצויה. כך נתמך רצף מבוקר של תיקוני עיצוב במקום להגדיר שוב ושוב את הסצנה כולה.

Ailoot Ultra · תמונות POST /v1/images/generations microsoft/mai-image-2.5-pro

microsoft/mai-image-2.5-pro

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

התחלה

סוגי קלט נתמכים: טקסט · תמונות
תוצאות: תמונות

זמין ב-Ailoot · קלט ושיטות

Ailoot Ultra · תמונות POST /v1/images/generations

סוגי קלט: text, image
סוגי פלט: image

שדה	סוג	דרישה	ערכים ומגבלות	ברירת מחדל
שדה`model`	סוג`string`	דרישהחובה	ערכים ומגבלות microsoft/mai-image-2.5-pro	ברירת מחדל—
שדה`prompt`	סוג`string`	דרישהחובה	ערכים ומגבלות אורך מזערי: ⁦1⁩	ברירת מחדל—
שדה`aspect_ratio`	סוג`string`	דרישהרשות	ערכים ומגבלות 1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3, auto	ברירת מחדל—
שדה`n`	סוג`integer`	דרישהרשות	ערכים ומגבלות מינימום: ⁦1⁩ מקסימום: ⁦1⁩	ברירת מחדל—
שדה`input_references`	סוג`array`	דרישהרשות	ערכים ומגבלות מספר פריטים מזערי: ⁦0⁩ מספר פריטים מרבי: ⁦1⁩	ברירת מחדל—
שדה`provider`	סוג`object`	דרישהרשות	ערכים ומגבלות	ברירת מחדל—

פרמטרים ומחזור חיים של השיטה

פרמטר	מפרט
פרמטר`content_type`	מפרטapplication/json
פרמטר`required`	מפרטmodel, prompt
פרמטר`material_types`	מפרטtext, image

מחזור חיים: synchronous_result_then_owned_library

GET /v1/media/tasks/{task_id} · ערך task_id שהוחזר בפועל או רשומה בספריית המדיה

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

GET /v1/media/assets

GET /v1/media/assets/{asset_id}

תעריפים

אופן חישוב החיוב הסופי

התעריפים המוצגים מספקים אומדן לעלות לפני היצירה. החיוב הסופי מחושב לפי העלות שנרשמה עבור היצירה המקורית. משך הפלט שנמדד והכמויות החזויות אינם הכמות הסופית לחיוב.

מידע תעריפים אינו מוסיף אפשרויות לבקשה. הפרמטרים הנתמכים מפורטים בשיטה שנבחרה.

מצב מהיר: לא צוין כאשר נבחר מצב מהיר
מצב Flex: לא צוין כאשר נבחר מצב flex
מאמץ חשיבה מרבי: לא צוין כאשר מאמץ החשיבה המרבי משתמש בהתאמת ברירת המחדל (default)

תעריפים משוערים להשוואה

מחירים לפי תצורה

התאימו כל חיוב לתנאים המוצגים. השתמשו בתעריף אחד לכל קבוצה של תצורות חלופיות.

תצורה	טבלת תעריפים	כמות חזויה	חיוב
תצורהתעריפי בסיס לטוקנים	טבלת תעריפיםתעריף בסיס	כמות חזויה—	חיוב קלט · טוקני קלט · אומדן להשוואה בלבד — / 1K טוקנים פלט · טוקני פלט · אומדן להשוואה בלבד — / 1K טוקנים קלט · קריאה מהמטמון · אומדן להשוואה בלבד — / 1K טוקנים קלט · כתיבה למטמון · אומדן להשוואה בלבד — / 1K טוקנים קלט · כתיבה למטמון, 1 שעה · אומדן להשוואה בלבד — / 1K טוקנים
תצורהעלות יצירה משוערת	טבלת תעריפים—	כמות חזויהאומדן ליצירה אחת	חיוב פלט · עלות יצירה משוערת · אומדן להשוואה בלבד $0.884736 אומדן לפני היצירה אומדן זה אינו חיוב נוסף או תעריף קבוע עבור היצירה שהושלמה.

לפני הבקשה Ailoot משריינת סכום משוער. לאחר קבלת התוצאה היא מסדירה את החיוב הסופי לפי השימוש המדוד. הסדרת חיוב בהזרמה משתמשת ברשומת השימוש הסופית. איך פועלים שריון הסכום והסדרת החיוב →

דוגמאות לבקשות

Ailoot Ultra · תמונות

curl

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

קבלה ושמירה של תוצאות

Ailoot Ultra · תמונות

הורידו כל תמונה שהוחזרה או שמרו את תוכן ה-Base64 שלה

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

קריאות תוכן נוספות

קריאת נכסים קיימים שבבעלותכם

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.

שמירת כל התוצאות שהושלמו

שמרו כל תמונה שהושלמה; אחזרו אותה מכל URL שהוחזר או פענחו את תוכן ה-Base64 שלה.

שמרו את התשובה המלאה ואת הכותרות, כל פלט שהתקבל בפועל, את המזהים המקוריים שהוחזרו ואת כל שדות השימוש. שחזרו את הפעולה המקורית בלי לשלוח שוב בקשת יצירה.

כשצריך לבדוק את התגובה המקורית

שמרו את X-Client-Request-ID שהוחזר לצורך התאמת רישומים. קראו רק ערכי task_id/asset_id שהוחזרו בפועל או את ספריית המדיה שבבעלותכם; לעולם אל תבנו URL של משימה ממזהה הפעולה ואל תשלחו שוב בקשת יצירה.

שדות התגובה

שדה	סוג
שדה`created`	סוג
שדה`data[].url`	סוג
שדה`data[].b64_json`	סוג
שדה`usage`	סוג

כינויים

כינויים למודל

Ailoot Ultra microsoft/mai-image-2.5-pro

כינויים לנתיבי שיטות

/v1/images

מזהי מודלים קשורים IDs

microsoft/mai-image-2.5-pro

FAQ · Microsoft AI: MAI-Image-2.5 Pro

אילו קלטים ותוצאות זמינים?: POST /v1/images/generations · microsoft/mai-image-2.5-pro: text, image → image
באילו שדות הבקשה משתמשת?: POST /v1/images/generations · microsoft/mai-image-2.5-pro: model, prompt, aspect_ratio, n, input_references, provider
אילו מגבלות חלות?: POST /v1/images/generations · microsoft/mai-image-2.5-pro: n.minimum: 1; n.maximum: 1

Microsoft AI: MAI-Image-2.5 Pro