لمحة سريعة
تشغّل Melon API نموذج Melon ونسخة أخرى واحدة عبر Mage على POST https://api.mage.space/v1/melon/generate. يكلّف الطلب بالإعدادات الافتراضية 147 Gems (نحو 0.147 دولار) بلا اشتراك. يدعم Melon الشخصيات والمراجع المحفوظة عبر @handle في البرومبت.
فيديو
المخرجات
2
الإصدارات
147
Gems لكل مقطع، افتراضيًا
$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
أرسل كل مدخل كرابط https أو رابط بيانات (data URL) أو ملف مرفوع بحجم يصل إلى 100 MB.
| الحقل | الدور |
|---|---|
| first_image | صورة الإطار الأول. |
| last_image | صورة الإطار الأخير. |
| image | الصورة المرجعية. |
| additional_images | صور مرجعية إضافية. |
القواعد
ما الذي تفرضه Melon API
- لا يمكن الجمع بين الإطارين الأول والأخير وصور المراجع: أرسل نوعًا واحدًا فقط.
المزيد من نماذج الفيديو
واجهات برمجة أخرى لتوليد الفيديو على Mage
فيديو · ابتداءً من 30 Gems
MiniMax-H3 API
فيديو مفتوح سريع بصوت ستيريو
فيديو · من 338 Gems
واجهة Plum API
صوت مع كل مقطع، حتى 2K
فيديو · من 360 Gems
Raspberry API
شخصيات تنبض بالحياة من الإطار الأول
فيديو · من 40 Gems
Wan Video v2.2 API
فيديو مفتوح الأوزان مع نسخة Lightning
فيديو · من 189 Gems
Berry API
فيديو يبقى وفيًا لمراجعك
فيديو · من 360 Gems
Blueberry API
ثبّت الإطار الأول والأخير
الأسئلة الشائعة
الأسئلة الشائعة
كم تبلغ تكلفة Melon API؟
يكلّف طلب Melon بالإعدادات الافتراضية (Melon) 147 Gems، أي نحو $0.147. تؤثر الدقة والمدة والإصدارات الأخرى في السعر، ويعرض الرد الرسوم الدقيقة. يُسترد مبلغ التوليد الفاشل، أما التوليد الذي تحظره سياسة المحتوى في Mage فلا يُسترد.
ما نقطة نهاية Melon API؟
أرسل طلب POST إلى https://api.mage.space/v1/melon/generate مع ترويسة Authorization: Bearer تحمل مفتاح Mage API الخاص بك. يتضمن الرد status_url للاستعلام عن النتيجة.
أي نماذج Melon يمكنني استدعاؤها؟
melon (Melon)، melon-pro (Melon Pro). الافتراضي هو Melon.
هل يدعم Melon الصور المرجعية أو الشخصيات؟
يقبل Melon: first_image وlast_image وimage وadditional_images. ويستخدم الشخصيات والمراجع المحفوظة عبر @handle في الوصف.
هل يمكنني استخدام Melon من Claude أو ChatGPT؟
نعم. اربط خادم Mage MCP بـ Claude أو ChatGPT أو Claude Code أو Grok أو Cursor واطلب Melon بالاسم. يقرأ مساعدك خياراته عبر get_model ويذكر السعر قبل التوليد.
ما مدة الاحتفاظ بنتائج Melon؟
يُحتفظ بالنتائج والمدخلات لمدة 30 يومًا. نزّل كل ما تريد الاحتفاظ به إلى مساحة التخزين الخاصة بك.
ابدأ البناء مع Mage
حساب واحد، ورصيد Gems واحد، وكل النماذج. ادفع فقط مقابل ما تنشئه.