رفتن به محتوا

API مج · مدل تصویر

SDXL Plus API

SDXL با چهره و دست‌های اصلاح‌شده

POST https://api.mage.space/v1/sdxl_plus/generate

در یک نگاه

SDXL Plus API مدل SDXL Plus را از طریق Mage در POST https://api.mage.space/v1/sdxl_plus/generate اجرا می‌کند. هر درخواست با تنظیمات پیش‌فرض 15 Gems (حدود $0.015) هزینه دارد، بدون اشتراک. SDXL Plus از @handle پشتیبانی نمی‌کند.

  • تصویرخروجی
  • 1نسخه
  • 15Gems برای هر تصویر، پیش‌فرض
  • $0.015حدود، به دلار

نگاه کلی

SDXL Plus API چه کاری انجام می‌دهد

پایپ‌لاین پرجزئیات SDXL ما با پاک‌سازی خودکار چهره و دست. متن به تصویر یا از روی یک تصویر ورودی؛ کندتر از SDXL ساده است، اما می‌ارزد.

پایپ‌لاین پرجزئیات SDXL در Mage با پاک‌سازی خودکار چهره و دست و یک تصویر ورودی اختیاری.

image را به‌عنوان ورودی می‌پذیرد.

شروع سریع

فراخوانی SDXL Plus API

MAGE_API_KEY را تنظیم کنید، درخواست را به /sdxl_plus/generate بفرستید و status_url را بررسی کنید تا درخواست کامل شود.

cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/sdxl_plus/generate' \
  --header "Authorization: Bearer $MAGE_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "prompt": "Editorial portrait in soft daylight, 35mm film look",
  "aspect_ratio": "4:5",
  "model_id": "6A35A7855770AE9820A3C931D4964C3817B6D9E3C6F9C4DABB5B3A94E5643B80"
}' | jq -r '.status_url')

# Repeat until status is "completed"; result.url is the file
curl "$STATUS_URL" --header "Authorization: Bearer $MAGE_API_KEY"
TypeScript
// npm install @mage-space/sdk
import Mage from '@mage-space/sdk';

const mage = new Mage(); // reads MAGE_API_KEY

const request = await mage.run('sdxl_plus', {
  prompt: 'Editorial portrait in soft daylight, 35mm film look',
  aspect_ratio: '4:5',
  model_id: '6A35A7855770AE9820A3C931D4964C3817B6D9E3C6F9C4DABB5B3A94E5643B80',
});

console.log(request.result.url);
Python
# pip install mage-space
from mage_space import Mage

mage = Mage()  # reads MAGE_API_KEY

request = mage.run("sdxl_plus", {
    "prompt": "Editorial portrait in soft daylight, 35mm film look",
    "aspect_ratio": "4:5",
    "model_id": "6A35A7855770AE9820A3C931D4964C3817B6D9E3C6F9C4DABB5B3A94E5643B80",
})

print(request["result"]["url"])

مدل‌ها

مقادیر model_id برای SDXL Plus

برای انتخاب یک نسخه، model_id را بفرستید. درخواست بدون آن، نسخه پیش‌فرض را اجرا می‌کند.

model_idنامپیش‌فرض
6A35A7855770AE9820A3C931D4964C3817B6D9E3C6F9C4DABB5B3A94E5643B80SDXL Plusبله

گزینه‌ها

پارامترهای SDXL Plus

مقادیر مجاز برای همه نسخه‌ها؛ ممکن است یک نسخه گزینه‌های کمتری داشته باشد. گزینه‌های هر نسخه در مستندات آمده است.

فیلدمقادیر
aspect_ratio21:9, 16:9, 3:2, 5:4, 1:1, 4:5, 2:3, 9:16, 9:21

ورودی‌ها

ورودی‌های رسانه‌ای قابل‌قبول در SDXL Plus

هرکدام را به‌صورت URL با https، data URL یا آپلود تا 100 MB بفرستید.

فیلدنقش
imageتصویر مرجع.

مدل‌های تصویر بیشتر

سایر API‌های تولید تصویر در Mage

  • تصویر · از 10 Gems

    Stable Diffusion v1.5 API

    کلاسیک، با هزینهٔ کم

  • تصویر · از 10 Gems

    Stable Diffusion v3.5 Large API

    Stable Diffusion‌ای که بهتر از همه به حرف شما گوش می‌دهد

  • تصویر · از 10 Gems

    API مدل Stable Diffusion XL

    SDXL بهینه‌شده برای تصاویر فوتورئال

  • تصویر · از 10 Gems

    API مدل Z-Image

    سریع‌ترین مدل تصویر در Mage

  • تصویر · از 20 Gems

    Anima API

    ساخته‌شده مخصوص انیمه

  • تصویر · از 35 Gems

    API Chroma

    وزن‌های باز، ساخته‌شده بر پایه Flux

سؤالات متداول

سؤالات متداول

هزینه SDXL Plus API چقدر است؟
یک درخواست SDXL Plus با تنظیمات پیش‌فرض (SDXL Plus) 15 Gems هزینه دارد، حدود $0.015. رزولوشن، مدت‌زمان و نسخه‌های دیگر قیمت را تغییر می‌دهند؛ هزینه دقیق در پاسخ اعلام می‌شود. اگر تولید ناموفق باشد، هزینه برگردانده می‌شود؛ اما اگر سیاست محتوایی Mage جلوی آن را بگیرد، برگردانده نمی‌شود.
اندپوینت SDXL Plus API چیست؟
POST https://api.mage.space/v1/sdxl_plus/generate همراه با هدر Authorization: Bearer که کلید API شما در Mage را دارد. پاسخ شامل status_url است که برای دریافت نتیجه باید آن را بررسی کنید.
کدام مدل‌های SDXL Plus را می‌توانم فراخوانی کنم؟
6A35A7855770AE9820A3C931D4964C3817B6D9E3C6F9C4DABB5B3A94E5643B80. پیش‌فرض SDXL Plus است.
آیا SDXL Plus از تصاویر رفرنس یا شخصیت‌ها پشتیبانی می‌کند؟
SDXL Plus ورودی image را می‌پذیرد. از @handle پشتیبانی نمی‌کند.
آیا می‌توانم SDXL Plus را از Claude یا ChatGPT استفاده کنم؟
بله. سرور MCP مربوط به Mage را به Claude، ChatGPT، Claude Code، Grok یا Cursor وصل کنید و SDXL Plus را با نام درخواست کنید. دستیار شما گزینه‌های آن را با get_model می‌خواند و پیش از تولید، قیمت را اعلام می‌کند.
نتایج SDXL Plus تا چه مدت نگهداری می‌شوند؟
نتایج و ورودی‌ها 30 روز نگهداری می‌شوند. هر چیزی را که می‌خواهید نگه دارید، در فضای ذخیره‌سازی خودتان دانلود کنید.

ساختن با Mage را شروع کن

یک حساب، یک موجودی Gems، همهٔ مدل‌ها. فقط برای چیزی که تولید می‌کنی هزینه بپرداز.