Mage API · مدل ویدیو
Plum API
صدا روی تکتک کلیپها، تا 2K
POST https://api.mage.space/v1/plum/generateدر یک نگاه
API مدل Plum، یعنی Plum Max و یک نسخه دیگر را از طریق Mage در POST https://api.mage.space/v1/plum/generate اجرا میکند. هر درخواست با تنظیمات پیشفرض 338 Gem (حدود 0.338 دلار) هزینه دارد و نیازی به اشتراک نیست. Plum میتواند کاراکترهای ذخیرهشده، رفرنسها و رفرنسهای صوتی را با @handle در پرامپت بگیرد.
- ویدیوخروجی
- 2نسخهها
- 338Gems برای هر کلیپ، پیشفرض
- $0.338حدود، به دلار
نگاه کلی
API مدل Plum چه کاری انجام میدهد
ویدیوی کاملترین نسخه با صدا در هر کلیپ و خروجی تا 2K. فریم شروع و پایان، تا 9 رفرنس یا Characters، و Voices؛ از 4 تا 15 ثانیه.
مدل ویدیوی کامل Mage با صدای تولیدشده در هر کلیپ و خروجی تا 2K، در دو نسخه Plum و Plum Max که سریعتر است.
ورودیهای first_image، last_image، image، additional_images و videos را میپذیرد.
شروع سریع
فراخوانی API مدل Plum
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-max"
}' | 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-max',
});
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-max",
})
print(request["result"]["url"])مدلها
مقادیر model_id برای Plum
برای انتخاب یک نسخه، model_id را بفرستید. درخواست بدون آن، نسخه پیشفرض را اجرا میکند.
| model_id | نام | پیشفرض |
|---|---|---|
| plum | Plum | |
| plum-max | Plum Max | بله |
گزینهها
پارامترهای 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 میپذیرد
هرکدام را بهصورت URL با https، data URL یا آپلود تا 100 MB بفرستید.
| فیلد | نقش |
|---|---|
| first_image | تصویر فریم اول. |
| last_image | تصویر فریم آخر. |
| image | تصویر مرجع. |
| additional_images | تصاویر مرجع اضافی. |
| videos | ویدیوهای مبدأ. |
قوانین
قوانینی که API مدل Plum اعمال میکند
- فریم اول و آخر را نمیشود همراه تصاویر مرجع ارسال کرد: فقط یکی از این دو را بفرستید.
- در `plum-max` فریم آخر باید همراه با فریم اول باشد.
- ویرایش ویدیو دقیقاً یک ویدیوی مبدأ بین 2 تا 15 ثانیه، یک `duration` برای خروجی و حداکثر 2 تصویر رفرنس میخواهد که کاراکترها و رفرنسهای ذکرشده هم جزو آنها حساب میشوند. فریم، رفرنس صوتی یا صدای کاراکتر نمیپذیرد: برای اشاره به کاراکتری که صدا دارد، `use_character_voices: false` را بفرستید.
- در `plum-max` ویدیوی مبدأ به ازای هر ثانیه با نرخ بالاتری از خروجی محاسبه میشود؛ بنابراین در 768P یک ویرایش در `plum-max` گرانتر از `plum` تمام میشود.
مدلهای ویدیویی بیشتر
سایر APIهای ساخت ویدیو در Mage
Raspberry API
شخصیتهایی که از یک فریم اول زنده میشوند
Wan Video v2.2 API
ویدیوی وزنباز با نسخهٔ Lightning
Berry API
ویدیویی که به مرجعهای شما وفادار میماند
Blueberry API
تعیین فریم اول و آخر
Cherry API
خانوادهی پرچمدار ما برای ویدیو
Grok Video API
Grok Imagine در حرکت
سؤالات متداول
سؤالات متداول
هزینه API مدل Plum چقدر است؟
آدرس endpoint مدل Plum چیست؟
کدام مدلهای Plum را میتوانم فراخوانی کنم؟
آیا Plum از تصاویر رفرنس یا کاراکترها پشتیبانی میکند؟
آیا میتوانم Plum را از Claude یا ChatGPT استفاده کنم؟
نتایج Plum تا چه مدت نگهداری میشوند؟
ساختن با Mage را شروع کن
یک حساب، یک موجودی Gems، همهٔ مدلها. فقط برای چیزی که تولید میکنی هزینه بپرداز.