لمحة سريعة
يشغّل 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.
صورة
المخرجات
1
النسخة
10
Gems لكل صورة، الافتراضي
$0.01
التكلفة التقريبية بالدولار
نظرة عامة
ما الذي يقدمه 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 | الاسم | افتراضي |
|---|---|---|
| 6A35A7855770AE9820A3C931D4964C3817B6D9E3C6F9C4DABB5B3A94E5643B80 | Stable Diffusion XL | نعم |
الخيارات
معاملات Stable Diffusion XL
القيم المسموح بها في جميع الإصدارات؛ وقد يوفّر أحد الإصدارات عددًا أقل منها. تسرد الوثائق الخيارات لكل إصدار.
| الحقل | القيم |
|---|---|
| aspect_ratio | 21: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 واحد، وكل النماذج. ادفع فقط مقابل ما تنشئه.