رفتن به محتوا

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

API مربوط به Stable Diffusion XL

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

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

در یک نگاه

API مربوط به Stable Diffusion XL، مدل Stable Diffusion XL را از طریق Mage در POST https://api.mage.space/v1/stable_diffusion_xl/generate اجرا می‌کند. یک درخواست با تنظیمات پیش‌فرض 10 Gems (حدود 0.01 دلار) هزینه دارد، بدون اشتراک. Stable Diffusion XL اشاره با @handle را پشتیبانی نمی‌کند.

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

نگاه کلی

API مربوط به Stable Diffusion XL چه کاری انجام می‌دهد

Stable Diffusion XL کلاسیک، تنظیم‌شده برای خروجی فوتورئال. متن به تصویر یا از روی یک تصویر ورودی، با قیمتی مقرون‌به‌صرفه.

Stable Diffusion XL، تنظیم‌شده برای خروجی فوتورئال، با امکان افزودن تصویر ورودی.

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

شروع سریع

فراخوانی API مربوط به Stable Diffusion XL

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

cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/stable_diffusion_xl/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('stable_diffusion_xl', {
  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("stable_diffusion_xl", {
    "prompt": "Editorial portrait in soft daylight, 35mm film look",
    "aspect_ratio": "4:5",
    "model_id": "6A35A7855770AE9820A3C931D4964C3817B6D9E3C6F9C4DABB5B3A94E5643B80",
})

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

مدل‌ها

مقادیر model_id برای Stable Diffusion XL

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

model_idنامپیش‌فرض
6A35A7855770AE9820A3C931D4964C3817B6D9E3C6F9C4DABB5B3A94E5643B80Stable Diffusion XLبله

گزینه‌ها

پارامترهای Stable Diffusion XL

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

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

ورودی‌ها

ورودی‌های رسانه‌ای که Stable Diffusion XL می‌پذیرد

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

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

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

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

  • تصویر · از 10 Gems

    API مدل Z-Image

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

  • تصویر · از 20 Gems

    Anima API

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

  • تصویر · از 35 Gems

    API Chroma

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

  • تصویر · از ۴۰ Gem

    Flux 2 API

    پرامپت‌های بلند و ویرایش با چند رفرنس

  • تصویر · از ۹ Gem

    GPT Image 2 API

    پرامپت‌های دقیق و متن خوانا

  • تصویر · از 75 Gems

    API Grok Image

    Grok Imagine در سه سطح کیفیت

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

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

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

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

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