رفتن به محتوا

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-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 Gems

    Anima API

    ساخته‌شده مخصوص انیمه

  • تصویر · از 35 Gems

    API Chroma

    وزن‌های باز، ساخته‌شده بر پایه Flux

  • تصویر · از ۴۰ Gem

    Flux 2 API

    پرامپت‌های بلند و ویرایش با چند رفرنس

  • تصویر · از ۹ Gem

    GPT Image 2 API

    پرامپت‌های دقیق و متن خوانا

  • تصویر · از 75 Gems

    API Grok Image

    Grok Imagine در سه سطح کیفیت

  • تصویر · از ۳۷ Gem

    Guava API

    واقع‌گرایی‌ای که شبیه عکس واقعی است

سؤالات متداول

سؤالات متداول

هزینه API مدل Z-Image چقدر است؟
یک درخواست Z-Image با تنظیمات پیش‌فرض (Z-Image) ۱۰ Gems هزینه دارد، حدود $0.01. رزولوشن، مدت‌زمان و نسخه‌های دیگر قیمت را تغییر می‌دهند؛ هزینه دقیق در پاسخ اعلام می‌شود. اگر تولید ناموفق باشد، هزینه آن برگردانده می‌شود؛ اما اگر سیاست محتوایی Mage جلوی آن را بگیرد، برگردانده نمی‌شود.
اندپوینت API مدل Z-Image چیست؟
POST https://api.mage.space/v1/z_image/generate همراه با هدر Authorization: Bearer که کلید API شما در Mage را دارد. پاسخ شامل یک 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، همهٔ مدل‌ها. فقط برای چیزی که تولید می‌کنی هزینه بپرداز.