Microsoft AI: MAI-Image-2.7 Flash API
מחולל תמונות מהיר לעריכה מדויקת, יצירת תמונה מטקסט והפקת נכסים מונחית הפניות בקנה מידה גדול.
Microsoft AI: MAI-Image-2.7 Flash הוא מודל תמונה המבוסס על Diffusion, ומיועד ליצירת תמונות מטקסט ולעריכה מדויקת ונשלטת של תמונות. הוא מקבל קלט טקסט ותמונה, ויכול להפיק נכסים בהתאם לעד5 תמונות הפניה של סגנון או נושא. המודל זמין כגרסת תצוגה מקדימה ציבורית ומשמש כברירת המחדל במשפחת Bing Image Creator.
המודל מתאים ליצירת טיוטות בנפח גבוה, לכלי יצירה אינטראקטיביים ולתהליכי איטרציה שבהם מהירות ועלות לכל תמונה חשובות יותר מגימור באיכות4K. אפשר להשתמש בו לניקוי תמונות מוצר, ליצירת רקע שקוף, להחלפת אובייקטים ללא מיסוך ידני ולשינוי צבע או חומר של אובייקט בלי ליצור מחדש את הסצנה כולה.
הוא מתאים גם לחנויות מקוונות, לשלטים ולחומרי שיווק שבהם נדרש טקסט מדויק בתמונה. הפלט תמיד מתקבל כ-PNG בתוך אובייקט JSON המקודד ב-base64. נדרש שלכל ממד של תמונת הפלט יהיו לפחות768 פיקסלים; בעריכה מומלץ לציין במפורש את אזור העריכה, ותמונות ההפניה חייבות להיות JPEG או PNG, עד5 תמונות.
עודכן:
MODEL ID
mai-image-2.7-flash- הקשר
- 4.096K
- פלט מרבי
- 1.024K
- קלט
- text / image
- פלט
- image
עיקרי הדברים
- יצירה מטקסט מבוססת Diffusion
- עריכת תמונה מדויקת
- עד5 תמונות הפניה
- פלט PNG ב-JSON
- חלון הקשר32,000 tokens
ספקים
השוו מחירי API בין ספקים. בחרו ספק כדי לראות את כל החיובים והתנאים.
| זמינות | |
|---|---|
נתונים היסטוריים אינם בדיקת מצב בזמן אמת. נתונים חסרים אינם מצביעים על השבתה.
בנצ׳מרקים
- 7
Artificial Analysis — דירוג עריכת תמונות
מקום7 בדירוג
- 11
Artificial Analysis — דירוג יצירה מטקסט לתמונה
מקום11 בדירוג
- 3
Artificial Analysis — עריכת סצנה וסגנון
מקום3 בדירוג
- 4
Artificial Analysis — שיפור ושחזור
מקום4 בדירוג
ציונים כפי שפורסמו על ידי ספק המודל.
התחלה מהירה
שלחו משימת תמונה, בדקו את מצבה ושמרו את התמונות. הדוגמאות משתמשות ב-curl ובספרייה התקנית של Python 3.
POST https://openapi.felo.ai/api/v1/images/generations
1קבלו את מפתח ה-API שלכם
צרו מפתח בחשבון Felo API Platform שלכם והגדירו אותו כמשתנה סביבה.
export FELO_API_KEY="YOUR_API_KEY"2שלחו את הבקשה הראשונה
ערכים אופציונליים משתנים לפי המודל ואינם מוגדרים כאן. בדקו אותם ב-Playground. השדות נמצאים לצד model ו-prompt, ללא עטיפת input.
curl --fail-with-body --max-time 60 "https://openapi.felo.ai/api/v1/images/generations" \
-H "Authorization: Bearer $FELO_API_KEY" \
-H "Content-Type: application/json" \
-o created.json \
-d '{
"prompt": "A studio product photo of a ceramic coffee cup on warm linen, soft morning light",
"model": "mai-image-2.7-flash"
}'3בדיקת המשימה
השליחה מחזירה task_id. בדקו כל 3 שניות במצב queued או running; עצרו ב-succeeded, failed או interrupted. ההמתנה מוגבלת ל-30 דקות. שמרו created.json כדי להמשיך לבדוק בלי לשלוח שוב.
python3 - <<'PY'
import json, os, time
from pathlib import Path
from urllib.parse import quote
from urllib.request import Request, urlopen
task = json.loads(Path("created.json").read_text())
task_id = task["task_id"]
url = "https://openapi.felo.ai/api/v1/images/generations/" + quote(task_id, safe="")
headers = {"Authorization": "Bearer " + os.environ["FELO_API_KEY"]}
deadline = time.monotonic() + 1800
while task["status"] in ("queued", "running"):
if time.monotonic() >= deadline:
raise TimeoutError(f"Keep task_id={task_id} to resume polling")
time.sleep(3)
with urlopen(Request(url, headers=headers), timeout=60) as response:
task = json.load(response)
if task.get("task_id") != task_id or task.get("kind") != "image":
raise ValueError("Unexpected task response")
print(task["status"])
if task["status"] != "succeeded":
raise RuntimeError(task.get("error") or task["status"])
if not task.get("outputs"):
raise ValueError("Task succeeded without image outputs")
Path("task.json").write_text(json.dumps(task))
print("Saved task.json")
PY4הורדת הפלט
לאחר הצלחה, שמרו outputs מתוך task.json. נתמכים קישורי HTTPS, אובייקטי URL ו-b64_json. הורידו קישורים חתומים בהקדם; להורדת תמונות אין צורך במפתח API.
python3 - <<'PY'
import base64, json
from pathlib import Path
from urllib.request import urlopen
task = json.loads(Path("task.json").read_text())
if task.get("status") != "succeeded" or not task.get("outputs"):
raise ValueError("No completed image outputs")
extensions = {"image/png": ".png", "image/jpeg": ".jpg", "image/webp": ".webp", "image/gif": ".gif", "image/avif": ".avif"}
for index, output in enumerate(task["outputs"], 1):
item = output if isinstance(output, dict) else {}
url = output if isinstance(output, str) else item.get("url") or item.get("unsigned_url")
mime = item.get("media_type") or "image/png"
if url and url.startswith("https://"):
with urlopen(url, timeout=60) as response:
data = response.read()
mime = response.headers.get_content_type()
elif url and url.startswith("data:image/") and ";base64," in url:
header, encoded = url.split(",", 1)
mime = header[5:].split(";", 1)[0]
data = base64.b64decode(encoded, validate=True)
elif item.get("b64_json"):
data = base64.b64decode(item["b64_json"], validate=True)
else:
raise ValueError("Unrecognized image output")
path = Path(f"image-{index}" + extensions.get(mime, ".bin"))
path.write_bytes(data)
print(path)
PYinput_references
לעריכת תמונה, החליפו את כתובת הדוגמה בכתובת HTTPS שלכם או ב-data URL של תמונת base64. שלחו פעם אחת והמשיכו באותם שלבי בדיקה ושמירה.
curl --fail-with-body --max-time 60 "https://openapi.felo.ai/api/v1/images/generations" \
-H "Authorization: Bearer $FELO_API_KEY" \
-H "Content-Type: application/json" \
-o created.json \
-d '{
"prompt": "Keep the product and framing. Replace the background with a sunlit marble countertop.",
"model": "mai-image-2.7-flash",
"input_references": [
{
"type": "image_url",
"image_url": {
"url": "https://example.com/product.png"
}
}
]
}'פרמטרים נתמכים
- n
- background
- max_tokens
- temperature
- aspect_ratio
- input_references
- max_completion_tokens
מעדיפים את העיון המלא?
מסמכי API →שאלות נפוצות
מהו Microsoft AI: MAI-Image-2.7 Flash?
Microsoft AI: MAI-Image-2.7 Flash הוא מודל תמונה המבוסס על Diffusion, ומיועד ליצירת תמונות מטקסט ולעריכה מדויקת ונשלטת של תמונות. הוא מקבל קלט טקסט ותמונה, ויכול להפיק נכסים בהתאם לעד5 תמונות הפניה של סגנון או נושא. המודל זמין כגרסת תצוגה מקדימה ציבורית ומשמש כברירת המחדל במשפחת Bing Image Creator. המודל מתאים ליצירת טיוטות בנפח גבוה, לכלי יצירה אינטראקטיביים ולתהליכי איטרציה שבהם מהירות ועלות לכל תמונה חשובות יותר מגימור באיכות4K. אפשר להשתמש בו לניקוי תמונות מוצר, ליצירת רקע שקוף, להחלפת אובייקטים ללא מיסוך ידני ולשינוי צבע או חומר של אובייקט בלי ליצור מחדש את הסצנה כולה. הוא מתאים גם לחנויות מקוונות, לשלטים ולחומרי שיווק שבהם נדרש טקסט מדויק בתמונה. הפלט תמיד מתקבל כ-PNG בתוך אובייקט JSON המקודד ב-base64. נדרש שלכל ממד של תמונת הפלט יהיו לפחות768 פיקסלים; בעריכה מומלץ לציין במפורש את אזור העריכה, ותמונות ההפניה חייבות להיות JPEG או PNG, עד5 תמונות.
איך מחייבים על השימוש?
החיוב שלכם תלוי בספק שאתם משתמשים בו, במחירים שלו ובשימוש שלכם. קלט ארוך יותר או תנאים אחרים עשויים להיות במחיר שונה. החיוב מבוסס על עלות היצירה בפועל. ראו את החשבונית לסכום הסופי.
אילו סוגי קלט המודל תומך?
המודל תומך בקלט טקסט ובקלט תמונה. תמונות הפניה לעריכה חייבות להיות JPEG או PNG, ועד5 תמונות.
מהו חלון ההקשר ומהו פורמט הפלט?
חלון ההקשר הוא32,000 tokens. הפלט תמיד מתקבל כתמונת PNG בתוך אובייקט JSON המקודד ב-base64.
לאילו משימות המודל מתאים?
הוא מתאים ליצירת תמונות מטקסט, לעריכת תמונות, לניקוי תמונות מוצר, להחלפת אובייקטים, לשינוי צבע או חומר וליצירת נכסים מונחית הפניות.
מה ההבדל בינו לבין MAI-Image-2.7?
MAI-Image-2.7 Flash הוא גרסה מהירה ובעלות נמוכה יותר, עם אותן יכולות יצירה ועריכה כמו MAI-Image-2.7, תוך ויתור על חלק מהנאמנות לטובת מהירות.