رفتن به محتوا

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

API تصویر MiniMax H3

تصاویر بومی 16 مگاپیکسلی، با وزن‌های باز

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

در یک نگاه

API تصویر MiniMax H3 مدل MiniMax H3 Image را از طریق Mage روی POST https://api.mage.space/v1/minimax_h3_image/generate اجرا می‌کند. هر درخواست با تنظیمات پیش‌فرض ۱۵ Gems (حدود ۰٫۰۱۵ دلار) هزینه دارد، بدون اشتراک. MiniMax H3 Image کاراکترهای ذخیره‌شده و رفرنس‌ها را با @handle در پرامپت می‌پذیرد.

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

نگاه کلی

API تصویر MiniMax H3 چه کاری انجام می‌دهد

یک مدل تصویر با وزن‌های باز که تا 4K (حدود 16 مگاپیکسل) را با جزئیات غنی و پیروی دقیق از دستور رندر می‌کند. تا 16 تصویر رفرنس را ویرایش یا ترکیب کنید، همراه با LoRA.

یک مدل تصویر با وزن‌های باز برای متن به تصویر و ویرایش از روی حداکثر 16 تصویر رفرنس، در 2K (حدود 4 مگاپیکسل) یا 4K بومی (حدود 16 مگاپیکسل)، همراه با LoRA. این مدل به شش گام تقطیر شده و پرامپت منفی، تعداد گام یا مقیاس راهنمایی نمی‌گیرد. کل تصویر را به انگلیسی توصیف کنید؛ برای ویرایش بنویسید از هر تصویر چه چیزی بماند، چه چیزی تغییر کند و سپس نتیجه را شرح دهید.

image و additional_images را به‌عنوان ورودی می‌پذیرد.

شروع سریع

فراخوانی API تصویر MiniMax H3

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

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

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

mage = Mage()  # reads MAGE_API_KEY

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

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

مدل‌ها

مقادیر model_id برای MiniMax H3 Image

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

model_idنامپیش‌فرض
minimax-h3-imageMiniMax H3 Imageبله

گزینه‌ها

پارامترهای MiniMax H3 Image

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

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

ورودی‌ها

ورودی‌های رسانه‌ای که MiniMax H3 Image می‌پذیرد

هرکدام را به‌صورت URL با https، data URL یا آپلود تا 100 MB بفرستید.

فیلدنقش
imageتصویر مرجع.
additional_imagesتصاویر مرجع اضافی.

قوانین

محدودیت‌هایی که API تصویر MiniMax H3 اعمال می‌کند

  • تا 16 تصویر رفرنس را در image و additional_images بفرستید، به‌علاوهٔ شخصیت‌ها و رفرنس‌های اشاره‌شده؛ پرامپت آن‌ها را به همین ترتیب «تصویر 1»، «تصویر 2» و ... می‌نامد.

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

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

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

    MOSS-Image API

    پرامپت‌های بلند و متن دوزبانه، وزن‌های باز

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

    Nano Banana 2 API

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

  • تصویر · از 15 Gems

    API مدل SDXL Plus

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

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

    API Seedream

    Seedream، با فیلتر سخت‌گیرانه

  • تصویر · از 10 Gems

    Stable Diffusion v1.5 API

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

  • تصویر · از 10 Gems

    Stable Diffusion v3.5 Large API

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

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

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

هزینه API تصویر MiniMax H3 چقدر است؟
یک درخواست MiniMax H3 Image با تنظیمات پیش‌فرض (MiniMax H3 Image) ۱۵ Gems هزینه دارد، یعنی حدود ۰٫۰۱۵ دلار. رزولوشن، مدت‌زمان و نسخه‌های دیگر قیمت را تغییر می‌دهند؛ هزینه دقیق در پاسخ اعلام می‌شود. اگر تولید ناموفق باشد، هزینه برگردانده می‌شود؛ اگر سیاست محتوایی Mage جلوی آن را بگیرد، برگردانده نمی‌شود.
اندپوینت API تصویر MiniMax H3 چیست؟
POST به https://api.mage.space/v1/minimax_h3_image/generate با هدر Authorization: Bearer که کلید API شما در Mage را دارد. پاسخ شامل یک status_url است که برای گرفتن نتیجه آن را پیگیری می‌کنید.
کدام مدل‌های MiniMax H3 Image را می‌توانم فراخوانی کنم؟
minimax-h3-image (MiniMax H3 Image). مدل پیش‌فرض MiniMax H3 Image است.
آیا MiniMax H3 Image از تصاویر رفرنس یا کاراکترها پشتیبانی می‌کند؟
MiniMax H3 Image مقادیر image و additional_images را می‌پذیرد. MiniMax H3 Image کاراکترهای ذخیره‌شده و رفرنس‌ها را با @handle در پرامپت می‌پذیرد.
آیا می‌توانم از MiniMax H3 Image در Claude یا ChatGPT استفاده کنم؟
بله. سرور MCP مربوط به Mage را به Claude، ChatGPT، Claude Code، Grok یا Cursor وصل کن و MiniMax H3 Image را با نام بخواه. دستیارت گزینه‌های آن را با get_model می‌خواند و پیش از تولید، قیمت را اعلام می‌کند.
نتایج MiniMax H3 Image تا چه مدت نگه داشته می‌شوند؟
نتایج و ورودی‌ها 30 روز نگهداری می‌شوند. هر چیزی را که می‌خواهید نگه دارید، در فضای ذخیره‌سازی خودتان دانلود کنید.

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

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