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-turbo | MiniMax-H3 Turbo | بله |
| minimax-h3 | MiniMax-H3 |
گزینهها
پارامترهای MiniMax-H3
مقادیر مجاز برای همه نسخهها؛ ممکن است یک نسخه گزینههای کمتری داشته باشد. گزینههای هر نسخه در مستندات آمده است.
| فیلد | مقادیر |
|---|---|
| aspect_ratio | 21:9, 16:9, 3:2, 5:4, 1:1, 4:5, 2:3, 9:16, 9:21 |
| resolution | 480p, 544p, 720p, 768p |
| duration | 5, 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
Plum API
صدا برای هر کلیپ، تا 2K
Raspberry API
شخصیتهایی که از یک فریم اول زنده میشوند
Wan Video v2.2 API
ویدیوی وزنباز با نسخهٔ Lightning
Berry API
ویدیویی که به مرجعهای شما وفادار میماند
Blueberry API
تعیین فریم اول و آخر
Cherry API
خانوادهی پرچمدار ما برای ویدیو
سؤالات متداول
سؤالات متداول
هزینه MiniMax-H3 API چقدر است؟
آدرس endpoint در MiniMax-H3 API چیست؟
کدام مدلهای MiniMax-H3 را میتوانم فراخوانی کنم؟
آیا MiniMax-H3 از تصاویر مرجع یا کاراکترها پشتیبانی میکند؟
آیا میتوانم MiniMax-H3 را از Claude یا ChatGPT استفاده کنم؟
نتیجههای MiniMax-H3 تا چه مدت نگهداری میشوند؟
ساختن با Mage را شروع کن
یک حساب، یک موجودی Gems، همهٔ مدلها. فقط برای چیزی که تولید میکنی هزینه بپرداز.