Plum API

لمحة سريعة

تشغّل Plum API نموذج Plum Max وإصدارًا آخر عبر Mage على POST https://api.mage.space/v1/plum/generate. يكلّف الطلب بالإعدادات الافتراضية 338 Gems (نحو $0.338) دون اشتراك. يستخدم Plum الشخصيات والمراجع والمراجع الصوتية المحفوظة عبر @handle في الوصف.

• فيديو

  المخرجات

• 2

  الإصدارات

• 338

  Gems لكل مقطع، افتراضيًا

• $0.338

  التكلفة التقريبية بالدولار

نظرة عامة

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

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

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

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

بداية سريعة

استدعاء Plum API

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

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-max"
}' | jq -r '.status_url')

# Repeat until status is "completed"; result.url is the file
curl "$STATUS_URL" --header "Authorization: Bearer $MAGE_API_KEY"

// 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-max',
});

console.log(request.result.url);

# 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-max",
})

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

النماذج

قيم model_id في Plum

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

الخيارات

معاملات Plum

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

المدخلات

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

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

القواعد

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

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

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

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

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

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

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

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

ذات صلة

• واجهة API لتوليد الفيديو بالذكاء الاصطناعي
• مرجع Plum API
• ساحة تجربة Plum
• جميع نماذج API
• خادم Mage MCP