رفتن به محتوا
محیط آزمایشمستنداتدریافت کلید API

Mage API · مدل ویدیو

Magejutsu API

بازسازی هر ویدیو با حفظ حرکت آن

دریافت کلید APIMagejutsu را در پلی‌گراند امتحان کنید
POST https://api.mage.space/v1/magejutsu/generate

در یک نگاه

API Magejutsu مدل Magejutsu و ۲ نسخهٔ دیگر را از طریق Mage در POST https://api.mage.space/v1/magejutsu/generate اجرا می‌کند. یک درخواست با تنظیمات پیش‌فرض ۱٬۸۵۶ Gems (حدود ۱٫۸۵۶ دلار) هزینه دارد، بدون اشتراک. Magejutsu شخصیت‌های ذخیره‌شده و رفرنس‌ها را با @handle در پرامپت می‌پذیرد.

  • ویدیوخروجی
  • 3نسخه‌ها
  • 1,856Gems برای هر کلیپ، پیش‌فرض
  • $1.856حدود، به دلار

نگاه کلی

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

ویدیویی را که از قبل دارید بازسازی می‌کند: کلیپ و عکس‌های فرد یا چیزی را که جایگزین می‌شود بفرستید، و حرکت، دوربین، زمان‌بندی و صدا همان‌طور که فیلم‌برداری شده‌اند باقی می‌مانند. ویدیوی مبدا بین 4 تا 30 ثانیه است.

یک ویدیوی موجود را بازسازی می‌کند: یک کارگردان پرامپت ویرایش را از روی ویدیوی مبدا می‌نویسد و یک مرحله ویرایش ویدیو، فرد و چیزهای حاضر در صحنه را از نو می‌سازد. ویدیوی مبدا و رفرنس‌های جایگزین را بفرستید؛ خروجی طول، نسبت تصویر، حرکت و صدای ویدیوی مبدا را حفظ می‌کند.

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

شروع سریع

فراخوانی Magejutsu API

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

cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/magejutsu/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",
  "videos": [
    "https://example.com/input.jpg"
  ],
  "image": "https://example.com/input.jpg",
  "model_id": "magejutsu"
}' | 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('magejutsu', {
  prompt: 'A slow push-in on a lighthouse at dusk, waves breaking below',
  videos: [
    'https://example.com/input.jpg',
  ],
  image: 'https://example.com/input.jpg',
  model_id: 'magejutsu',
});

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

mage = Mage()  # reads MAGE_API_KEY

request = mage.run("magejutsu", {
    "prompt": "A slow push-in on a lighthouse at dusk, waves breaking below",
    "videos": [
        "https://example.com/input.jpg",
    ],
    "image": "https://example.com/input.jpg",
    "model_id": "magejutsu",
})

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

مدل‌ها

مقادیر model_id در Magejutsu

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

model_idنامپیش‌فرض
magejutsuMagejutsuبله
magejutsu-liteMagejutsu Lite
magejutsu-featherMagejutsu Feather

گزینه‌ها

پارامترهای Magejutsu

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

فیلدمقادیر
resolution480p, 720p, 1080p
modemotion_transfer, object_swap

ورودی‌ها

ورودی‌های رسانه‌ای که Magejutsu می‌پذیرد

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

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

قوانین

محدودیت‌هایی که Magejutsu API اعمال می‌کند

  • ویدیوی مبدأ در magejutsu بین ۴ تا ۳۰ ثانیه و در magejutsu-lite که نسخهٔ سریع‌تر و ارزان‌تر است، بین ۴ تا ۱۵ ثانیه می‌تواند باشد. این بازه برای magejutsu-feather هم که ارزان‌ترین و سریع‌ترین مدل است صدق می‌کند؛ این مدل فقط motion_transfer را اجرا می‌کند و خروجی را با کیفیت 480p و 720p می‌سازد. خروجی از طول و نسبت ابعاد ویدیوی مبدأ پیروی می‌کند.
  • هر درخواست در بک‌اند با همان کارگردان اجرا می‌شود. motion_transfer را انتخاب کن تا بازیگرها بازسازی شوند و حرکت حفظ شود، یا object_swap را انتخاب کن تا عناصر انتخاب‌شده تغییر کنند و بقیه‌ی نما همان‌طور که فیلم‌برداری شده بماند. حالت انتخابی مشخص می‌کند منبع چطور آماده شود: در motion_transfer، ویرایش با حرکت و چهره‌ی هر بازیگرِ جایگزین‌شده هدایت می‌شود و در object_swap، منبع همان‌طور که فیلم‌برداری شده ویرایش می‌شود. اگر کلیپی را راهنما نتواند بخواند، مثلاً کلیپی که هیچ فردی در آن نیست، از روی منبع اصلی و همان‌طور که فیلم‌برداری شده رندر می‌شود. هیچ مرحله‌ی تأیید دستی یا رندر پیش‌نویس وجود ندارد.
  • در مجموع تا ۳۰ تصویر مرجع را در image و additional_images ارسال کنید. کارگردان همهٔ آن‌ها را بررسی می‌کند و ویرایش فقط تصاویری را دریافت می‌کند که پرامپت از آن‌ها استفاده کرده است: تا ۲۷ تصویر در magejutsu، ۹ تصویر در magejutsu-lite و ۸ تصویر در magejutsu-feather.
  • پرامپت اختیاری است: بدون آن، کارگردان مرجع‌ها را بر اساس برجستگی و تناسب با منبع تطبیق می‌دهد.
  • صدای اصلی به‌طور پیش‌فرض بازیابی می‌شود. برای حفظ صدای تولیدشده، keep_original_audio را روی false بگذار.
  • تصاویر نقش جایگزین را دارند؛ هر کدام را در پرامپت با جایگاهش معرفی کنید («تصویر 1 فرد سمت چپ است»).
  • در هر درخواست فقط ویدیوی مبدا پذیرفته می‌شود؛ کلیپ طولانی‌تر برش داده نمی‌شود و رد می‌شود.

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

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

  • ویدیو · از 147 Gems

    Melon API

    انیمه در حرکت، با صدای اختیاری

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

    MiniMax-H3 API

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

  • ویدیو · از ۱۷۳ Gem

    Plum API

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

  • ویدیو · از 360 Gems

    Raspberry API

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

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

    Wan Video v2.2 API

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

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

    Berry API

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

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

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

هزینه Magejutsu API چقدر است؟
یک درخواست Magejutsu با تنظیمات پیش‌فرض (Magejutsu) 1,856 Gems هزینه دارد، یعنی حدود 1.856$. وضوح، مدت و نسخه‌های دیگر قیمت را تغییر می‌دهند؛ پاسخ API مبلغ دقیق کسرشده را اعلام می‌کند. اگر تولید ناموفق باشد، هزینه برگردانده می‌شود؛ اما اگر سیاست محتوایی Mage جلوی آن را بگیرد، برگردانده نمی‌شود.
اندپوینت Magejutsu API چیست؟
POST https://api.mage.space/v1/magejutsu/generate همراه با هدر Authorization: Bearer که کلید API شما در Mage را دارد. پاسخ شامل یک status_url است که برای دریافت نتیجه باید آن را پیگیری کنید.
کدام مدل‌های Magejutsu را می‌توانم فراخوانی کنم؟
magejutsu (Magejutsu)، magejutsu-lite (Magejutsu Lite)، magejutsu-feather (Magejutsu Feather). مدل پیش‌فرض Magejutsu است.
آیا Magejutsu از تصاویر رفرنس یا شخصیت‌ها پشتیبانی می‌کند؟
Magejutsu این ورودی‌ها را می‌پذیرد: image، additional_images و videos. Magejutsu شخصیت‌های ذخیره‌شده و رفرنس‌ها را با @handle در پرامپت می‌پذیرد.
آیا می‌توانم Magejutsu را از Claude یا ChatGPT استفاده کنم؟
بله. سرور MCP مربوط به Mage را به Claude، ChatGPT، Claude Code، Grok یا Cursor وصل کنید و Magejutsu را با نام بخواهید. دستیار شما گزینه‌های آن را با get_model می‌خواند و پیش از تولید، قیمت را اعلام می‌کند.
نتایج Magejutsu تا چه مدت نگهداری می‌شوند؟
نتایج و ورودی‌ها 30 روز نگهداری می‌شوند. هر چیزی را که می‌خواهید نگه دارید، در فضای ذخیره‌سازی خودتان دانلود کنید.

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

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

دریافت کلید APIMagejutsu را در پلی‌گراند امتحان کنید