Mage API · نموذج صور

SDXL Plus API

SDXL بوجوه وأيدٍ مصحّحة

احصل على مفتاح APIجرّب SDXL Plus في ساحة التجربة
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.

نظرة عامة

ما الذي تقدّمه 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

أرسل كل مدخل كرابط 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 واحد، وكل النماذج. ادفع فقط مقابل ما تنشئه.

احصل على مفتاح APIجرّب SDXL Plus في ساحة التجربة

ذات صلة