رفتن به محتوا

Mage API · مدل ویدیو

MiniMax-H3 API

ویدیوی سریع و متن‌باز با صدای استریو

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

در یک نگاه

MiniMax-H3 API مدل MiniMax-H3 Turbo و یک نسخه دیگر را از طریق Mage در POST https://api.mage.space/v1/minimax_h3/generate اجرا می‌کند. یک درخواست با تنظیمات پیش‌فرض 30 Gems (حدود 0.03 دلار) هزینه دارد و اشتراک لازم نیست. MiniMax-H3 کاراکترها، رفرنس‌ها و رفرنس‌های صوتی ذخیره‌شده را با @handle در پرامپت می‌پذیرد.

  • ویدیوخروجی
  • 2نسخه‌ها
  • 30Gems برای هر کلیپ، پیش‌فرض
  • $0.03حدود، به دلار

نگاه کلی

MiniMax-H3 API چه کاری انجام می‌دهد

یک مدل ویدیوی سریع و متن‌باز که تصویر و صدای استریو را با هم تولید می‌کند. فریم شروع و پایان یا حداکثر 8 تصویر مرجع (کلیپ‌های بلندتر تعداد کمتری می‌پذیرند)، از 5 تا 15 ثانیه با کیفیت تا 768p.

یک مدل ویدیوی سریع و متن‌باز که ویدیو و صدای استریو را با هم تولید می‌کند.

ورودی‌های first_image، last_image، image، additional_images و videos را می‌پذیرد.

شروع سریع

فراخوانی MiniMax-H3 API

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

cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/minimax_h3/generate' \
  --header "Authorization: Bearer $MAGE_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "prompt": "A slow push-in on a lighthouse at dusk, waves breaking below",
  "aspect_ratio": "16:9",
  "duration": "5",
  "model_id": "minimax-h3-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('minimax_h3', {
  prompt: 'A slow push-in on a lighthouse at dusk, waves breaking below',
  aspect_ratio: '16:9',
  duration: '5',
  model_id: 'minimax-h3-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("minimax_h3", {
    "prompt": "A slow push-in on a lighthouse at dusk, waves breaking below",
    "aspect_ratio": "16:9",
    "duration": "5",
    "model_id": "minimax-h3-turbo",
})

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

مدل‌ها

مقادیر model_id در MiniMax-H3

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

model_idنامپیش‌فرض
minimax-h3-turboMiniMax-H3 Turboبله
minimax-h3MiniMax-H3

گزینه‌ها

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

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

فیلدمقادیر
aspect_ratio21:9, 16:9, 3:2, 5:4, 1:1, 4:5, 2:3, 9:16, 9:21
resolution480p, 544p, 720p, 768p
duration5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15

ورودی‌ها

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

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

فیلدنقش
first_imageتصویر فریم اول.
last_imageتصویر فریم آخر.
imageتصویر مرجع.
additional_imagesتصاویر مرجع اضافی.
videosویدیوهای مبدأ.

قوانین

محدودیت‌های MiniMax-H3 API

  • فریم اول و آخر را نمی‌توان همراه با تصاویر یا ویدیوهای مرجع ارسال کرد: فقط یکی از این دو نوع را بفرستید.
  • حداکثر 9 تصویر مرجع و 3 ویدیوی مرجع که هرکدام بین 2 تا 15 ثانیه باشند.
  • رفرنس‌ها همراه کلیپ در یک بودجه 21 ثانیه‌ای سهیم‌اند: مجموع `duration` به‌علاوه 2 ثانیه برای هر تصویر مرجع، هر کاراکتر ذکرشده و هر رفرنس ذکرشده، به‌علاوه 1.15 ثانیه برای هر ثانیه از هر ویدیوی مرجع (حداکثر تا `duration`)، باید حداکثر 21 شود.

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

سایر APIهای ساخت ویدیو در Mage

  • ویدیو · از ۳۳۸ Gem

    Plum API

    صدا برای هر کلیپ، تا 2K

  • ویدیو · از 360 Gems

    Raspberry API

    شخصیت‌هایی که از یک فریم اول زنده می‌شوند

  • ویدیو · از ۴۰ Gem

    Wan Video v2.2 API

    ویدیوی وزن‌باز با نسخهٔ Lightning

  • ویدیو · از ۱۸۹ Gem

    Berry API

    ویدیویی که به مرجع‌های شما وفادار می‌ماند

  • ویدیو · از 360 Gems

    Blueberry API

    تعیین فریم اول و آخر

  • ویدیو · از ۶۱۸ Gem

    Cherry API

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

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

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

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

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

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