انتقل إلى المحتوى

Mage API · نموذج صور

MiniMax H3 Image API

صور أصلية بدقة 16 ميغابكسل، بأوزان مفتوحة

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

لمحة سريعة

تشغّل MiniMax H3 Image API نموذج MiniMax H3 Image عبر Mage من خلال POST https://api.mage.space/v1/minimax_h3_image/generate. يكلّف الطلب بالإعدادات الافتراضية 15 Gems (نحو 0.015 دولار) بدون أي اشتراك. يدعم MiniMax H3 Image الشخصيات المحفوظة والمراجع عبر @handle داخل الوصف النصي.

  • صورةالمخرجات
  • 1النسخة
  • 15Gems لكل صورة، الافتراضي
  • $0.015التكلفة التقريبية بالدولار

نظرة عامة

ما الذي تقدمه MiniMax H3 Image API

نموذج صور بأوزان مفتوحة يولّد صورًا بدقة تصل إلى 4K (نحو 16 ميغابكسل) بتفاصيل غنية والتزام دقيق بالتعليمات. يمكنك تعديل أو دمج ما يصل إلى 16 صورة مرجعية، مع LoRAs.

نموذج صور بأوزان مفتوحة لتحويل النص إلى صورة والتعديل انطلاقًا من 16 صورة مرجعية كحدٍّ أقصى، بدقة 2K (نحو 4 ميغابكسل) أو 4K أصلية (نحو 16 ميغابكسل)، مع LoRAs. جرى تقطيره إلى ست خطوات، لذا لا يقبل وصفًا سلبيًا ولا عدد خطوات ولا مقياس توجيه. اكتب وصف الصورة كاملًا بالإنجليزية؛ وعند التعديل، اذكر ما يجب الإبقاء عليه من كل صورة وما سيتغيّر، ثم صِف النتيجة.

يقبل الحقلين image وadditional_images كمدخلات.

بداية سريعة

استدعاء MiniMax H3 Image API

عيّن 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

أرسل كل مدخل كرابط https أو رابط بيانات (data URL) أو ملف مرفوع بحجم يصل إلى 100 MB.

الحقلالدور
imageالصورة المرجعية.
additional_imagesصور مرجعية إضافية.

القواعد

القيود التي تفرضها MiniMax H3 Image API

  • أرسل حتى 16 صورة مرجعية موزعة بين image وadditional_images، إضافةً إلى الشخصيات والمراجع المذكورة؛ ويشير الوصف النصي إليها بالأسماء image 1 وimage 2 ... بهذا الترتيب.

المزيد من نماذج الصور

واجهات API أخرى لإنشاء الصور على Mage

الأسئلة الشائعة

الأسئلة الشائعة

كم تبلغ تكلفة MiniMax H3 Image API؟
يكلّف طلب MiniMax H3 Image بالإعدادات الافتراضية (MiniMax H3 Image) 15 Gems، أي نحو 0.015 دولار. تؤثر الدقة والمدة والإصدارات الأخرى في السعر، وتعرض الاستجابة الرسوم الدقيقة. يُعاد المبلغ عند فشل عملية التوليد، ولا يُعاد إذا حجبتها سياسة المحتوى في Mage.
ما هي نقطة النهاية الخاصة بـ MiniMax H3 Image API؟
أرسل طلب POST إلى https://api.mage.space/v1/minimax_h3_image/generate مع ترويسة Authorization: Bearer تحمل مفتاح Mage API الخاص بك. تتضمن الاستجابة status_url لمتابعة النتيجة.
أي نماذج MiniMax H3 Image يمكنني استدعاؤها؟
minimax-h3-image (MiniMax H3 Image). النموذج الافتراضي هو MiniMax H3 Image.
هل يدعم MiniMax H3 Image الصور المرجعية أو الشخصيات؟
يقبل MiniMax H3 Image الحقلين image وadditional_images. ويدعم الشخصيات المحفوظة والمراجع عبر @handle داخل الوصف النصي.
هل يمكنني استخدام MiniMax H3 Image من Claude أو ChatGPT؟
نعم. اربط خادم Mage MCP مع Claude أو ChatGPT أو Claude Code أو Grok أو Cursor واطلب MiniMax H3 Image بالاسم. يقرأ مساعدك خياراته عبر get_model ويذكر لك السعر قبل التوليد.
ما المدة التي تُحفظ فيها نتائج MiniMax H3 Image؟
يُحتفظ بالنتائج والمدخلات لمدة 30 يومًا. نزّل كل ما تريد الاحتفاظ به إلى مساحة التخزين الخاصة بك.

ابدأ البناء مع Mage

حساب واحد، ورصيد Gems واحد، وكل النماذج. ادفع فقط مقابل ما تنشئه.