Mage API · مدل ویدیو
Melon API
انیمه در حرکت، با صدای اختیاری
POST https://api.mage.space/v1/melon/generateدر یک نگاه
Melon API مدل Melon و ۱ نسخهٔ دیگر را از طریق Mage روی POST https://api.mage.space/v1/melon/generate اجرا میکند. هر درخواست با تنظیمات پیشفرض ۱۴۷ Gem (حدود ۰٫۱۴۷ دلار) هزینه دارد، بدون اشتراک. Melon کاراکترها و مرجعهای ذخیرهشده را با @handle در پرامپت میپذیرد.
- ویدیوخروجی
- 2نسخهها
- 147Gems برای هر کلیپ، پیشفرض
- $0.147حدود، به دلار
نگاه کلی
Melon API چه کاری انجام میدهد
مدل ویدیوی انیمهی ما، در دو نسخه Melon و Melon Pro. فریم شروع و پایان یا حداکثر 7 تصویر مرجع یا Characters، صدای اختیاری، از 3 تا 16 ثانیه با کیفیت تا 1080p.
مدل ویدیوی انیمهی Mage، در دو نسخه Melon و Melon Pro، با صدای اختیاری.
ورودیهای first_image، last_image، image و additional_images را میپذیرد.
شروع سریع
فراخوانی Melon API
مقدار MAGE_API_KEY را تنظیم کنید، درخواست را به /melon/generate بفرستید و status_url را تا تکمیل درخواست بررسی کنید.
cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/melon/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": "4",
"model_id": "melon"
}' | 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('melon', {
prompt: 'A slow push-in on a lighthouse at dusk, waves breaking below',
aspect_ratio: '16:9',
duration: '4',
model_id: 'melon',
});
console.log(request.result.url);Python
# pip install mage-space
from mage_space import Mage
mage = Mage() # reads MAGE_API_KEY
request = mage.run("melon", {
"prompt": "A slow push-in on a lighthouse at dusk, waves breaking below",
"aspect_ratio": "16:9",
"duration": "4",
"model_id": "melon",
})
print(request["result"]["url"])مدلها
مقادیر model_id در Melon
برای انتخاب یک نسخه، model_id را بفرستید. درخواست بدون آن، نسخه پیشفرض را اجرا میکند.
| model_id | نام | پیشفرض |
|---|---|---|
| melon | Melon | بله |
| melon-pro | Melon Pro |
گزینهها
پارامترهای Melon
مقادیر مجاز برای همه نسخهها؛ ممکن است یک نسخه گزینههای کمتری داشته باشد. گزینههای هر نسخه در مستندات آمده است.
| فیلد | مقادیر |
|---|---|
| aspect_ratio | 16:9, 9:16, 1:1, 3:4, 4:3 |
| resolution | 540p, 720p, 1080p |
| duration | 3, 4, 5, 6, 8, 10, 16 |
ورودیها
ورودیهای رسانهای که Melon میپذیرد
هرکدام را بهصورت URL با https، data URL یا آپلود تا 100 MB بفرستید.
| فیلد | نقش |
|---|---|
| first_image | تصویر فریم اول. |
| last_image | تصویر فریم آخر. |
| image | تصویر مرجع. |
| additional_images | تصاویر مرجع اضافی. |
قوانین
محدودیتهای Melon API
- فریم اول و آخر را نمیشود همراه تصاویر مرجع ارسال کرد: فقط یکی از این دو را بفرستید.
- پرامپت حداکثر 5000 نویسه میتواند باشد.
مدلهای ویدیویی بیشتر
سایر APIهای ساخت ویدیو در Mage
MiniMax-H3 API
ویدیوی متنباز سریع با صدای استریو
Plum API
صدا برای هر کلیپ، تا 2K
Raspberry API
شخصیتهایی که از یک فریم اول زنده میشوند
Wan Video v2.2 API
ویدیوی وزنباز با نسخهٔ Lightning
Berry API
ویدیویی که به مرجعهای شما وفادار میماند
Blueberry API
تعیین فریم اول و آخر
سؤالات متداول
سؤالات متداول
هزینه Melon API چقدر است؟
آدرس endpoint در Melon API چیست؟
کدام مدلهای Melon را میتوانم فراخوانی کنم؟
آیا Melon از تصاویر مرجع یا کاراکترها پشتیبانی میکند؟
آیا میتوانم Melon را از Claude یا ChatGPT استفاده کنم؟
نتیجههای Melon تا چه مدت نگهداری میشوند؟
ساختن با Mage را شروع کن
یک حساب، یک موجودی Gems، همهٔ مدلها. فقط برای چیزی که تولید میکنی هزینه بپرداز.