API مج · مدل تصویر
API مدل Z-Image
سریعترین مدل تصویر در Mage
POST https://api.mage.space/v1/z_image/generateدر یک نگاه
API مدل Z-Image، مدل Z-Image را از طریق Mage در POST https://api.mage.space/v1/z_image/generate اجرا میکند. هزینه یک درخواست با تنظیمات پیشفرض ۱۰ Gems (حدود $0.01) است، بدون اشتراک. Z-Image اشاره با @handle را پشتیبانی نمیکند.
- تصویرخروجی
- 1نسخه
- 10Gems برای هر تصویر، پیشفرض
- $0.01حدود، به دلار
نگاه کلی
API مدل Z-Image چه کاری انجام میدهد
فوقالعاده سریع و کممصرف از نظر Gems. تبدیل متن به تصویر فوتورئال با آناتومی قابلاعتماد و متن خوانا، تا 2K؛ بدون تصویر مرجع.
سریعترین مدل تصویر در Mage: تبدیل متن به تصویر فوتورئال با آناتومی قابلاعتماد و متن خوانا، در 1K یا 2K.
فقط از روی پرامپت تصویر میسازد.
شروع سریع
فراخوانی API مدل Z-Image
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
ساختهشده مخصوص انیمه
API Chroma
وزنهای باز، ساختهشده بر پایه Flux
Flux 2 API
پرامپتهای بلند و ویرایش با چند رفرنس
GPT Image 2 API
پرامپتهای دقیق و متن خوانا
API Grok Image
Grok Imagine در سه سطح کیفیت
Guava API
واقعگراییای که شبیه عکس واقعی است
سؤالات متداول
سؤالات متداول
هزینه API مدل Z-Image چقدر است؟
اندپوینت API مدل Z-Image چیست؟
کدام مدلهای Z-Image را میتوانم فراخوانی کنم؟
آیا Z-Image از تصاویر مرجع یا کاراکترها پشتیبانی میکند؟
آیا میتوانم از Z-Image در Claude یا ChatGPT استفاده کنم؟
نتایج Z-Image تا چه مدت نگهداری میشوند؟
ساختن با Mage را شروع کن
یک حساب، یک موجودی Gems، همهٔ مدلها. فقط برای چیزی که تولید میکنی هزینه بپرداز.