انتقل إلى المحتوى

Mage API · نموذج صور

Z-Image API

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

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

لمحة سريعة

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

  • صورةالمخرجات
  • 1النسخة
  • 10Gems لكل صورة، الافتراضي
  • $0.01التكلفة التقريبية بالدولار

نظرة عامة

ماذا تفعل Z-Image API

سرعة فائقة وتكلفة قليلة بالـ Gems. تحويل نص إلى صورة واقعي بتشريح متقن وكتابة نظيفة، حتى 2K؛ دون صور مرجعية.

أسرع نموذج صور على Mage: تحويل نص إلى صورة واقعي بتشريح متقن وكتابة واضحة، بدقة 1K أو 2K.

يُنشئ الصورة من الوصف النصي فقط.

بداية سريعة

استدعاء Z-Image API

عيّن MAGE_API_KEY، وأرسل الطلب إلى /z_image/generate، ثم استطلع status_url حتى يكتمل الطلب.

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

console.log(request.result.url);
Python
# pip install mage-space
from mage_space import Mage

mage = Mage()  # reads MAGE_API_KEY

request = mage.run("z_image", {
    "prompt": "Editorial portrait in soft daylight, 35mm film look",
    "aspect_ratio": "4:5",
    "model_id": "z-image-turbo",
})

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

النماذج

قيم model_id في Z-Image

أرسل model_id لاختيار إصدار. الطلب الذي لا يتضمنه يستخدم الإصدار الافتراضي.

model_idالاسمافتراضي
z-image-turboZ-Imageنعم

الخيارات

معاملات Z-Image

القيم المسموح بها في جميع الإصدارات؛ وقد يوفّر أحد الإصدارات عددًا أقل منها. تسرد الوثائق الخيارات لكل إصدار.

الحقلالقيم
aspect_ratio21:9, 16:9, 3:2, 5:4, 1:1, 4:5, 2:3, 9:16, 9:21
resolution1k, 2k

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

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

  • صورة · من 20 Gem

    Anima API

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

  • صورة · من 35 Gem

    Chroma API

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

  • صورة · من 40 Gems

    واجهة Flux 2 API

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

  • صورة · من 9 Gems

    واجهة GPT Image 2 API

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

  • صورة · من 90 Gems

    Grok Image API

    Grok Imagine بمستويين

  • صورة · من 37 Gems

    واجهة Guava API

    واقعية فائقة تبدو كصورة فوتوغرافية

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

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

كم تبلغ تكلفة Z-Image API؟
يكلّف طلب Z-Image بالإعدادات الافتراضية (Z-Image) ‏10 Gems، أي نحو 0.01$. تؤثر الدقة والمدة والإصدارات الأخرى في السعر، وتعرض الاستجابة التكلفة الدقيقة. إذا فشل التوليد يُعاد المبلغ، أما إذا حجبته سياسة المحتوى في Mage فلا يُعاد.
ما نقطة نهاية Z-Image API؟
أرسل طلب POST إلى https://api.mage.space/v1/z_image/generate مع ترويسة Authorization: Bearer تحمل مفتاح Mage API الخاص بك. تتضمن الاستجابة status_url لاستطلاع النتيجة.
ما نماذج Z-Image التي يمكنني استدعاؤها؟
z-image-turbo (Z-Image). النموذج الافتراضي هو Z-Image.
هل يدعم Z-Image الصور المرجعية أو الشخصيات؟
لا يقبل Z-Image مدخلات الصور أو الفيديو أو الصوت. ولا يقبل Z-Image إشارات @handle.
هل يمكنني استخدام Z-Image من Claude أو ChatGPT؟
نعم. اربط خادم Mage MCP بـ Claude أو ChatGPT أو Claude Code أو Grok أو Cursor واطلب Z-Image بالاسم. يقرأ مساعدك خياراته عبر get_model ويذكر السعر قبل التوليد.
ما مدة الاحتفاظ بنتائج Z-Image؟
يُحتفظ بالنتائج والمدخلات لمدة 30 يومًا. نزّل كل ما تريد الاحتفاظ به إلى مساحة التخزين الخاصة بك.

ابدأ البناء مع Mage

حساب واحد، ورصيد Gems واحد، وكل النماذج. ادفع فقط مقابل ما تنشئه.

Charactersالمجتمع