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

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

Plum API

صوت في كل مقطع، بدقة تصل إلى 2K

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

لمحة سريعة

تشغّل واجهة Plum API نموذج Plum Fast ومتغيرين آخرين عبر Mage من خلال POST https://api.mage.space/v1/plum/generate. يكلّف الطلب بالإعدادات الافتراضية 173 Gems (نحو 0.173 دولار) دون أي اشتراك. يقبل Plum الشخصيات المحفوظة والمراجع والمراجع الصوتية عبر @handle داخل الوصف النصي.

  • فيديوالمخرجات
  • 3الإصدارات
  • 173Gems لكل مقطع، افتراضيًا
  • $0.173التكلفة التقريبية بالدولار

نظرة عامة

ما الذي تتيحه Plum API

فيديو متكامل الميزات مع صوت في كل مقطع وجودة إخراج تصل إلى 2K. إطار بداية وإطار نهاية، وحتى 9 مراجع أو Characters، وVoices، بمدة من 4 إلى 15 ثانية.

نموذج الفيديو الكامل المزايا من Mage، مع صوت مولَّد في كل مقطع ومخرجات بدقة تصل إلى 2K، ويتوفر بثلاثة إصدارات: Plum، وPlum Max الأسرع، وPlum Fast الأسرع على الإطلاق والأقل تكلفة.

يقبل المدخلات first_image وlast_image وimage وadditional_images وvideos.

بداية سريعة

استدعاء Plum API

عيّن MAGE_API_KEY، ثم أرسل الطلب إلى /plum/generate، واستعلم عن status_url بشكل متكرر حتى يكتمل الطلب.

cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/plum/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": "plum-fast"
}' | 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('plum', {
  prompt: 'A slow push-in on a lighthouse at dusk, waves breaking below',
  aspect_ratio: '16:9',
  duration: '5',
  model_id: 'plum-fast',
});

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

mage = Mage()  # reads MAGE_API_KEY

request = mage.run("plum", {
    "prompt": "A slow push-in on a lighthouse at dusk, waves breaking below",
    "aspect_ratio": "16:9",
    "duration": "5",
    "model_id": "plum-fast",
})

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

النماذج

قيم model_id في Plum

أرسل model_id لاختيار إصدار. الطلب الذي لا يتضمنه يستخدم الإصدار الافتراضي.

model_idالاسمافتراضي
plumPlum
plum-maxPlum Max
plum-fastPlum Fastنعم

الخيارات

معاملات Plum

القيم المسموح بها في جميع الإصدارات؛ وقد يوفّر أحد الإصدارات عددًا أقل منها. تسرد الوثائق الخيارات لكل إصدار.

الحقلالقيم
aspect_ratio16:9, 9:16, 1:1, 4:3, 3:4, 21:9
resolution768P, 2K, 480P
duration4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15

المدخلات

مدخلات الوسائط التي تقبلها Plum

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

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

القواعد

القواعد التي تفرضها Plum API

  • لا يمكن الجمع بين الإطارين الأول والأخير وصور المراجع: أرسل نوعًا واحدًا فقط.
  • في `plum-max` و`plum-fast` يجب إقران الإطار الأخير بإطار أول.
  • يتطلب تعديل الفيديو فيديو مصدر واحدًا بالضبط مدته من 2 إلى 15 ثانية، مع `duration` للإخراج، وحتى صورتي مرجع، تُحتسب فيهما الشخصيات والمراجع المذكورة. ولا يقبل إطارات أو مراجع صوتية أو أصواتًا للشخصيات: أرسل `use_character_voices: false` لذكر شخصية لها صوت.
  • في `plum-max` يُحتسب سعر فيديو المصدر بمعدل أعلى في الثانية من سعر الإخراج، لذا يكلّف التعديل بدقة 768P على `plum-max` أكثر مما يكلّفه على `plum`.

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

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

  • فيديو · من 360 Gems

    Raspberry API

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

  • فيديو · من 618 Gems

    واجهة Seedance API

    Seedance مع فلتر صارم

  • فيديو · من 245 Gems

    واجهة Wan 3.0 API

    Wan 3.0 مع فلتر صارم

  • فيديو · من 40 Gems

    Wan Video v2.2 API

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

  • فيديو · من 189 Gems

    Berry API

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

  • فيديو · من 360 Gems

    Blueberry API

    ثبّت الإطار الأول والأخير

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

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

كم تبلغ تكلفة Plum API؟
يكلّف طلب Plum بالإعدادات الافتراضية (Plum Fast) ‏173 Gems، أي نحو 0.173 دولار. تؤثر الدقة والمدة والإصدار في السعر، وتعرض الاستجابة المبلغ الدقيق المحتسب. إذا فشل التوليد يُسترد المبلغ، أما إذا حجبته سياسة المحتوى في Mage فلا يُسترد.
ما نقطة نهاية Plum API؟
أرسل طلب POST إلى https://api.mage.space/v1/plum/generate مع ترويسة Authorization: Bearer تحمل مفتاح Mage API الخاص بك. تتضمن الاستجابة status_url للاستعلام عن النتيجة.
ما نماذج Plum التي يمكنني استدعاؤها؟
plum (Plum)، plum-max (Plum Max)، plum-fast (Plum Fast). الإصدار الافتراضي هو Plum Fast.
هل تدعم Plum الصور المرجعية أو الشخصيات؟
تقبل Plum الحقول first_image وlast_image وimage وadditional_images وvideos. وتستخدم الشخصيات والمراجع والمراجع الصوتية المحفوظة عبر @handle في الوصف.
هل يمكنني استخدام Plum من Claude أو ChatGPT؟
نعم. اربط خادم Mage MCP مع Claude أو ChatGPT أو Claude Code أو Grok أو Cursor واطلب Plum بالاسم. يقرأ مساعدك خياراته عبر get_model ويذكر السعر قبل أن يبدأ التوليد.
إلى متى يتم الاحتفاظ بنتائج Plum؟
يُحتفظ بالنتائج والمدخلات لمدة 30 يومًا. نزّل كل ما تريد الاحتفاظ به إلى مساحة التخزين الخاصة بك.

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

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

Charactersالمجتمع