لمحة سريعة
تشغّل SDXL Plus API نموذج SDXL Plus عبر Mage على POST https://api.mage.space/v1/sdxl_plus/generate. يكلّف الطلب بالإعدادات الافتراضية 15 Gems (نحو $0.015) بدون اشتراك. لا يدعم SDXL Plus إشارات @handle.
صورة
المخرجات
1
النسخة
15
Gems لكل صورة، الافتراضي
$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 | الاسم | افتراضي |
|---|---|---|
| 6A35A7855770AE9820A3C931D4964C3817B6D9E3C6F9C4DABB5B3A94E5643B80 | SDXL Plus | نعم |
الخيارات
معلمات SDXL Plus
القيم المسموح بها في جميع الإصدارات؛ وقد يوفّر أحد الإصدارات عددًا أقل منها. تسرد الوثائق الخيارات لكل إصدار.
| الحقل | القيم |
|---|---|
| aspect_ratio | 21:9, 16:9, 3:2, 5:4, 1:1, 4:5, 2:3, 9:16, 9:21 |
المدخلات
مدخلات الوسائط التي يقبلها SDXL Plus
أرسل كل مدخل كرابط 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
واجهة Stable Diffusion XL API
نموذج SDXL مضبوط للواقعية الفوتوغرافية
صورة · من 10 Gems
واجهة Z-Image API
أسرع نموذج صور على Mage
صورة · من 20 Gem
Anima API
مصمم خصيصًا للأنمي
صورة · من 35 Gem
Chroma API
مفتوح الأوزان، مبني على 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 تحمل مفتاح Mage API الخاص بك. يتضمن الرد status_url لتتحقق منه بشكل متكرر حتى تظهر النتيجة.
ما نماذج SDXL Plus التي يمكنني استدعاؤها؟
6A35A7855770AE9820A3C931D4964C3817B6D9E3C6F9C4DABB5B3A94E5643B80. النموذج الافتراضي هو SDXL Plus.
هل يدعم SDXL Plus الصور المرجعية أو الشخصيات؟
يقبل SDXL Plus المعلمة image. ولا يدعم إشارات @handle.
هل يمكنني استخدام SDXL Plus من Claude أو ChatGPT؟
نعم. اربط خادم Mage MCP بـ Claude أو ChatGPT أو Claude Code أو Grok أو Cursor واطلب SDXL Plus بالاسم. يقرأ مساعدك خياراته عبر get_model ويذكر السعر قبل التوليد.
ما مدة الاحتفاظ بنتائج SDXL Plus؟
يُحتفظ بالنتائج والمدخلات لمدة 30 يومًا. نزّل كل ما تريد الاحتفاظ به إلى مساحة التخزين الخاصة بك.
ابدأ البناء مع Mage
حساب واحد، ورصيد Gems واحد، وكل النماذج. ادفع فقط مقابل ما تنشئه.