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-turbo | Z-Image | نعم |
الخيارات
معاملات Z-Image
القيم المسموح بها في جميع الإصدارات؛ وقد يوفّر أحد الإصدارات عددًا أقل منها. تسرد الوثائق الخيارات لكل إصدار.
| الحقل | القيم |
|---|---|
| aspect_ratio | 21:9, 16:9, 3:2, 5:4, 1:1, 4:5, 2:3, 9:16, 9:21 |
| resolution | 1k, 2k |
المزيد من نماذج الصور
واجهات API أخرى لإنشاء الصور على Mage
Anima API
مصمم خصيصًا للأنمي
Chroma API
مفتوح الأوزان، مبني على Flux
واجهة Flux 2 API
أوامر طويلة وتعديلات بمراجع متعددة
واجهة GPT Image 2 API
أوامر دقيقة ونصوص مقروءة
Grok Image API
Grok Imagine بمستويين
واجهة Guava API
واقعية فائقة تبدو كصورة فوتوغرافية
الأسئلة الشائعة
الأسئلة الشائعة
كم تبلغ تكلفة Z-Image API؟
ما نقطة نهاية Z-Image API؟
ما نماذج Z-Image التي يمكنني استدعاؤها؟
هل يدعم Z-Image الصور المرجعية أو الشخصيات؟
هل يمكنني استخدام Z-Image من Claude أو ChatGPT؟
ما مدة الاحتفاظ بنتائج Z-Image؟
ابدأ البناء مع Mage
حساب واحد، ورصيد Gems واحد، وكل النماذج. ادفع فقط مقابل ما تنشئه.