Mage API · نموذج صور

Stable Diffusion XL API

نموذج SDXL مضبوط للواقعية الفوتوغرافية

احصل على مفتاح APIجرّب Stable Diffusion XL في مساحة التجربة
POST https://api.mage.space/v1/stable_diffusion_xl/generate

لمحة سريعة

يشغّل Stable Diffusion XL API نموذج Stable Diffusion XL عبر Mage على POST https://api.mage.space/v1/stable_diffusion_xl/generate. تكلفة الطلب بالإعدادات الافتراضية 10 Gems (نحو 0.01 دولار) بدون اشتراك. لا يقبل Stable Diffusion XL إشارات @handle.

نظرة عامة

ما الذي يقدمه Stable Diffusion XL API

Stable Diffusion XL الكلاسيكي، مضبوط لنتائج واقعية فوتوغرافية. من نص إلى صورة أو انطلاقًا من صورة إدخال واحدة، بسعر اقتصادي.

Stable Diffusion XL، مضبوط لنتائج واقعية فوتوغرافية، مع صورة إدخال اختيارية.

يقبل image كمدخل.

بداية سريعة

استدعاء Stable Diffusion XL API

اضبط 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

أرسل كل مدخل كرابط https أو رابط بيانات (data URL) أو ملف مرفوع بحجم يصل إلى 100 MB.

الحقلالدور
imageالصورة المرجعية.

المزيد من نماذج الصور

واجهات API أخرى لإنشاء الصور على Mage

صورة · من 10 Gems

واجهة Z-Image API

أسرع نموذج صور على Mage

صورة · من 20 Gem

Anima API

مصمم خصيصًا للأنمي

صورة · من 35 Gem

Chroma API

مفتوح الأوزان، مبني على Flux

صورة · من 40 Gems

واجهة Flux 2 API

أوامر طويلة وتعديلات بمراجع متعددة

صورة · من 9 Gems

واجهة GPT Image 2 API

أوامر دقيقة ونصوص مقروءة

صورة · من 75 Gem

Grok Image API

Grok Imagine بثلاثة مستويات جودة

الأسئلة الشائعة

الأسئلة الشائعة

كم تبلغ تكلفة Stable Diffusion XL API؟

يكلّف طلب Stable Diffusion XL بالإعدادات الافتراضية (Stable Diffusion XL) ‏10 Gems، أي نحو 0.01$. تؤثر الدقة والمدة والإصدارات الأخرى في السعر، وتعرض الاستجابة التكلفة الدقيقة. إذا فشل التوليد يُعاد المبلغ، أما إذا حجبته سياسة المحتوى في Mage فلا يُعاد.

ما نقطة نهاية Stable Diffusion XL API؟

أرسل طلب POST إلى https://api.mage.space/v1/stable_diffusion_xl/generate مع ترويسة Authorization: Bearer تحمل مفتاح Mage API الخاص بك. تتضمن الاستجابة 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 واحد، وكل النماذج. ادفع فقط مقابل ما تنشئه.

احصل على مفتاح APIجرّب Stable Diffusion XL في مساحة التجربة

ذات صلة