Microsoft AI: MAI-Image-2.7 Flash API
نموذج سريع من Microsoft AI لتوليد الصور وتحريرها بدقة، مع دعم المراجع البصرية وسير العمل الإبداعي واسع النطاق.
MAI-Image-2.7 Flash من Microsoft AI هو نموذج قائم على الانتشار لتوليد الصور من النص وتحرير الصور من صورة إلى صورة. يدعم إدخال النص والصور، ويستطيع إنشاء أصول موجهة بالمراجع باستخدام ما يصل إلى5 صور مرجعية للأسلوب أو الموضوع. كما يتيح تعديل اللون أو المادة واستبدال العناصر وإنشاء خلفيات شفافة دون الحاجة إلى أقنعة يدوية.
صُمم هذا الإصدار ليكون أسرع وأقل تكلفة من MAI-Image-2.7، مع الحفاظ على قدرات التوليد والتحرير نفسها، ولذلك يناسب الأدوات الإبداعية التفاعلية، والتخصيص، والتكرار السريع، وإنشاء المسودات بكميات كبيرة. يمكن استخدامه لتنظيف صور المنتجات، وتصميم واجهات المتاجر واللافتات والمواد التسويقية التي تتطلب نصاً مرئياً دقيقاً، مع التضحية بجزء من الدقة مقابل السرعة. يقتصر على توليد الصور وتحريرها ولا يتضمن استدلالاً نصياً أو استخدام الأدوات أو البحث على الويب.
يبلغ سياق النموذج32,000 tokens، ويُعاد الناتج دائماً بصيغة PNG داخل كائن JSON مشفّر بترميز base64. يجب ألا يقل عرض الصورة وارتفاعها عن768 بكسل، وتُقبل الصور المرجعية بصيغتي JPEG أو PNG، مع حد أقصى يبلغ5 صور للتحرير. النموذج متاح كمعاينة عامة ويُستخدم كعائلة النماذج الافتراضية في Bing Image Creator.
آخر تحديث:
MODEL ID
mai-image-2.7-flash- السياق
- 4.096K
- أقصى إخراج
- 1.024K
- الإدخال
- text / image
- الإخراج
- image
أبرز الميزات
- توليد نص إلى صورة
- تحرير دقيق للصور
- حتى5 صور مرجعية
- إخراج PNG دائماً
- سياق32,000 tokens
المزوّدون
قارن أسعار API بين المزوّدين. اختر مزوّدًا لعرض جميع الرسوم والشروط.
| التوافر | |
|---|---|
الإحصاءات التاريخية ليست فحصًا مباشرًا للحالة. غياب البيانات لا يعني انقطاع الخدمة.
الاختبارات المرجعية
- 7
ترتيب Artificial Analysis لتحرير الصور
المرتبة7 في قائمة Artificial Analysis لتحرير الصور.
- 11
ترتيب Artificial Analysis لتوليد الصور من النص
المرتبة11 في قائمة Artificial Analysis لتوليد الصور من النص.
- 3
Artificial Analysis لتحرير المشهد والأسلوب
المرتبة3 في تقييم Artificial Analysis لتحرير المشهد والأسلوب.
- 4
Artificial Analysis للتحسين والاستعادة
المرتبة4 في تقييم Artificial Analysis للتحسين والاستعادة.
الدرجات كما نشرها مزوّد النموذج.
البدء السريع
أرسل مهمة صورة، ثم استعلم عن حالتها واحفظ الصور. تستخدم الأمثلة 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?
MAI-Image-2.7 Flash من Microsoft AI هو نموذج قائم على الانتشار لتوليد الصور من النص وتحرير الصور من صورة إلى صورة. يدعم إدخال النص والصور، ويستطيع إنشاء أصول موجهة بالمراجع باستخدام ما يصل إلى5 صور مرجعية للأسلوب أو الموضوع. كما يتيح تعديل اللون أو المادة واستبدال العناصر وإنشاء خلفيات شفافة دون الحاجة إلى أقنعة يدوية. صُمم هذا الإصدار ليكون أسرع وأقل تكلفة من MAI-Image-2.7، مع الحفاظ على قدرات التوليد والتحرير نفسها، ولذلك يناسب الأدوات الإبداعية التفاعلية، والتخصيص، والتكرار السريع، وإنشاء المسودات بكميات كبيرة. يمكن استخدامه لتنظيف صور المنتجات، وتصميم واجهات المتاجر واللافتات والمواد التسويقية التي تتطلب نصاً مرئياً دقيقاً، مع التضحية بجزء من الدقة مقابل السرعة. يقتصر على توليد الصور وتحريرها ولا يتضمن استدلالاً نصياً أو استخدام الأدوات أو البحث على الويب. يبلغ سياق النموذج32,000 tokens، ويُعاد الناتج دائماً بصيغة PNG داخل كائن JSON مشفّر بترميز base64. يجب ألا يقل عرض الصورة وارتفاعها عن768 بكسل، وتُقبل الصور المرجعية بصيغتي JPEG أو PNG، مع حد أقصى يبلغ5 صور للتحرير. النموذج متاح كمعاينة عامة ويُستخدم كعائلة النماذج الافتراضية في Bing Image Creator.
كيف تُحتسب فاتورة الاستخدام؟
تعتمد فاتورتك على المزوّد الذي تستخدمه وأسعاره واستخدامك. قد تختلف الأسعار مع المدخلات الأطول أو الشروط الأخرى. تُحتسب الفاتورة وفق تكلفة التوليد الفعلية. راجع فاتورتك للمبلغ النهائي.
ما أنواع الإدخال التي يدعمها النموذج؟
يدعم إدخال النص والصور. يمكن استخدام ما يصل إلى5 صور مرجعية للأسلوب أو الموضوع.
ما حجم السياق وصيغة الإخراج؟
يبلغ السياق32,000 tokens. يكون الإخراج دائماً صورة PNG داخل كائن JSON بترميز base64.
ما المهام المناسبة له؟
يناسب توليد الصور من النص، وتحرير الصور من صورة إلى صورة، وتنظيف صور المنتجات، والتكرار الإبداعي السريع والتوليد واسع النطاق.
ما الفرق بينه وبين MAI-Image-2.7؟
MAI-Image-2.7 Flash أسرع وأقل تكلفة، مع قدرات التوليد والتحرير نفسها، لكنه يضحي بجزء من الدقة لصالح السرعة.
هل يدعم الاستدلال النصي أو البحث على الويب؟
لا؛ يقتصر على توليد الصور وتحريرها ولا يتضمن الاستدلال النصي أو استخدام الأدوات أو البحث على الويب.