انتقل إلى المحتوى
ساحة التجربةالتوثيقاحصل على مفتاح API

Mage API · نموذج فيديو

Magejutsu API

أعِد تمثيل أي فيديو مع الحفاظ على حركته

احصل على مفتاح APIجرّب Magejutsu في ساحة التجربة
POST https://api.mage.space/v1/magejutsu/generate

لمحة سريعة

تشغّل واجهة Magejutsu API نموذج Magejutsu ونموذجين آخرين عبر Mage على POST https://api.mage.space/v1/magejutsu/generate. يكلّف الطلب بالإعدادات الافتراضية 1,856 Gems (حوالي 1.856$) دون أي اشتراك. يدعم 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

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

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

القواعد

القيود التي تطبّقها Magejutsu API

  • تتراوح مدة الفيديو المصدر بين 4 و30 ثانية في magejutsu، وبين 4 و15 ثانية في magejutsu-lite، وهو الإصدار الأسرع والأقل تكلفة، وكذلك في magejutsu-feather، وهو الأرخص والأسرع، ويدعم motion_transfer فقط ويعرض بدقة 480p و720p. يتبع الناتج مدة المصدر ونسبة أبعاده.
  • يعمل كل طلب بواسطة «المخرج» نفسه في الخلفية. اختر motion_transfer لإعادة بناء المؤدين مع الحفاظ على الحركة، أو object_swap لتغيير عناصر محددة مع إبقاء بقية اللقطة كما صُوّرت. يحدد الوضع أيضًا طريقة تجهيز المصدر: ففي نقل الحركة يوجَّه التعديل بحركة ووجه كل مؤدٍّ يجري استبداله، أما في استبدال العناصر فيُعدَّل المصدر كما صُوّر. وإذا تعذّرت قراءة المقطع بواسطة التوجيه، كأن لا يظهر فيه أي شخص، فيُعرض انطلاقًا من المصدر كما صُوّر. لا توجد خطوات موافقة يدوية ولا عمليات عرض مسودة.
  • أرسل حتى 30 صورة مرجعية عبر image وadditional_images. يقرأ المخرج كل الصور، ويتلقى التعديل الصور التي يستخدمها الوصف فقط: حتى 27 في magejutsu، و9 في magejutsu-lite، و8 في magejutsu-feather.
  • الوصف النصي اختياري: وبدونه، يربط المخرج الصور المرجعية بالمصدر بحسب مدى بروزها وملاءمتها.
  • تتم استعادة الصوت الأصلي افتراضيًا. اضبط keep_original_audio على false للاحتفاظ بالصوت الذي تم إنشاؤه.
  • الصور هي البديل؛ أشر إلى كل صورة في الوصف النصي بحسب موضعها ("الصورة 1 هي الشخص على اليسار").
  • فيديو المصدر هو الفيديو الوحيد المقبول في الطلب الواحد؛ يُرفض المقطع الأطول بدل أن يُقصّ.

المزيد من نماذج الفيديو

واجهات برمجة أخرى لتوليد الفيديو على Mage

  • فيديو · من 147 Gems

    Melon API

    أنمي متحرك، مع صوت اختياري

  • فيديو · ابتداءً من 30 Gems

    MiniMax-H3 API

    فيديو مفتوح سريع بصوت ستيريو

  • فيديو · من 173 Gems

    واجهة Plum API

    صوت مع كل مقطع، حتى 2K

  • فيديو · من 360 Gems

    Raspberry API

    شخصيات تنبض بالحياة من الإطار الأول

  • فيديو · من 40 Gems

    Wan Video v2.2 API

    فيديو مفتوح الأوزان مع نسخة Lightning

  • فيديو · من 189 Gems

    Berry API

    فيديو يبقى وفيًا لمراجعك

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

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

كم تكلّف Magejutsu API؟
يكلّف طلب Magejutsu بالإعدادات الافتراضية (Magejutsu) مبلغ 1,856 Gem، أي نحو 1.856$. تؤثر الدقة والمدة والإصدارات الأخرى في السعر، وتعرض الاستجابة المبلغ المحتسب بدقة. يُسترد مبلغ أي عملية توليد تفشل، أما العملية التي تحظرها سياسة المحتوى في Mage فلا يُسترد مبلغها.
ما نقطة نهاية Magejutsu API؟
POST https://api.mage.space/v1/magejutsu/generate مع ترويسة Authorization: Bearer تحمل مفتاح Mage API الخاص بك. تتضمن الاستجابة status_url للاستعلام عن النتيجة.
ما نماذج Magejutsu التي يمكنني استدعاؤها؟
magejutsu (Magejutsu)، وmagejutsu-lite (Magejutsu Lite)، وmagejutsu-feather (Magejutsu Feather). النموذج الافتراضي هو Magejutsu.
هل يدعم Magejutsu الصور المرجعية أو الشخصيات؟
يقبل Magejutsu الحقول image وadditional_images وvideos. ويقبل الشخصيات المحفوظة والمراجع عبر @handle في الوصف النصي.
هل يمكن استخدام Magejutsu من Claude أو ChatGPT؟
نعم. اربط خادم Mage MCP بـ Claude أو ChatGPT أو Claude Code أو Grok أو Cursor واطلب Magejutsu بالاسم. يقرأ مساعدك خياراته عبر get_model ويذكر السعر قبل التوليد.
كم تُحفظ نتائج Magejutsu؟
يُحتفظ بالنتائج والمدخلات لمدة 30 يومًا. نزّل كل ما تريد الاحتفاظ به إلى مساحة التخزين الخاصة بك.

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

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

احصل على مفتاح APIجرّب Magejutsu في ساحة التجربة