رفتن به محتوا

API مج · مدل تصویر

HiDream API

سریع و همه‌کاره، با پرامپت منفی

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

در یک نگاه

HiDream API مدل HiDream را از طریق Mage در POST https://api.mage.space/v1/hidream/generate اجرا می‌کند. هر درخواست با تنظیمات پیش‌فرض 20 Gems (حدود 0.02 دلار) هزینه دارد، بدون اشتراک. HiDream منشن @handle را نمی‌پذیرد.

  • تصویرخروجی
  • 1نسخه
  • 20Gems برای هر تصویر، پیش‌فرض
  • $0.02حدود، به دلار

نگاه کلی

HiDream API چه کاری انجام می‌دهد

یک مدل سریع و عمومی متن‌به‌تصویر با پرامپت منفی. مناسب پرامپت‌های روزمره، چه فوتورئال و چه تصویرسازی‌شده.

یک مدل تصویر سریع و عمومی با پرامپت منفی، فوتورئال یا تصویرسازی‌شده.

فقط از روی پرامپت تصویر می‌سازد.

شروع سریع

فراخوانی HiDream API

MAGE_API_KEY را تنظیم کنید، درخواست را به /hidream/generate بفرستید و status_url را بررسی کنید تا درخواست کامل شود.

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

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

mage = Mage()  # reads MAGE_API_KEY

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

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

مدل‌ها

مقادیر model_id در HiDream

برای انتخاب یک نسخه، model_id را بفرستید. درخواست بدون آن، نسخه پیش‌فرض را اجرا می‌کند.

model_idنامپیش‌فرض
hidream-fastHiDreamبله

گزینه‌ها

پارامترهای HiDream

مقادیر مجاز برای همه نسخه‌ها؛ ممکن است یک نسخه گزینه‌های کمتری داشته باشد. گزینه‌های هر نسخه در مستندات آمده است.

فیلدمقادیر
aspect_ratio21:9, 16:9, 3:2, 5:4, 1:1, 4:5, 2:3, 9:16, 9:21

مدل‌های تصویر بیشتر

سایر API‌های تولید تصویر در Mage

  • تصویر · از 20 Gems

    Krea 2 API

    زیبایی خیره‌کننده در چند ثانیه

  • تصویر · از ۱۳۵ Gem

    Mango API

    خانواده‌ی پرچم‌دار ما برای تصویر

  • تصویر · از ۵۱ Gem

    Nano Banana 2 API

    متن شفاف و خوانا، تا 4K

  • تصویر · از 15 Gems

    API مدل SDXL Plus

    SDXL با چهره و دست‌های اصلاح‌شده

  • تصویر · از 10 Gems

    Stable Diffusion v1.5 API

    کلاسیک، با هزینهٔ کم

  • تصویر · از 10 Gems

    Stable Diffusion v3.5 Large API

    Stable Diffusion‌ای که بهتر از همه به حرف شما گوش می‌دهد

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

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

هزینهٔ HiDream API چقدر است؟
یک درخواست HiDream با تنظیمات پیش‌فرض (HiDream) 20 Gems هزینه دارد، حدود 0.02 دلار. رزولوشن، مدت و نسخه‌های دیگر قیمت را تغییر می‌دهند؛ هزینهٔ دقیق در پاسخ اعلام می‌شود. اگر تولید ناموفق باشد، هزینه برگردانده می‌شود؛ اما اگر سیاست محتوایی Mage آن را مسدود کند، برگردانده نمی‌شود.
endpoint در HiDream API چیست؟
POST https://api.mage.space/v1/hidream/generate را با هدر Authorization: Bearer که کلید API شما در Mage را دارد فراخوانی کنید. پاسخ شامل status_url است تا نتیجه را با آن بررسی کنید.
کدام مدل‌های HiDream را می‌توانم فراخوانی کنم؟
hidream-fast. پیش‌فرض HiDream است.
آیا HiDream از تصاویر مرجع یا شخصیت‌ها پشتیبانی می‌کند؟
HiDream ورودی تصویر، ویدیو یا صدا نمی‌پذیرد. HiDream منشن @handle را نمی‌پذیرد.
آیا می‌توانم از HiDream در Claude یا ChatGPT استفاده کنم؟
بله. سرور Mage MCP را به Claude، ChatGPT، Claude Code، Grok یا Cursor وصل کنید و HiDream را با نام بخواهید. دستیار شما گزینه‌های آن را با get_model می‌خواند و پیش از تولید، قیمت را اعلام می‌کند.
نتایج HiDream تا چه مدت نگهداری می‌شوند؟
نتایج و ورودی‌ها 30 روز نگهداری می‌شوند. هر چیزی را که می‌خواهید نگه دارید، در فضای ذخیره‌سازی خودتان دانلود کنید.

ساختن با Mage را شروع کن

یک حساب، یک موجودی Gems، همهٔ مدل‌ها. فقط برای چیزی که تولید می‌کنی هزینه بپرداز.