Z-Image API

لمحة سريعة

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

• صورة

  المخرجات

• 1

  النسخة

• 10

  Gems لكل صورة، الافتراضي

• $0.01

  التكلفة التقريبية بالدولار

نظرة عامة

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

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

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

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

بداية سريعة

استدعاء Z-Image API

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

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"

// 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);

# 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 لاختيار إصدار. الطلب الذي لا يتضمنه يستخدم الإصدار الافتراضي.

الخيارات

معاملات Z-Image

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

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

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

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

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

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

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

ذات صلة

• واجهة API لتوليد الصور بالذكاء الاصطناعي
• مرجع Z-Image API
• مساحة تجربة Z-Image
• جميع نماذج API
• خادم Mage MCP