Felo API PlatformFelo API Platform
بازگشت به مدل‌ها

Microsoft AI: MAI-Image-2.7 API

MAI-Image-2.7 مدلی برای تولید و ویرایش تصویر با حفظ ترکیب‌بندی، نمایش دقیق متن و خروجی فوتورئال است.

MAI-Image-2.7 از ورودی متنی و تصویری پشتیبانی می‌کند و با رویکردی مبتنی بر انتشار، تصویر را از روی دستور متنی می‌سازد یا تصاویر موجود را با تبدیل تصویر به تصویر ویرایش می‌کند. این مدل می‌تواند اشیا را حذف یا جایگزین کند، ویژگی‌های آن‌ها را تغییر دهد و در عین حفظ چیدمان و ترکیب‌بندی، ویرایش‌های تکراری را از نظر بصری سازگار نگه دارد.

این مدل برای تولید خلاقانه و طراحی، بازطراحی صحنه و نورپردازی، ساخت تصاویر فوتورئال، پرتره‌های دقیق، تصاویر محصول، دارایی‌های برند و طرح‌های تجاری مناسب است. همچنین برای درج متن و نماد در برچسب، پوستر، بسته‌بندی و تابلو، به‌روزرسانی متن، حذف پس‌زمینه تصاویر محصول، ترمیم دارایی‌های موجود و حذف آثار تاری حرکتی کاربرد دارد.

MAI-Image-2.7 در Microsoft Foundry به‌صورت پیش‌نمایش عمومی ارائه می‌شود و از طریق fal، Genspark، OpenRouter و Vercel نیز در دسترس است. این مدل خانواده پیش‌فرض MAI Image برای Bing Image Creator است و دسترسی مستقیم از Azure، زیرساخت سازمانی، صورتحساب یکپارچه، حاکمیت و قابلیت انتقال PTU را فراهم می‌کند.

به‌روزرسانی:

MODEL ID

mai-image-2.7
زمینه
4.096K
حداکثر خروجی
1.024K
ورودی
text / image
خروجی
image

نکات برجسته

  • ویرایش با سازگاری بصری
  • رندر دقیق متن
  • خروجی فوتورئال
  • حفظ ترکیب‌بندی تصویر
  • پشتیبانی از ویرایش تکراری

ارائه‌دهندگان

1 ارائه‌دهنده

قیمت API را بین ارائه‌دهندگان مقایسه کنید. یک ارائه‌دهنده را انتخاب کنید تا همه هزینه‌ها و شرایط را ببینید.

ارائه‌دهنده · جزئیات قیمت‌گذاری
دسترس‌پذیری

بنچمارک‌ها

  • AA-Image-Editing v2.1

    امتیاز Elo با5,478 رأی؛ رتبه1 در تاریخ2026-11-16.

    1215
  • Artificial Analysis scene and style

    امتیاز Elo آن از مدل بعدی بیشتر است.

    24
  • Artificial Analysis live-action film

    رتبه1 را کسب کرده است.

    1
  • Artificial Analysis consumer

    رتبه1 را کسب کرده است.

    1
  • Artificial Analysis frontier editing

    رتبه1 را کسب کرده است.

    1

امتیازها همان‌گونه که ارائه‌دهنده مدل منتشر کرده است.

شروع سریع

وظیفه تصویر را ارسال کنید، وضعیت را بررسی و تصاویر را ذخیره کنید. مثال‌ها از 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"
}'

3بررسی وظیفه

ارسال، task_id برمی‌گرداند. در queued یا running هر ۳ ثانیه بررسی کنید؛ در succeeded، failed یا interrupted متوقف شوید. حداکثر انتظار ۳۰ دقیقه است. برای ادامه بررسی بدون ارسال مجدد، 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")
PY

4دانلود خروجی

پس از موفقیت، 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)
PY
input_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",
  "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?

MAI-Image-2.7 از ورودی متنی و تصویری پشتیبانی می‌کند و با رویکردی مبتنی بر انتشار، تصویر را از روی دستور متنی می‌سازد یا تصاویر موجود را با تبدیل تصویر به تصویر ویرایش می‌کند. این مدل می‌تواند اشیا را حذف یا جایگزین کند، ویژگی‌های آن‌ها را تغییر دهد و در عین حفظ چیدمان و ترکیب‌بندی، ویرایش‌های تکراری را از نظر بصری سازگار نگه دارد. این مدل برای تولید خلاقانه و طراحی، بازطراحی صحنه و نورپردازی، ساخت تصاویر فوتورئال، پرتره‌های دقیق، تصاویر محصول، دارایی‌های برند و طرح‌های تجاری مناسب است. همچنین برای درج متن و نماد در برچسب، پوستر، بسته‌بندی و تابلو، به‌روزرسانی متن، حذف پس‌زمینه تصاویر محصول، ترمیم دارایی‌های موجود و حذف آثار تاری حرکتی کاربرد دارد. MAI-Image-2.7 در Microsoft Foundry به‌صورت پیش‌نمایش عمومی ارائه می‌شود و از طریق fal، Genspark، OpenRouter و Vercel نیز در دسترس است. این مدل خانواده پیش‌فرض MAI Image برای Bing Image Creator است و دسترسی مستقیم از Azure، زیرساخت سازمانی، صورتحساب یکپارچه، حاکمیت و قابلیت انتقال PTU را فراهم می‌کند.

هزینه استفاده چگونه محاسبه می‌شود؟

صورت‌حساب شما به ارائه‌دهنده‌ای که استفاده می‌کنید، قیمت‌های آن و میزان مصرف شما بستگی دارد. ورودی‌های طولانی‌تر یا شرایط دیگر ممکن است قیمت متفاوتی داشته باشند. صورت‌حساب بر اساس هزینه واقعی تولید محاسبه می‌شود. مبلغ نهایی را در صورت‌حساب ببینید.

چه نوع ورودی و خروجی را پشتیبانی می‌کند؟

از ورودی متنی و تصویری پشتیبانی می‌کند و خروجی آن تصویر است.

این مدل برای چه وظایفی مناسب است؟

برای تولید خلاقانه، طراحی، ویرایش تصویر، بازطراحی صحنه، تغییر نور و حال‌وهوا، ساخت تصاویر محصول و درج متن در تصاویر مناسب است.

آیا می‌تواند متن را در تصویر رندر کند؟

بله، می‌تواند متن را در برچسب‌ها، پوسترها، بسته‌بندی‌ها و تابلوها رندر کند.

چه نوع ویرایش‌هایی را انجام می‌دهد؟

حذف و جایگزینی اشیا، تغییر ویژگی‌های آن‌ها، نقاشی درون تصویر، به‌روزرسانی متن و حذف آثار تاری حرکتی را انجام می‌دهد.

تفاوت آن با MAI-Image-2.6 چیست؟

طبق اطلاعات ارائه‌شده، MAI-Image-2.7 در هر10 مورد استفاده ارزیابی‌شده و هر7 کنش ویرایشی نسبت به MAI-Image-2.6 بهبود یافته است.

مدل‌های مرتبط