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 | الاسم | افتراضي |
|---|---|---|
| plum | Plum | |
| plum-max | Plum Max | |
| plum-fast | Plum Fast | نعم |
الخيارات
معاملات Plum
القيم المسموح بها في جميع الإصدارات؛ وقد يوفّر أحد الإصدارات عددًا أقل منها. تسرد الوثائق الخيارات لكل إصدار.
| الحقل | القيم |
|---|---|
| aspect_ratio | 16:9, 9:16, 1:1, 4:3, 3:4, 21:9 |
| resolution | 768P, 2K, 480P |
| duration | 4, 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
Raspberry API
شخصيات تنبض بالحياة من الإطار الأول
واجهة Seedance API
Seedance مع فلتر صارم
واجهة Wan 3.0 API
Wan 3.0 مع فلتر صارم
Wan Video v2.2 API
فيديو مفتوح الأوزان مع نسخة Lightning
Berry API
فيديو يبقى وفيًا لمراجعك
Blueberry API
ثبّت الإطار الأول والأخير
الأسئلة الشائعة
الأسئلة الشائعة
كم تبلغ تكلفة Plum API؟
ما نقطة نهاية Plum API؟
ما نماذج Plum التي يمكنني استدعاؤها؟
هل تدعم Plum الصور المرجعية أو الشخصيات؟
هل يمكنني استخدام Plum من Claude أو ChatGPT؟
إلى متى يتم الاحتفاظ بنتائج Plum؟
ابدأ البناء مع Mage
حساب واحد، ورصيد Gems واحد، وكل النماذج. ادفع فقط مقابل ما تنشئه.